Содержание

О модуле

Установка модуля

На странице модуля https://marketplace.1c-bitrix.ru/solutions/luxar.indexcontrol/ нажмите “Купить”. Произведите оплату заказа. Вам на почту придет номер купона.

Для активации купона перейдите в административную часть своего сайта, пройдите по пути “Marketplace” - “Обновление платформы”. На вкладке “Активация купона” активируйте полученный купон:


После успешной активации купона, перейдите по пути “Marketplace” - “Установленные решения”.

В списке “Купленные решения” вы увидите модуль “Расширенный SEO-модуль: управление индексацией сайта” уже готовый к установке.

Нажмите на кнопку “Меню”, слева от названия решения и выберите “Загрузить”.

Откроется ваш сайт на странице установки. Выберите чекбокс рядом с модулем, если он не выбран, и нажмите кнопку “Загрузить”.

Далее потребуется принять условия лицензионного соглашения. После этого начнется скачивание модуля, дождитесь его окончания. 

После скачивания модуля, система предложит вам его установить. Нажмите кнопку “Установить”.

Модуль установится на сайт и вы увидите сообщение об успешной установке модуля на сайт:

После этого вы можете приступать к настройке модуля.



Демо-версия модуля и ее ограничения

Перед покупкой модуля вы можете попробовать в работе модуль “Расширенный SEO-модуль: управление индексацией сайта”.

Ограничения демо-версии

Демо-версия модуля имеет следующие ограничения:

  • Время работы модуля - 3 дня;
  • Количество адресов в Sitemap - не более 10 шт. у каждого инфоблока;
  • Количество редиректов - не более 5 шт.
  • Количество SEO-настроек страниц - не более 5 страниц.

Установка демо-версии

Чтобы установить демо-версию, на странице модуля https://marketplace.1c-bitrix.ru/solutions/luxar.indexcontrol/ нажмите на кнопку “Попробовать” 



В открывшемся поле, введите адрес вашего сайта и нажмите “Установить”.

Откроется ваш сайт на странице установки. Выберите чекбокс рядом с модулем, если он не выбран, и нажмите кнопку “Загрузить”.

Далее потребуется принять условия лицензионного соглашения. После этого начнется скачивание модуля, дождитесь его окончания. 

После скачивания модуля, система предложит вам его установить. Нажмите кнопку “Установить”.

Модуль установится на сайт и вы увидите сообщение об успешной установке модуля на сайт:

Если работа модуля вам понравилась и вы поняли, что он решит ваши задачи, то вы можете купить его и продолжить полноценно использование.

После этого вы можете приступать к детальной настройке модуля.



Начальные настройки модуля

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

На открывшейся странице, выберите из списка модулей “Расширенный SEO-модуль: управление индексацией сайта”:

Откроется страница с настройками модуля. Вам нужно поставить галки у чекбоксов “Включить редиректы” и “Включить управление SEO тегами” на вкладках сайтов, для которых это необходимо.

После этих действий первоначальную настройку модуля можно считать завершенной. И можно переходить к детальной настройке Sitemap, редиректов и SEO-свойств страниц.

Sitemap.xml

Что такой Sitemap

Sitemap - XML-файлы с информацией для поисковых систем о страницах веб-сайта, которые подлежат индексации. Sitemaps могут помочь поисковикам определить местонахождение страниц сайта, время их последнего обновления, частоту обновления и важность относительно других страниц сайта для того, чтобы поисковая машина смогла более разумно индексировать сайт. Использование протокола Sitemaps не является гарантией того, что веб-страницы будут проиндексированы поисковыми системами, это всего лишь дополнительная подсказка для сканеров, которые смогут выполнить более тщательное сканирование сайта.

Что такое “changefreq” и “priority” файлах sitemap.xml

Changefreq” в файле sitemap.xml - это атрибут, который указывает поисковым системам, с какой частотой ваша страница обычно меняется. Вы можете указать значение "always" (частотные изменения), "hourly" (ежечасные изменения), "daily" (ежедневные изменения), "weekly" (еженедельные изменения), "monthly" (ежемесячные изменения), "yearly" (ежегодные изменения) или "never" (изменения не происходят).

