Настройки контекстов

Контекст определяет область материалов и соответствие полей результата полям ресурса MODX. Задачу можно создать только для включённого и корректно настроенного контекста.

Область блога

Можно использовать весь контекст или выбрать один либо несколько корневых разделов. При выборе разделов ContentFlow учитывает только их поддеревья.

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

Как подготовить структуру блога

Разделы, в которые ContentFlow сможет добавлять статьи, должны быть категориями MODX. Для обычного ресурса откройте его настройки и включите флаг Контейнер (isfolder). Ресурс с классом CollectionContainer также считается категорией, даже если значение isfolder не установлено отдельно.

Рекомендуемая структура выглядит так:

Блог (#100)                         ← корневой раздел
├── Смартфоны (#101)                ← конечная категория
├── Компьютеры и ноутбуки (#102)    ← конечная категория
└── Инструкции (#103)               ← родительская категория
    ├── VPS (#104)                  ← конечная категория
    └── Домены и DNS (#105)         ← конечная категория

В поле ID разделов блога укажите ID верхнего ресурса, внутри которого находятся категории. Для структуры выше это 100, то есть ID ресурса «Блог». Не нужно перечислять ID всех вложенных категорий: ContentFlow обойдёт всё поддерево самостоятельно.

ID ресурса отображается в дереве MODX рядом с его названием и присутствует в адресе страницы редактирования как параметр id. Если блог состоит из нескольких независимых веток, укажите их корневые ID через запятую, например 100, 250.

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

IMPORTANT

Указывайте ID контейнера блога, а не ID стартовой страницы сайта и не ID одной конечной категории. Иначе ContentFlow увидит слишком широкую область либо только одну ветку материалов.

Конечные категории

Конечной считается категория, которая:

• имеет isfolder = 1 либо class_key = CollectionContainer;
• не содержит дочерних категорий.

Обычные дочерние документы не мешают категории считаться конечной.

Например, категория «Смартфоны» может содержать сотни обычных статей и всё равно оставаться конечной. Но если внутри неё создана хотя бы одна дочерняя категория, «Смартфоны» становится родительской категорией, а публикация выполняется только в конечные категории ниже неё.

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

Content Manager получает полный путь категории от настроенного корня, например:

Блог → Смартфоны
Инструкции → VPS
Обзоры → VPS

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

Сопоставление полей

Для каждого результата укажите поле ресурса MODX или TV:

Результат	Значение по умолчанию
Заголовок	pagetitle
Alias	alias
Description	description
Краткое описание	introtext
Текст	content
Главное изображение	tv.image

TV указывается в формате tv.name, без MODX-тегов.

Одно поле назначения нельзя использовать сразу для нескольких результатов.

Длина заголовка и Description

Диапазоны задаются в формате МИН-МАКС, например:

40-80
140-160

При проверке допускается отклонение до 10% в обе стороны. Диапазон Introtext и целевой объём Content задаются отдельно в задаче.

Формирование alias

Доступны режимы:

• MODX — модель оставляет alias пустым, его формирует MODX;
• На языке материала — модель возвращает URL slug на языке статьи;
• Транслитерация — модель возвращает латинскую транслитерацию;
• Английский — модель передаёт смысл заголовка английским URL slug.

ContentFlow проверяет уникальность alias при создании ресурса. Если такой alias уже существует, к новому добавляется числовой суффикс.

Для режима MODX в контексте должен корректно работать automatic_alias, если включены дружественные URL.

Папка изображений

Путь задаётся от корня сайта, например:

/assets/uploads/articles/

Для каждого ресурса создаётся отдельный каталог с его ID. PHP CLI должен иметь право записи в базовую папку.

Синтаксис чанков

Настройка определяет вид офферов и рекламных вставок:

• MODX: [[$ChunkName]];
• Fenom: {include 'ChunkName'}.

В задаче указывается только имя чанка. Готовый тег формируется ContentFlow и передаётся агенту без возможности заменить его вызовом сниппета.