#Создание справочника
Справочники → Добавить.
#Шапка справочника
| Поле | Что задаёт |
|---|---|
| Название | как называется в панели: «Отзывы» |
| Имя таблицы | латиница, с буквы: reviews. По нему называется таблица в базе |
| Описание | пояснение для себя |
| Показывать в меню админки | будет ли пункт в меню |
| Раздел меню | в какую группу попадёт пункт |
| Порядок в меню | меньше — выше |
Имя таблицы задаётся один раз. Переименование сломало бы все модули,
где справочник уже используется, поэтому в режиме правки поле закрыто.
Выбирайте имя осмысленно и латиницей: reviews, а не otzyvy_new_2.
#Поля
Каждое поле — столбец таблицы. У поля пять настроек:
| Настройка | Что делает |
|---|---|
| Заголовок | подпись в форме записи: «Цена со скидкой» |
| Столбец | имя в базе и в метках: cena_skidka |
| Тип | чем поле является |
| Где показывать | три галочки, см. ниже |
| По умолчанию | значение для новой записи |
#Три галочки «Где показывать»
| Галочка | Что значит |
|---|---|
| список | поле будет колонкой в таблице записей |
| форма | поле будет видно в форме записи |
| обяз. | без него запись нельзя сохранить |
Снятая галочка «список» не прячет данные — только разгружает таблицу. Держите в списке 3–5 колонок: заголовок, состояние, дату. Иначе таблица не читается.
Поля перетаскиваются мышью — порядок в форме записи задаётся здесь.
#Кнопка «Добавить Open Graph»
Заводит разом набор полей для того, как страница выглядит при отправке в мессенджер и соцсеть: заголовок, описание, картинка, тип. Это часто нужно у страниц и статей и утомительно заводить вручную.
#Что происходит при сохранении
Создаётся настоящая таблица в базе — list_reviews для имени reviews.
Добавили поле позже — столбец добавится к существующей таблице, записи
не пострадают.
Удаление поля удаляет столбец вместе с данными. Отменить нечем. Если поле просто мешает — снимите галочки «список» и «форма», оно перестанет показываться, а данные останутся.
#Дублирование
У справочника есть кнопка Дублировать — копируется структура, а не записи. Удобно, когда нужен второй похожий: «Услуги» и «Услуги для бизнеса».
#Удаление справочника
Кнопка Удалить на странице правки. Спрашивает подтверждение и удаляет таблицу вместе со всеми записями.
Справочник, принадлежащий решению, лучше удалять не здесь, а снятием самого решения — тогда видно, что именно исчезнет и сколько записей.
#Что чаще всего идёт не так
«Завёл справочник, в меню его нет». Галочка «Показывать в меню админки» снята по умолчанию.
«Не даёт сохранить имя таблицы». Только латиница, цифры и подчёркивание, первая буква — не цифра. Русские имена не принимаются: имя идёт прямо в название таблицы базы.
«Добавил поле — на сайте его нет». Поле появилось в справочнике, но
в вёрстке модуля метки на него нет. Добавьте
{module.имя_модуля.имя_поля} в разметку записи.