Priority” в файле sitemap.xml - это атрибут, который указывает поисковым системам, какую важность вы присваиваете вашей странице относительно других страниц на вашем сайте. Значение priority может быть от 0.0 до 1.0, где 1.0 означает наивысшую важность.

Эти атрибуты (changefreq и priority) помогают поисковым системам понять, как часто обновляются ваши страницы и какова их важность в контексте вашего сайта.

Проблемы с Sitemap в стандартном модуле "Поисковая оптимизация (seo)" от 1С-Битрикс.

Почему же нужен отдельный модуль управления индексацией?

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

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

И вот перечень основных проблем:

  • Нет возможности указать changefreq и priority для адресов в sitemap ни в каком виде;
  • Нет тонкой настройки фильтров для выгрузки элементов инфоблоков. Нельзя указать какие элементы не нужны в sitemap;
  • Нет выгрузки картинок в специальный sitemap-файл;
  • Нет возможности настроить автоматическую перегенерацию sitemap, только руками генерировать при каждой необходимости;
  • При большом количестве товаров на сайте, изменение/добавление каждого товара происходит с задержкой, т.к. каждый раз Битрикс просматривает файлы sitemap для его актуализации;
  • Нельзя управлять количеством адресов (есть ограничения) и размером sitemap-файлов;
  • Нельзя добавлять произвольные адреса в sitemap;
  • При установленном модуле "SЕО умного фильтра" от Сотбит, генерация sitemap модуля "Поисковая оптимизация" перезатирает добавленные файлы от "SЕО умного фильтра".

Все эти проблемы могут решить Расширенный SEO-модуль: управление индексацией сайта и Расширенная SEO карта сайта Smart Sitemap: автогенерация, легкое управление и настройка

Возможности Sitemap в модуле Расширенный SEO-модуль: управление индексацией сайта

Раздел "Sitemap.xml" модуля "Расширенный SEO-модуль: управление индексацией сайта" обладает следующими возможностями:

  • Формирование отдельного sitemap для каждого сайта, в режиме многосайтовости;
  • Ежедневное автоматическое обновление sitemap;
  • Возможность указать параметры changefreq и priority для каждой сущности;
  • Генерация специальной sitemap для картинок инфоблоков;
  • Возможность создавать правила исключения из sitemap для товаров без цены;
  • Возможность указать минимальную цену товара для выгрузки в sitemap;
  • Поддержка событий. Возможность тонкой настройки фильтров элементов, которые попадают в sitemap при определенных условиях;
  • Возможность добавить любые произвольные адреса в sitemap;
  • Поддержка модуля "SEO-умного фильтра" от Сотбит;
  • Поддержка мультирегиона от Люксар Групп и Аспро (скоро).

Создание/изменение Sitemap

Для управления Sitemap необходимо перейти по пути: “Решения Luxar” - “Управление индексацией страниц” - “Sitemap”, либо по адресу  вашсайт.ru/bitrix/admin/luxar.indexcontrol_sitemap.php. Откроется список уже добавленных Sitemap, если таковые имеются. 

Для создания новой Sitemap нажмите кнопку “Добавить (Название сайта)” в правом верхнем углу.


Если у вас в системе несколько сайтов, которые используются в режиме многосайтовости, то нажмите на “Стрелку вниз”, на кнопке “Добавить”, чтобы открыть список существующих сайтов, и нажмите на сайт, на который нужно добавить Sitemap.


Если вы хотите изменить настройки существующей Sitemap, то нажмите на название, либо выберите в контекстном меню пункт “Редактировать” нужной вам Sitemap.


Перед вами откроется форма со вкладками, на которых вы сможете задать все необходимые настройки для Sitemap.

Базовые настройки

Форма добавления/редактирования Sitemap выглядит так:


Название - Заголовок Sitemap, который отображается только в списке Sitemap.

Описание - Служебное поле, служит для заметок.

Название файла карты сайта - В этом поле составляется имя базового файла Sitemap. Обычно это “sitemap.xml”. Здесь требуется выбрать протокол, по которому работает ваш сайт, а также домен, который будет указан во всех адресах, которые относятся к данной Sitemap.

Домены в выпадающий список попадают из настроек сайта: ”Настройки” - ”Настройки продукта” - “Сайты” - “Список сайтов” - Ваш сайт. В списке будут домены, которые указаны в полях “Название” и “Доменное имя”.

