ave-cms/help/administration/content-and-system-tools.md

Новые инструменты контента и системы

← К управлению системой

Эта страница помогает быстро найти новые возможности AVE.cms и понять, с чего начать. Инструменты ядра доступны сразу. Для исходящих событий, прогрева кеша и A/B-тестов сначала установите соответствующий модуль.

Краткая карта

Возможность	Где находится	Для чего нужна
Справочники	Рубрики и поля → Справочники	Общие списки брендов, городов, авторов и других повторяемых значений.
Связи документов	Редактор документа → Связи документов	Показывает прямые и обратные связи между материалами.
Вычисляемые поля	Рубрики и поля → редактор рубрики	Собирает значение из других полей без PHP.
Наборы полей	Рубрики и поля → Наборы полей	Быстро добавляет типовой комплект полей в рубрику.
Карта сайта	Публичный сайт → Карта сайта	Показывает меню, связанные страницы и документы вне меню.
A/B-тест представлений	Модули → A/B-тесты	Сравнивает два оформления одного набора данных.
Команды и глобальный поиск	Кнопка поиска в шапке или Ctrl+K	Открывает разделы и находит объекты панели.
Аудит действий	Система → События → Аудит	Показывает действия сотрудников и технические детали по дням.
Исходящие события	Модули → Исходящие события	Надёжно отправляет webhook внешним сервисам.
Прогрев кеша	Модули → Прогрев кеша	Заранее открывает опубликованные страницы небольшими порциями.

1. Справочники

Справочник нужен, когда одно значение используется во многих документах. Например, производителя лучше хранить отдельной записью справочника, а не печатать вручную в каждом товаре.

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

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

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

Обычное поле связи по-прежнему хранится в том документе, где его заполнили. Дополнительно AVE.cms строит индекс и может показать обратную сторону связи.

1. Откройте уже сохранённый документ.
2. Перейдите к дополнительным разделам формы.
3. Найдите блок Связи документов.
4. В колонке Этот документ ссылается находятся выбранные им материалы.
5. В колонке На этот документ ссылаются находятся материалы, где выбран текущий документ.

Нажатие по строке открывает связанный документ. Второе служебное поле создавать не нужно: обратная сторона вычисляется автоматически.

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

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

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

Примеры:

{{ brand }} {{ model }}
(price * quantity) - discount

В выражениях используются системные имена полей. Формулы поддерживают числа, скобки и операции +, -, *, /. PHP и произвольные функции не выполняются. Поле нельзя править в документе вручную: оно пересчитывается при предпросмотре и сохранении, затем доступно шаблонам, запросам, API и экспорту как обычное готовое значение.

4. Библиотека наборов полей

Набор помогает не собирать одинаковую структуру рубрики по одному полю.

1. Откройте Рубрики и поля → Наборы полей.
2. Найдите подходящий набор.
3. Выберите целевую рубрику.
4. Выберите режим и нажмите Добавить.

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

Набор также можно выбрать непосредственно в конструкторе полей рубрики.

5. Визуальная карта сайта

Откройте Публичный сайт → Карта сайта. Здесь показаны:

• зарегистрированные меню и их уровни;
• документы, к которым ведут пункты;
• произвольные ссылки;
• опубликованные документы, не включённые ни в одно меню.

Поиск помогает найти страницу по названию или URL. Нажатие по узлу ведёт в штатный редактор документа или навигации. Карта предназначена для проверки структуры и ничего не меняет сама.

6. A/B-проверка представлений

Для этой возможности нужен установленный и включённый модуль A/B-тесты. Представления должны быть заранее созданы и опубликованы в разделе Публичный сайт → Представления.

1. Откройте Модули → A/B-тесты.
2. Создайте эксперимент.
3. В поле Цель выберите Представление по коду контекста.
4. Укажите код места вывода.
5. Добавьте минимум два варианта.
6. Для контрольного варианта оставьте Контрольное представление.
7. Для второго выберите опубликованное представление.
8. Сначала сохраните эксперимент как черновик, проверьте варианты и только затем переведите его в состояние Запущен.

Эксперимент меняет только оформление. Запрос, рубрика и набор данных остаются теми же. Один посетитель стабильно видит один вариант. Если эксперимент выключен или представление недоступно, используется обычное назначение.

Подробнее: представления и A/B-тесты.

7. Командная палитра и глобальный поиск

Открыть палитру можно двумя способами:

• нажать кнопку поиска в верхней панели;
• нажать Ctrl+K, а на macOS — Cmd+K.

Пока строка пустая, палитра показывает доступные разделы панели. После ввода двух символов начинается глобальный поиск по документам, рубрикам, справочникам, блокам, запросам и навигациям. Можно искать по названию, URL и ID.

Управление с клавиатуры:

• ↑ и ↓ — выбрать результат;
• Enter — открыть;
• Esc — закрыть;
• повторный Ctrl+K или Cmd+K — закрыть палитру.

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

8. Аудит действий

Откройте Система → События → Аудит. Здесь видно, кто и когда выполнил действие, а также какого объекта оно касалось. Записи разделены по дням. Технические данные раскрываются кнопкой в конце строки.

Аудит можно искать, экспортировать в CSV и очищать при наличии права управления событиями. После очистки система оставляет одну запись о самой операции.

9. Надёжные исходящие события

Для этой возможности установите модуль Исходящие события, затем откройте Модули → Исходящие события.

1. Нажмите Добавить подписку.
2. Укажите название получателя и его HTTPS URL.
3. Введите точное событие, например content.document.published, или маску content.document.*.
4. Укажите таймаут, число попыток и секрет подписи.
5. Сохраните и включите подписку.
6. В Планировщике включите задачи модуля для автоматической доставки.

Событие сначала сохраняется в БД, а HTTP-запрос выполняется отдельно. Поэтому недоступная CRM, Telegram-мост или другой сервис не мешает сохранить документ. Вкладки Очередь и Попытки доставки показывают результат, а остановленное событие можно вернуть на повтор.

Подробнее: надёжные исходящие события.

10. Автоматический прогрев кеша

Для этой возможности установите модуль Прогрев кеша, затем откройте Модули → Прогрев кеша.

1. Во вкладке Настройки укажите канонический HTTPS URL сайта.
2. Выберите небольшое число URL за запуск, обычно 10–15.
3. Включите добавление опубликованных документов.
4. Нажмите Собрать все URL.
5. Для проверки нажмите Прогреть сейчас.
6. В Планировщике включите задачи модуля.

После сохранения опубликованного документа его адрес добавляется в очередь. После полного сброса кеша модуль запрашивает новый план. Публичные страницы открываются небольшими пачками, поэтому прогрев не создаёт резкий пик нагрузки. Статус, HTTP-код, время ответа и ошибки видны в очереди.

Подробнее: автоматический прогрев кеша.

Что изменится на публичном сайте

Справочники, наборы полей, карта сайта, поиск панели и аудит действий сами по себе не меняют публичный HTML. Вычисляемое поле начнёт влиять на сайт только после вставки его значения в шаблон или условие. Представление изменит вывод только после публикации, назначения и запуска эксперимента. Исходящие события и прогрев работают в фоне и не заменяют публичные шаблоны.