Open Graph - быстро, легко и автоматически

Что умеет решение

Модуль автоматизирует настройку и управление протоколом Open Graph. Он автоматически заполняет основные мета-теги: og:title и og:description берутся из соответствующих полей страницы, og:url указывает на текущий адрес, og:site_name — на название сайта. Для og:image модуль выбирает изображение из текущего элемента или раздела, определяет его тип, размеры и формирует защищённую ссылку при использовании HTTPS. Остальные свойства настраиваются вручную.

Модуль добавляет поля для ввода данных Open Graph в административной панели элементов и разделов. Можно установить изображение по умолчанию для всего сайта. Данные кэшируются для снижения нагрузки на сервер. Поддерживается создание списка страниц-исключений. Алгоритм выбора изображения для og:image работает автоматически, при этом можно задать максимальный размер и выполнить ресайз изображения в реальном времени. Доступна настройка приоритета алгоритмов присвоения значений. В настройках доступны параметры времени жизни кэша, управления исключениями и отображения вкладки с полями Open Graph.

Модуль Open Graph от Dev2Fun обеспечивает автоматический вывод мета-данных для соцсетей и поисковых систем. В интерфейсе управления разделами добавлена вкладка с полями Open Graph для удобной настройки изображений и текстовых параметров. Пользователь может гибко конфигурировать параметры, включая дополнительные поля, соответствующие официальной спецификации.

Механизм формирования данных работает по иерархическому принципу, который можно настраивать. По умолчанию приоритет имеет заполнение из полей Open Graph в элементах и разделах. Если значения отсутствуют, система подставляет данные из полей инфоблока. Далее заполняются пустые поля значениями из свойств страницы (SetPageProperty или SetDirProperty). Оставшиеся незаполненными параметры берутся по старому алгоритму по умолчанию.

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

Модуль Open Graph автоматически генерирует мета-данные для социальных сетей. Если в свойстве og:image нет изображения, используется картинка, заданная в настройках административной панели.

Для исключения страниц из генерации мета-данных укажите их пути от корня сайта. Путь должен включать расширение и не содержать GET-параметров. Чтобы исключить главную страницу, укажите index.

Настройка свойств выполняется на странице редактирования элементов и разделов во вкладке «Настройки Open Graph».

Логика заполнения полей:

- og:title: Если поле не заполнено, подставляется значение из «Названия элемента» (NAME).

- og:description: При отсутствии данных используется «Краткое описание» (PREVIEW_TEXT). Если оно пусто, берется «Детальное описание» (DETAIL_TEXT). Длина описания автоматически ограничивается 121 символом.

- og:image: При активации параметра og:image и отсутствии ручной картинки система подставляет изображение из PREVIEW_PICTURE. Если оно отсутствует, используется DETAIL_PICTURE.

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

og:url

og:site_name

og:image:type

og:image:width

og:image:height

og:image:secure_url

Остальные свойства настраиваются в параметрах компонента и выводятся автоматически.

Для точной интеграции Open Graph в элементы необходимо добавить код в файл result_modifier.php шаблона используемого компонента.

Для точной интеграции Open Graph в разделы также требуется внесение кода в файл result_modifier.php шаблона компонента.

После внесения изменений обязательно очистите кэш.

Поддержка установки свойств Open Graph через функции SetPageProperty и SetDirProperty сохранена, но имеет пониженный приоритет.

Алгоритм работы модуля (данные записываются только при отсутствии существующего значения):

1. Поиск данных в элементах или разделах.

2. Поиск данных в SetPageProperty и SetDirProperty.

3. Установка данных из значений по умолчанию.

4. Формирование мета-тегов.

5. Вывод сформированных мета-тегов.

Доступные события:

OnBeforeAddOpenGraph

Переменные: &$arSettings (массив настроек), &$cache_id (идентификатор кэша).

Описание: Срабатывает перед запуском всех алгоритмов формирования данных.

OnAfterAddOgFields

Переменные: &ogValues (массив полей со значениями).

Описание: Срабатывает после выполнения алгоритма обработки полей og_fields.

OnAfterAddIBlockFields

Переменные: &ogValues (массив полей со значениями).

Описание: Срабатывает после выполнения алгоритма обработки полей iblock_fields.

Модуль предоставляет события для автоматического формирования данных Open Graph.

Событие OnAfterAddPropFields с параметром ogValues срабатывает после обработки алгоритма prop_fields.

Событие OnAfterAdd с параметром ogValues выполняется после завершения всех алгоритмов.

Событие OnBeforeOutput с параметром $arData запускается непосредственно перед выводом свойств; это событие не кэшируется.

Для технической документации и обсуждения изменений доступен репозиторий на GitHub.

Если нужен «Open Graph - быстро, легко и автоматически», General iT может помочь с установкой, настройкой и технической проверкой модуля после подключения.