Путь к корневой папке веб-сервера для этого сайта - Если ваш сайт работает в режиме многосайтовости, где каждый сайт находится в своей папке, то в это поле необходимо ввести путь к корневой папке сайта. 

Максимальное количество адресов в одном файле и Максимальный размер файла sitemap в байтах - Эти поля задают настройки файлов Sitemap.
Максимальные рекомендуемые значения для этих полей: 50000 для количества адресов и 50000000 размер файла.

Автоматическая генерация на агенте - Если поставить этот чекбокс, то карта сайта будет автоматически генерироваться один раз в сутки, в противном случае для генерации карты нужно будет нажимать кнопку “Запустить” в списке Sitemap при необходимости.

Файлы

Форма настроек файлов выглядит так:

Имя файла карты сайта с данными о файлах - В этом поле можно указать, или оставить по умолчанию, имя файла, который будет сформирован со списком адресов файлов на сайте.

Добавлять "/" в конце папки - При выбранной данной настройке в конец адреса папки будет добавляться слэш - “/”, например, в этом случае адрес папок будет выглядеть так “вашсайт.ru/bitrix/about/”, а при убранном чекбоксе  “вашсайт.ru/bitrix/about”.

Убирать "index.php" - Из адреса будет убран файл “index.php”.

Выберите "changefreq" и Выберите "priority" - Эти поля устанавливают соответствующие настройки для физических папок и файлов сайта.

Включаемые файлы - В данном поле можно задать маску файлов, которые нужно включить в Sitemap. 

Переключатель Использовать - Позволяет переключить тип отображения иерархии файлов и папок в блоке “Структура сайта”, который расположен ниже.

Структура сайта - В этом блоке отображается структура файлов сайта. Здесь вам необходимо выбрать папки и файлы, которые нужно включить в Sitemap.
Нажав на шестеренку (добавлено в версии 1.0.10), радом с названием файла/папки, можно задать "changefreq" и "priority" для конкретно этого файла/папки.

Инфоблоки

Форма настройки инфоблоков выглядит так:


Шаблон имени файла карты сайта с данными инфоблоков - в этом поле нужно указать, или оставить по умолчанию, шаблон sitemap-файлов, который будет формироваться. В шаблоне обязательно нужно использовать маску “#IBLOCK_ID#”, т.к. адреса каждого инфоблока записываются в свой отдельный файл.

Далее идет список типов инфоблоков, которые есть на сайте и которые относятся только к выбранному на начальном этапе сайту. Т.е. если вы добавляете Sitemap для сайта s1, то в данный список не попадут инфоблоки от сайта s2.

Если выбрать чекбокс какого-нибудь типа инфоблока, то раскроется список инфоблоков, которые входят в этот тип.


Выберите инфоблоки, для которых необходимо сформировать Sitemap, путем установки чекбокса в соответствующую ячейку.

Над инфоблоками есть чекбоксы:

Список - в Sitemap будет добавлен адрес страницы информационного блока, который задается в его настройках:


Секции - Будут ли добавлены секции (разделы) инфоблока в Sitemap.

Элементы - Будут ли добавлены элементы инфоблока в Sitemap.

Картинки - При выбранном чекбоксе, из инфоблока будут собираться ссылки на картинки, которые есть у элементов инфоблока.

Картинки берутся из полей “Картинка для анонса”, “Детальная картинка”, из свойств типа “Файл”, а также из текстов элементов инфоблока.

Напротив каждого инфоблока есть кнопка “Настройки”, при нажатии на которую, открывается диалог выбора детальных параметров для данного инфоблока:

Если выбранный инфоблок является торговым каталогом, то здесь же можно указать параметры исключения элементов из Sitemap:


Также, у выбранных инфоблоков будет возможность указать разделы, которые требуется добавить в Sitemap. Если разделы не указывать, то будут добавлены все активные разделы и подразделы инфоблока.

Важно. Чтобы в Sitemap попали торговые предложения товаров, в настройках инфоблока ТП должен быть корректно указан “URL страницы детального просмотра”:


СЕО умного фильтра от Сотбит

Если на вашем сайте установлен модуль “Сотбит: SEO умного фильтра – мета-теги, заголовки, карта сайта” https://marketplace.1c-bitrix.ru/solutions/sotbit.seometa/, то в настройках Sitemap появится вкладка “SEO умного фильтра”:


