Техническая документация

Бессовестно вольный перевод с комментариями, первоисточник drupal.org/project/entity_usage. Модуль Entity Usage был весьма ожидаем (автором), но впервые упомянут только в июле 2016 года, т.е. с запозданием примерно в 15 лет по отношению к «десктоповому варианту» соответствующей фунциональной возможности программы AuthorIT. Редакция от 19.03.2021.

В чем польза от бес ПОЛЕ зных сущностей Drupal? Трудно сказать. Но первое, что приходит в голову - это отсутствие необходимости манипуляций с запросами к базе данных Drupal, если речь идет о динамике. При загрузке значения поля «на лету» получается лишнее обращение к БД, в данном же случае такое обращение исключается. Это хорошо.

Можно по аналогии избавиться и от полей связанных сущностей. Можно вообще прикрутить HTML-код страницы не только Confluence, а даже Git или любого другого источника. Прогер пишет там себе что-то в Git, а его писанина синхронно обновляется в Drupal, что может быть очень удобно при глубоком детальном и дотошном документировании какого-нибудь программного обеспечения.

Автор при создании контента применяет AuthorIT, подготавливая при этом минимум два HTML-файла: один под анонс (teaser), а другой уже непосредственно под Body. Перед кодом файла анонса добавляется нолик, как в сов. секретных приказах Сталина. В частности, данную статью можно посмотреть в исходниках (форматах хранения):

• анонс - /sites/default/files/054836.htm;
• полная версия - /sites/default/files/54836.htm,

добавив перед ними доменное имя.

Как-то так...

Способы загрузки контента сущностей Drupal без применения полей могут быть реализованы с помощью шаблонов страниц. Для Drupal 7 основным шаблоном будет node.tpl.php, для Drupal 8 и 9 - node.html.twig. Данные шаблоны копируются из каталогов /modules/node и /core/modules/node соответственно в каталоги используемой темы оформления.

Затем оба эти файла переименовываются под тип материала. Тип материала лучше создать свой собственный, например topic. В этом случае шаблоны будут иметь наименования node--topic.tpl.php и node--topic.html.twig.

Далее немножко логики (вместо конкретного кода):

• создается переменная, которой присваивается значение идентификатора текущей ноды - nid или url (зависит от версии Drupal);
• из созданной переменной выгрызается «передняя» часть адреса, включая слеш. На выходе получается числовое значение, соответствующее идентификатору внедряемой страницы Confluence pageId;
• выполняется проверка существования страницы с идентификатором pageId в Confluence. Это явная перестраховка, но «береженого Бог бережет (решила монахиня, надевая презерватив на свечку)»;
• если таковая страница существует, то оператор include, имеющийся как в php, так и в twig, «всасывает» ее HTML-код из Confluence в ноду Drupal;
• рендерится код в какой-нибудь обертке типа div.

Вот и весь расклад.