Эта страница предназначена для администратора Битрикса и разработчика шаблона. SEO-специалист может проверить конечный результат, но не должен менять файлы шаблона без прав и резервной копии. Модуль может разобрать адрес фильтра и без правки шаблона; точные выбранные свойства, значения и число товаров он получает через интеграцию с bitrix:catalog.smart.filter.
Подключение состояния умного фильтра
В Диагностике найдите используемый шаблон catalog.smart.filter. Кнопка Подключить дописывает вызовы в файлы шаблона и сохраняет .bak; прежде проверьте права записи и выбранный шаблон. Системный шаблон нельзя менять: скопируйте его в шаблон сайта. При ручном подключении в result_modifier.php данные передаются через $templateData, а в component_epilog.php восстанавливаются на каждом хите. Нужны оба файла, поскольку кеш компонента сохраняет $templateData, а epilog выполняется при каждом показе. Используйте точные строки и пути, показанные экраном диагностики версии модуля, затем очистите кеш и проверьте два фильтра с разными свойствами.
Если подключаете вручную, добавьте внутрь PHP-кода result_modifier.php рабочего шаблона bitrix:catalog.smart.filter. Если файла ещё нет, создайте его с <?php в первой строке, затем вставьте блок:
if (\Bitrix\Main\Loader::includeModule('topman.seofilter')) {
$templateData['TOPMAN_SEOFILTER'] = \Topman\SeoFilter\FilterState::extract($arResult, $arParams);
}
В component_epilog.php того же шаблона добавьте второй блок. Новый файл также начните с <?php:
if (\Bitrix\Main\Loader::includeModule('topman.seofilter')) {
\Topman\SeoFilter\FilterState::setFromTemplateData(
isset($templateData) && is_array($templateData) ? $templateData : array(),
isset($arResult) && is_array($arResult) ? $arResult : null,
isset($arParams) && is_array($arParams) ? $arParams : null
);
}
Это код внутри файлов шаблона уже размещённого компонента; повторно вызывать catalog.smart.filter не требуется. Перед правкой сохраните оба файла, после неё очистите кеш компонента и снова откройте фильтр с разными выбранными свойствами. Диагностика должна показать подключение обоих файлов. При обновлении модуля сравнивайте эти фрагменты с текущим экраном диагностики: именно он показывает эталон для установленной версии.
Вывод SEO-текста
В настройках выберите один способ Как выводить текст и подключите соответствующую точку в шаблоне. marker по умолчанию: разместите \Topman\SeoFilter\PageMeta\Text::placeholder() там, где нужен верхний текст, и placeholder('bottom') для нижнего; модуль заменяет маркер на готовой странице, обходя проблемы кеша шаблона. Если вместе с текстом нужно скрывать заголовок и обёртку при отсутствии материала, используйте пару blockIf() / blockEndIf() вокруг блока.
Пример для template.php в режиме marker — заголовок и контейнер появятся только при наличии верхнего текста:
<?php if (\Bitrix\Main\Loader::includeModule('topman.seofilter')): ?>
<?= \Topman\SeoFilter\PageMeta\Text::blockIf('top') ?>
<section class="seo-text">
<h2>О разделе</h2>
<?= \Topman\SeoFilter\PageMeta\Text::placeholder('top') ?>
</section>
<?= \Topman\SeoFilter\PageMeta\Text::blockEndIf('top') ?>
<?php endif; ?>
Для нижнего текста используйте такую же тройку вызовов с аргументом 'bottom' в месте нижнего блока. Не подставляйте результат Text::get() прямо в кешируемый шаблон каталога: маркер рассчитан на замену для текущего URL после сборки страницы.
desc подменяет описание раздела. В result_modifier.php рабочего шаблона bitrix:catalog.section оберните $arResult['DESCRIPTION'] через Text::wrapDescription(...). Экран диагностики может добавить это с резервной копией .bak. Если в настройках выбран другой способ, обёртка сохраняет обычное описание. Опция Вместо описания раздела: только инлайн-разметка влияет на допустимый HTML в этом режиме.
При ручной настройке режима desc добавьте в PHP-код result_modifier.php рабочего шаблона bitrix:catalog.section:
if (\Bitrix\Main\Loader::includeModule('topman.seofilter')) {
$arResult['DESCRIPTION'] = \Topman\SeoFilter\PageMeta\Text::wrapDescription(
isset($arResult['DESCRIPTION']) ? (string)$arResult['DESCRIPTION'] : ''
);
}
Обёртка оставляет пустое описание пустым. Если шаблон не выводит DESCRIPTION или в разделе его нет, этот способ не создаст видимый текст сам по себе; выберите marker либо view и предусмотрите место вывода в шаблоне.
view использует отложенные области Битрикса. В нужных местах template.php вызовите:
<?php $APPLICATION->ShowViewContent('tsf_seo_text_top'); ?>
<?php $APPLICATION->ShowViewContent('tsf_seo_text_bottom'); ?>
Первую строку разместите в верхнем блоке, вторую — в нижнем, а не подряд, если дизайн разводит эти области. Для собственного вывода существуют Text::has() и Text::get() с аргументом top или bottom, но использовать их нужно там, где данные текущей страницы уже определены; в кешируемом шаблоне каталога предпочтительнее маркер или отложенная область. После интеграции проверьте страницу с персональным текстом, страницу только с верхним/нижним шаблонным текстом и страницу без текста; последняя не должна оставлять пустой заголовок. Отдельное поле TSF_SEO_TEXT/UF_TSF_SEO_TEXT штатный шаблон сам не печатает.
Перелинковка, агенты и права
Компонент topman:seofilter.links разместите в нужном шаблоне раздела. Готовый вызов с параметрами IBLOCK_ID, SECTION_ID, LIMIT, TITLE, CACHE_TIME приведён в инструкции по перелинковке. Значение SECTION_ID=0 означает все разделы заданного инфоблока, а не текущий раздел: передавайте фактический ID раздела из контекста шаблона. После размещения проверьте публичные ссылки, исключение текущей страницы и отсутствие битых или закрытых от индексации адресов. В многосайтовой установке проверьте правильность инфоблока и раздела на каждом сайте. Если блок остаётся пустым после появления подходящего URL, учитывайте и кеш компонента, и отдельный часовой кеш набора ссылок модуля.
Если не выполняется очередь ИИ, sitemap, импорт или контроль мета, проверьте Настройки → Агенты, выполнение cron и права записи. В диагностике MISSING, DISABLED, STALLED означают разные причины; ручная кнопка прогона нужна для теста, а не для постоянного обслуживания. Ошибки NO_HOST, NO_DOC_ROOT, WRITE_FAILED соответственно требуют настройки домена, корня сайта или прав на файл. Перед изменением robots.txt сохраните исходную версию; модуль создаёт robots.txt.bak-topman при первой записи в непустой файл и правит только свой блок. При обновлении модуля сверяйте схему интеграции с документацией установленной версии, а не копируйте код из другой сборки.