На этой вкладке вы можете включить формирование Sitemap, задать шаблон имени файла Sitemap, а также указать минимальное количество элементов, которое находится на странице с фильтром.

Указав минимальное количество элементов, мы можем исключить попадание пустых страниц в карту сайта.

Использование данного функционала избавит вас от необходимости постоянного формирования карты сайта через сам модуль “Сотбит: SEO умного фильтра – мета-теги, заголовки, карта сайта”, и вы можете быть уверены, что все сформированные страницы фильтра всегда будут в файле Sitemap.

Дополнительные адреса

Модуль “Расширенный SEO-модуль: управление индексацией сайта” позволяет вам добавлять произвольные адреса для индексации, которые не подходят под иные условия, которые формируются в массовом порядке.

К таким адресам могут относиться ссылки на документы, которые лежат, например в папке “upload”.

Форма добавления дополнительных адресов выглядит так:

Укажите, или оставьте по умолчанию, шаблон имени файла с дополнительными адресами. Выберите changefreq и priority в соответствующих полях.

Ссылки можно указывать как с “http/https” в начале, так и относительные, например “/about/”.

Генерация Sitemap

Генерацию файлов Sitemap можно выполнить как в ручном режиме, так и включить автоматический режим генерации один раз в сутки.

Для генерации в ручном режиме, перейдите в список добавленных Sitemap, и нажмите кнопку “Запустить”, напротив нужной Sitemap. На странице будет отображаться прогресс генерации, а при окончании процесса, будет выведен список файлов, который сформировался:


Для просмотра сформированного файла, достаточно на него нажать и он откроется в новом окне.



Редиректы

Описание функционала

Редирект на сайте - это процесс перенаправления пользователей с одной страницы или URL на другую.

В основном, редиректы используются для следующих случаев:

1. Перенос страницы: если вы переместите или переименуете страницу/раздел на своем сайте, редирект позволит автоматически перенаправить пользователей со старого URL на новый. Это позволит не потерять целевых пользователей, так как они будут автоматически перенаправлены на правильную страницу, а не столкнутся с ошибкой 404, а также с незавершенностью своего действия.

2. Изменение домена: если вы измените домен вашего сайта, редиректы помогут перенаправить пользователей со старого домена на новый. Это важно для сохранения трафика и репутации вашего сайта.

3. Устранение дубликатов контента: если у вас есть две или более страницы с одинаковым или почти одинаковым контентом, редирект позволяет указать поисковым системам, какую страницу следует считать основной из аналогичных. Это помогает избежать проблем с дублированием контента и улучшает SEO факторы вашего сайта.

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

Например, представьте, что у вас есть страница на вашем сайте с URL "example.ru/old-page". Вы решаете перенести ее на новый URL "example.ru/new-page". Чтобы не потерять посетителей, вы можете создать редирект с помощью кода 301, который автоматически перенаправит людей с "example.ru/old-page" на "example.ru/new-page". Таким образом, пользователи всегда будут попадать на актуальную страницу вашего сайта.

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

С помощью модуля “Расширенный SEO-модуль: управление индексацией сайта” вы можете:

  • легко управлять редиректами на своем сайте, создавая нужные редиректы вручную;
  • настроить автоматическое создание редиректов при изменении адресов у товаров или разделов инфоблоков;
  • импортировать список редиректов из CSV-файла.

Создание/изменение редиректа

Для управления списком редиректов, необходимо перейти по пути в административной части вашего сайта: “Решения Luxar” - “Управление индексацией страниц” - “Редиректы”, либо по адресу вашсайт.ru/bitrix/admin/luxar.indexcontrol_redirect.php. Откроется список существующих редиректов, если таковые там имеются.

Для создания нового редиректа, нажмите кнопку “Добавить редирект” в правом верхнем углу.

Если вы хотите изменить существующий редирект, то нажмите на поле “Откуда”, либо выберите в контекстном меню пункт “Изменить” напротив нужного редиректа.

Перед вами откроется форма редактирования/создания редиректа.

Активность - Нужно ли срабатывать редиректу.

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

Адрес откуда и Адрес куда - С какого адреса и на какой адрес будет происходить настраиваемый вами редирект.

