/

Администратору: подключение модуля к шаблону сайта

СТАТЬЯ 36

Эта страница предназначена для администратора Битрикса и разработчика шаблона. 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 при первой записи в непустой файл и правит только свой блок. При обновлении модуля сверяйте схему интеграции с документацией установленной версии, а не копируйте код из другой сборки.

Код вывода SEO-текста и проверенный результат на страницах с текстом и без него
«Настройка завершена только после проверки страницы с текстом и без него».