#Что такое модули
Модуль — это то, что выводит данные на сайт. Справочник хранит, модуль показывает, вид решает, как именно.
У модуля есть:
- имя — им его зовут:
{module.portfolio}; - тип — страница или блок;
- источник данных — справочник (или ничего);
- виды — вёрстка, одна или несколько.
#Два типа: PFM и BFM
Это главное различие в Wacis.
| PFM — страница | BFM — блок | |
|---|---|---|
| Что делает | владеет адресом, отдаёт документ целиком | возвращает кусок вёрстки |
| Где живёт | по своему адресу: /uslugi/ | внутри чужой страницы |
| Кто зовёт | посетитель, открывший адрес | метка {module.имя} в разметке |
| Сколько видов работает | один — основной | тот, что указан в вызове |
PFM — страницы, статьи блога, карточки товара. Открыли адрес — ядро нашло запись и нарисовало документ.
BFM — шапка, подвал, меню, форма, сетка работ, отзывы. Сам по себе никуда не выводится: его вставляют.
У BFM нет основного вида намеренно: один и тот же блок на соседних
страницах может выглядеть по-разному, и это обычный случай, а не
исключение. Поэтому вид задаётся на месте вызова:
{module.menu:view=premiere.menu}.
#Три рода блоков
Не у каждого BFM есть справочник, и это не ошибка.
| Род | Есть справочник | Пример |
|---|---|---|
| списочный | да | портфолио, отзывы, статьи |
| статический | нет | шапка, подвал, свободный блок |
| вычисляемый | нет, строки считаются на месте | хлебные крошки |
Статический блок — это вёрстка без перебора: вся суть в обёртке. Вычисляемый перебирает строки, которых нет в таблице: у хлебных крошек звенья зависят от текущего адреса.
Вычисляемые блоки заводятся в отдельном списке, а не проверкой имени в ядре. Иначе движок пришлось бы научить, что такое «крошки», а следом — что такое «корзина», «заказ» и всё остальное.
#Страницы раздела
- Свой модуль — как завести и настроить.
- Шапка и подвал — особые модули оформления.
- Иерархия модулей — родительские и дочерние.
#Где смотреть список модулей
Модули в нижней части меню панели. Там видно имя каждого модуля, его тип и число видов — и оттуда же правится вёрстка.
#Модуль и справочник — не одно и то же
У решений они обычно называются одинаково: модуль portfolio читает
справочник portfolio. Но это совпадение, а не правило.
В метках вёрстки первая часть — имя модуля, а не справочника:
{module.имя_модуля.имя_поля}У своего модуля они могут различаться. Смотрите имя модуля в разделе «Модули», а не имя таблицы в «Справочниках».