Ограничить по регионам - Если на сайте установлен модуль мультирегиона от Люксар Групп, то выбрав чекбокс, можно будет выбрать конкретные регионы, на которых редирект будет срабатывать.

Комментарий - Служебное поле для указания служебной информации.


Автогенерация редиректов

Автогенерация редиректов - это функционал, который позволяет фиксировать изменение публичного адреса элемента, или раздела инфоблока, и автоматически создавать редирект со старого адреса на новый, тем самым сайт избавляется от 404-х ошибок.

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

Создание/изменение редиректа

Для управления списком автоматических редиректов, необходимо перейти по пути: “Решения Luxar” - “Управление индексацией страниц” - “Редиректы” - “Автогенерация редиректов”, либо по адресу вашсайт.ru/bitrix/admin/luxar.indexcontrol_redirect_auto.php. Откроется список существующих настроек автоматических редиректов, если таковые уже у вас имеются. 

Для создания новой настройки, нажмите кнопку “Добавить настройку инфоблока” в правом верхнем углу.

Перед вами откроется форма редактирования/создания настройки инфоблока для автоматического редиректа:


В списке инфоблоков вам необходимо выбрать те инфоблоки, для которых должны создаваться автоматические редиректы, в соответствии с заданными настройками формирования редиректов. Для тех инфоблоков,  которые не будут выбраны в этом списке,редиректы создаваться не будут. Если нужно выбрать несколько, то это можно сделать, зажав клавишу Ctrl и нажав мышкой на нужные инфоблоки.

Далее необходимо выбрать что именно должно происходить при выше описанных изменениях в инфоблоке.

Создавать редирект при изменении элементов - Если у элемента изменился URL, то редирект создастся.

Создавать редирект при изменении разделов - Если у раздела изменился URL, то редирект создастся.

Далее следует сохранить настройку инфоблока, нажав кнопку “Сохранить” или “Применить”.

Импорт редиректов из CSV-сайта

Модуль позволяет выполнять импорт большого числа редиректов из файла CSV-формата.

Что такое CSV-файл?

CSV (Comma-Separated Values) - это текстовый файл, в котором данные разделены запятыми (или другими разделителями) для представления табличной информации. Он используется для обмена данных между программами, а также для импорта и экспорта данных из различных приложений, включая электронные таблицы, базы данных и другие.

Подробнее.


Перед импортом вам необходимо подготовить CSV-файл со списком редиректов. Первый столбец содержит адрес откуда должен быть редирект, а второй - куда он должен перенаправлять.

Скачать пример файла: https://luxar.group/upload/marketplace/luxar.indexcontrol/redirect_import_csv.csv

Далее нужно перейти на страницу импорта по пути: “Решения Luxar” - “Управление индексацией страниц” - “Редиректы” - “Импорт из CSV-файла”, либо по адресу вашсайт.ru/bitrix/admin/luxar.indexcontrol_redirect_import_csv.php.

Перед вами откроется форма:

CSV-файл - выберите подготовленный CSV-файл с редиректами.

Разделитель в файле - Укажите используемый разделитель в файле из предлагаемых вариантов.

Сайт - Сайт, к которому нужно привязать добавляемые редиректы.

Ограничить по регионам - Если на сайте установлен модуль мультирегиона от Люксар Групп, то выбрав чекбокс, можно будет выбрать регионы, на которых редирект будет срабатывать.

Комментарий - Служебное поле для заполнения служебной информацией.

Выбрав/заполнив нужные поля, нажмите на кнопку “Импортировать”. Редиректы будут созданы.

Что такое CSV-файл?

CSV (Comma-Separated Values) - это текстовый файл, в котором данные разделены запятыми (или другими разделителями) для представления табличной информации. Он используется для обмена данных между программами, а также для импорта и экспорта данных из различных приложений, включая электронные таблицы, базы данных и другие.

В CSV-файле каждая строка представляет собой отдельную запись, а значения данных разделены запятыми (или другими символами, такими как точка с запятой, табуляция и т.д.). Это упрощает чтение и обработку информации компьютерными программами.

CSV-файлы широко применяются в различных сферах, таких как экспорт и импорт контактов, обмен данными между системами учета, управление инвентарем, анализ данных и многое другое. Они являются удобным форматом для передачи и хранения структурированных данных, так как они легко читаемы как человеком, так и компьютером.

