Files
ave-cms/help/content/content-model-tools.md
2026-07-30 11:56:32 +03:00

4.4 KiB

Инструменты модели контента

К разделу «Как AVE.cms собирает сайт»

Эти инструменты помогают собирать структуру сайта без копирования одинаковых полей и ручного PHP.

Справочники

Справочник — обычная рубрика специального назначения. Её документы являются значениями списка: брендами, городами, авторами, типами оборудования и другими повторно используемыми сущностями.

  1. Откройте Рубрики и поля → Справочники и создайте справочник.
  2. В редакторе рубрики добавьте поля значения.
  3. Создайте документы справочника.
  4. В рабочей рубрике добавьте поле Документ из рубрики и выберите справочник источником.

Справочник использует штатные рубрики, документы, права, API и ревизии AVE.cms. Признак directory только отделяет его в панели от новостей, страниц и товаров.

Двусторонние связи документов

Поле связи хранит выбранный документ в исходном документе. AVE.cms параллельно обновляет индекс, поэтому редактор показывает два направления:

  • Ссылается на — документы, выбранные в полях текущего документа;
  • Ссылаются сюда — документы, в которых выбран текущий документ.

Обратное значение вычисляется из индекса и не записывается вторым полем. Поэтому стороны не расходятся после редактирования.

Вычисляемые поля

Вычисляемое поле собирает значение из других полей документа.

Режим Пример
Текст {{ brand }} {{ model }}
Формула (price * quantity) - discount

Формула поддерживает числа, alias полей, скобки и +, -, *, /. PHP-код и функции не выполняются. Деление на ноль, неизвестный alias и неверная формула возвращают указанное в настройках резервное значение.

Значение пересчитывается перед предпросмотром и сохранением, затем хранится как обычное поле. Старые шаблоны, запросы, экспорт и API получают готовое значение.

Библиотека готовых наборов

Набор — заранее описанная группа полей для типовой задачи: статья, новость, карточка сотрудника, SEO или характеристики товара.

  • Копия создаёт обычные независимые поля.
  • Связанный набор запоминает источник и позволяет явно синхронизировать последующие изменения.

Перед применением показываются состав и конфликты alias. Существующие поля не перезаписываются молча. После применения проверьте порядок, ширину и обязательность полей в конструкторе рубрики.

Совместимость

Публичные шаблоны не переключаются автоматически: справочник остаётся рубрикой, связь и вычисление остаются полями, а набор только создаёт обычные поля. Инструменты можно внедрять постепенно на отдельных рубриках.