/

Макросы, склонение и варианты текста

СТАТЬЯ 05

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

Запись Что подставляется Пример применения
#SECTION_NAME#, #SECTION_CODE# Название и код раздела «Название раздела» и kod-razdela
#IBLOCK_NAME# Название инфоблока «Каталог товаров»
#FILTER_ALL# Выбранные значения фильтра через запятую; цена в конце «Значение свойства, значение дополнительного свойства»
#FILTER_PROP_<КОД_СВОЙСТВА># Значения конкретного свойства; часть в угловых скобках замените реальным кодом свойства «Значение свойства»
#PRICE_FROM#, #PRICE_TO# Выбранные границы цены, если они есть «Нижняя граница цены» и «верхняя граница цены» в окружающем тексте
#COUNT# Число элементов под фильтром, если известно «Количество найденных элементов» — окончание пишите с учётом числа
#PAGE# Номер страницы пагинации со второй страницы «Страница 2»
#CITY# Город из настроек данного сайта «Название города»

Для выбранного свойства используется код, а не видимое имя: в конструкции #FILTER_PROP_<КОД_СВОЙСТВА># замените часть <КОД_СВОЙСТВА> реальным кодом из инфоблока. Макрос без данных не должен оставлять в готовом тексте обломок фразы. Поэтому конструкцию от #PRICE_FROM# до #PRICE_TO# используйте только там, где обе границы гарантированно выбраны; иначе сформулируйте шаблон без обязательной цены. Проверяйте также текст на разделах с разным родом и числом.

Модуль сначала обрабатывает штатные конструкции Битрикса, например {=this.Name} и {=this.property.CODE}, а затем собственные макросы. Склонение пишется как {=morphy #SECTION_NAME# "рд"}: аргумент падежа может быть русским или латинским, при необходимости с числом. Словари phpMorphy входят в модуль, но название бренда и составные товарные названия всё равно нужно проверить глазами. Запись {купить|заказать} — спинтакс: выбранный вариант стабилен для одного URL, а не меняется при каждом показе.

Учебный title Купить #SECTION_NAME# #FILTER_ALL# — цены и наличие может превратиться в грамматически неверную фразу из названия раздела и выбранного значения свойства, хотя технически макросы отработали. Исправьте основу, при необходимости используйте склонение раздела, затем проверьте страницу с одним свойством, страницу с несколькими свойствами и страницу без выбранного значения. Для безопасного запуска сначала сохраните шаблон выключенным, проверьте предпросмотр или тестовый URL, затем активируйте. Дополнительные поля и правила приоритета описаны в шаблонах мета.

Справка по макросам и итоговый title публичной страницы
«Проверяйте не запись макроса, а получившуюся фразу».