Например, вот простой CSV-файл, содержащий информацию о людях:

```

Имя,Фамилия,Возраст

Алексей,Иванов,25

Елена,Петрова,33

Михаил,Сидоров,42

```

Здесь каждая строка представляет собой отдельного человека, а значения имени, фамилии и возраста разделены запятой. Этот CSV-файл может быть использован для импорта этих данных в электронную таблицу или другое приложение для дальнейшей обработки или анализа.

SEO-свойства страниц (мета-теги)

Описание функционала

Модуль позволяет легко управлять мета-свойствами страниц сайта, переопределяя их так как вам необходимо.

Правильнее всего, сперва настроить инфоблоки с товарами, новостями и статьями стандартными средствами 1С-Битрикс (https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=34&LESSON_ID=6305) , а потом уже, при необходимости, постранично переопределять SEO-свойства уже конкретных страниц вашего сайта.


Создание/изменение SEO-свойств страницы

Для наглядности, практичнее всего создавать или изменять SEO-свойства в публичной части сайта. После установки модуля на панели управления, в публичной части, появляется кнопка “SEO свойства страницы”:


Если нажать на эту кнопку, то откроется всплывающее окно с параметрами:

Для управления списком SEO-свойств страниц, необходимо перейти по пути: “Решения Luxar” - “Управление индексацией страниц” - “SEO-свойства страниц”, либо по адресу вашсайт.ru/bitrix/admin/luxar.indexcontrol_seotags.php. Откроется список уже заданных SEO-свойств страниц, если таковые имеются. 

Для добавления новой страницы, нажмите кнопку “Добавить страницу” в правом верхнем углу.

Вкладка “Основное”

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

Сайт - Какому сайту принадлежит эта настройка.

Title - Meta-тег страницы “title”.

Description - Meta-тег страницы “description”.

Keywords - Meta-тег страницы “keywords”.

H1 - Если это поле не пустое, то на странице будет найден тег H1 и в нем будет заменен текст на указанный.

Вкладка “Дополнительно”

Canonical - Данное поле устанавливает канонический адрес страницы, т.е. значение в тег <link rel="canonical">.

Robots - Данное поле устанавливает значение meta-тега “robots”. Подробнее https://yandex.ru/support/webmaster/controlling-robot/meta-robots.html

Редирект на адрес - Если указать в данном поле URL, то на него будет выполнен редирект с кодом 301.

Разработчикам

Модуль “Расширенный SEO-модуль: управление индексацией сайта” имеет ряд событий, благодаря которым можно влиять на его работу.

Подробнее про события 1С-Битрикс: https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&CHAPTER_ID=03493

События для раздела “Sitemap”

События раздела “Sitemap” позволяют влиять на формирование sitemap на сайте.

Событие “OnBeforeSitemapIndexFileGeneration”

Событие “OnBeforeSitemapIndexFileGeneration” вызывается перед генерацией главного файла sitemap.xml, когда уже все sitemap-файлы сформированы, и получает список всех sitemap-файлов.

Может быть полезно, если в главный файл sitemap.xml нам нужно добавить дополнительные файлы, например от других модулей.

Получает параметры:

ID - ID sitemap.

FILES - Массив сформированных файлов.


Пример использования:

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler(
    'luxar.indexcontrol',
    "OnBeforeSitemapIndexFileGeneration",
    ['LuxarIndexcontrolEventes', 'handlerOnBeforeSitemapIndexFileGeneration']
);

class LuxarIndexcontrolEventes {

    public static function handlerOnBeforeSitemapIndexFileGeneration($event) {
        $arParam = $event->getParameters();

        $sitemapId = $arParam['ID'];
        $sitemapFilesList = $arParam['FILES'];

        if ($sitemapId == 1) {
            /*
             * Что-то делаем со списком, например, добавляем еще файлы
             */
            $sitemapFilesList[] = 'https://site.ru/sitemap_one.xml';
            $sitemapFilesList[] = 'https://site.ru/sitemap_two.xml';
            $sitemapFilesList[] = 'https://site.ru/sitemap_three.xml';

            $result = new \Bitrix\Main\EventResult(
                \Bitrix\Main\EventResult::SUCCESS,
                $sitemapFilesList
            );
            return $result;
        }
    }
}

Событие “OnAfterSitemapGeneration”

Событие “OnAfterSitemapGeneration” вызывается после генерацией главного файла sitemap.xml, когда уже все sitemap-файлы сформированы и записаны в главный файл sitemap.xml.

Событие может быть использовано, если требуется выполнить дополнительную обработку Sitemap-файлов, например, скопировать или модифицировать, либо выполнить какие-то действия после формирования sitemap сайта.

Получает параметры:

ID - ID sitemap.

FILES - Массив сформированных файлов.


Пример использования:

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler(
    'luxar.indexcontrol',
    "OnAfterSitemapGeneration",
    ['LuxarIndexcontrolEventes', 'handlerOnAfterSitemapGeneration']
);

class LuxarIndexcontrolEventes {

    public static function handlerOnAfterSitemapGeneration($event) {
        $arParam = $event->getParameters();

        $sitemapId = $arParam['ID'];
        $sitemapFilesList = $arParam['FILES'];

        if ($sitemapId == 1) {
            /*
             * Что-то делаем со списком, например, отправляем оповещение, что sitemap сформирован
             */
        }
    }
}

Событие “OnSitemapGenerationFilterIblockSection”

Событие “OnSitemapGenerationFilterIblockSection” вызывается перед получением списка разделов. Этим событием можно повлиять на фильтр списка разделов, либо пропустить генерацию файла с разделами инфоблока.


Получает параметры:

ID - ID sitemap.

FILTER - Фильтр для дополнительной выборки разделов инфоблока, которые попадут в файл Sitemap.

Возможна отмена генерации sitemap для разделов инфоблока.

Пример использования:

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler(
    'luxar.indexcontrol',
    "OnSitemapGenerationFilterIblockSection",
    ['LuxarIndexcontrolEventes', 'handlerOnSitemapGenerationFilterIblockSection']
);

class LuxarIndexcontrolEventes {

    public static function handlerOnSitemapGenerationFilterIblockSection($event) {
        $arParam = $event->getParameters();

        $sitemapId = $arParam['ID'];
        $arFilter = $arParam['FILTER'];

        if ($sitemapId == 1) {
            /*
             * Что-то делаем с фильтром
             */
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::SUCCESS,
               $arFilter)
            ;
            return $result;
        }
        else {
            /*
             * Отменяем генерацию sitemap для разделов инфоблока
             */
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::ERROR,
            );
            return $result;
        }
    }
}

Событие “OnSitemapGenerationFilterIblockElement”

Событие “OnSitemapGenerationFilterIblockElement” вызывается перед получением списка элементов инфоблока. Этим событием можно повлиять на фильтр списка элементов, либо пропустить генерацию файла с элементами инфоблока.


Получает параметры:

ID - ID sitemap.

FILTER - Фильтр для дополнительной выборки элементов инфоблока, которые попадут в файл Sitemap.

Возможна отмена генерации sitemap для элементов инфоблока.

Пример использования:

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler(
    'luxar.indexcontrol',
    "OnSitemapGenerationFilterIblockElement",
    ['LuxarIndexcontrolEventes', 'handlerOnSitemapGenerationFilterIblockElement']
);

class LuxarIndexcontrolEventes {

    public static function handlerOnSitemapGenerationFilterIblockElement($event) {
        $arParam = $event->getParameters();

        $sitemapId = $arParam['ID'];
        $arFilter = $arParam['FILTER'];

        if ($sitemapId == 1) {
            /*
             * Модифицируем фильтр
             */
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::SUCCESS,
               $arFilter)
            ;
            return $result;
        }
        else {
            /*
             * Отменяем генерацию sitemap для элементов инфоблока
             */
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::ERROR,
            );
            return $result;
        }
    }
}

Событие “OnSitemapGenerationBeforeIblockElement”

Событие “OnSitemapGenerationBeforeIblockElement” вызывается перед добавлением элемента инфоблока в sitemap. Этим событием можно повлиять на ссылку на элемент, либо исключить элемент из файла sitemap.

Получает параметры:

ID - ID sitemap.

FIELDS - Массив с полями элемента. 


Пример использования:

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler(
    'luxar.indexcontrol',
    "OnSitemapGenerationBeforeIblockElement",
    ['LuxarIndexcontrolEventes', 'handlerOnSitemapGenerationBeforeIblockElement']
);

class LuxarIndexcontrolEventes {
    public static function handlerOnSitemapGenerationBeforeIblockElement($event) {
        $arParam = $event->getParameters();

        $sitemapId = $arParam['ID'];
        $arElement = $arParam['FIELDS'];

        if ($sitemapId == 1) {
            /*
             * Модифицируем элемент инфоблока
             */
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::SUCCESS,
               $arElement)
            ;
            return $result;
        }
        else {
            /*
             * Убираем элемент из файла sitemap
             */
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::ERROR,
            );
            return $result;
        }
    }
}

Событие “OnBeforeUrlGeneration”

Событие “OnBeforeUrlGeneration” вызывается перед добавлением url-элемента в файл sitemap. Этим событием можно изменить содержимое url-элемента, либо исключить его из файла sitemap.

Получает параметры:

FIELDS - Массив с полями url-элемента. 

Возможные ключи массива: url, date, changefreq, priority, files.

Пример использования:

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler(
    'luxar.indexcontrol',
    "OnBeforeUrlGeneration",
    ['LuxarIndexcontrolEventes', 'handlerOnBeforeUrlGeneration']
);

class LuxarIndexcontrolEventes {
    public static function handlerOnBeforeUrlGeneration($event) {
        $arParam = $event->getParameters();

        $arUrl = $arParam['FIELDS'];

        if ($arUrl[‘url’] == ‘https://site.ru/#’) {
            /*
             * Модифицируем элемент
             */
            $arUrl[‘url’] = ‘https://site.ru/’;
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::SUCCESS,
               $arUrl)
            ;
            return $result;
        }
        if ($arUrl[‘url’] == ‘https://site.ru/personal/’) {
            /*
             * Убираем элемент из файла sitemap
             */
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::ERROR,
            );
            return $result;
        }
    }
}

События для раздела “Редиректы”

Событие “OnBeforeRedirect”

Событие “OnBeforeRedirect” вызывается редиректом на страницу из поля “Куда”. Позволяет изменить параметры редиректа, либо отменить сам редирект.

Получает параметры:

FIELDS - Массив с полями редиректа. 

Пример использования:

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler(
    'luxar.indexcontrol',
    "OnBeforeRedirect",
    ['LuxarIndexcontrolEventes', 'handlerOnBeforeRedirect']
);

class LuxarIndexcontrolEventes {
    public static function handlerOnBeforeRedirect($event) {
        $arParam = $event->getParameters();

        $arRedirect = $arParam['FIELDS'];

        if ($arRedirect[‘TO’] == ‘/about/) {
            /*
             * Модифицируем элемент
             */
            $arRedirect[‘TO’] = ‘/o-kompanii/’;
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::SUCCESS,
               $arUrl)
            ;
            return $result;
        }
        if ($GLOBALS[‘USER’]->IsAdmin()) {
            /*
             * Отменяем редирект для администраторов сайта
             */
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::ERROR,
            );
            return $result;
        }
    }
}

События для раздела “SEO-свойства страниц”

Событие “OnBeforeApplySeoTags”

Событие “OnBeforeApplySeoTags” вызывается перед применением к странице SEO-свойств, указанных в настройках для текущей страницы.

Получает параметры:

FIELDS - Массив с полями SEO-свойств страницы. 

Пример использования:

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler(
    'luxar.indexcontrol',
    "OnBeforeApplySeoTags",
    ['LuxarIndexcontrolEventes', 'handlerOnBeforeApplySeoTags']
);

class LuxarIndexcontrolEventes {
    public static function handlerOnBeforeApplySeoTags($event) {
        $arParam = $event->getParameters();

        $arFields = $arParam['FIELDS'];

        if ($arFields[‘PAGE’] == ‘/about/) {
            /*
             * Изменяем title страницы
             */
            $arFields[‘TITLE’].= ‘ - О компании’;
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::SUCCESS,
               $arUrl)
            ;
            return $result;
        }
        if ($arFields[‘SITE_ID’] == ‘s2’) {
            /*
             * Отменяем SEO-тэги для сайта s2
             */
            $result = new \Bitrix\Main\EventResult(
               \Bitrix\Main\EventResult::ERROR,
            );
            return $result;
        }
    }
}