Open Graph - быстро, легко и автоматически
От: Dev2Fun
Бесплатно
Дата публикации:
06.11.2016
Число установок:
Более 1000 раз
Дата обновления:
18.06.2026
Включает в себя:
Модуль, Переводы
Последняя версия:
1.4.3
Модуль позволяет автоматизировать и удобно управлять протоколом
Если у вас истекла лицензия Битрикса, то можете скачать модуль с .
Что делает модуль:
Модуль автоматически добавляет:
Кому пригодится:
Подойдет всем.
Если возникнет сложность в настройке, мы вам поможем!
Как пользоваться:
Порядок применения алгоритмов - вы можете указать какой порядок присваивания данных для вас является наиболее приемлемым.
По умолчанию порядок таков:
Картинка по умолчанию - указывается в админке. Выводится при отсутствии картинки в свойства og:image.
Страницы исключений - пути до страниц от корня сайта, на которых мета-данные Open Graph выводиться не должны. Указывать со всеми расширениями, без GET-параметров. Если нужно исключить главную страницу сайта, то прописываем index.
Обозначение свойств в админке у элементов и разделов - на странице редактирования элементов тебе можно заполнять Open Graph поля. (Вкладка "Настройки Open Graph")
og:title: Если не задан, то подставится значение из "Названия элемента" (NAME).
og:description: Если не задан, то подставится значение из "Краткое описание" (PREVIEW_TEXT), если оно путо, то значение из "Детальное описание" (DETAIL_TEXT). Внимание: Автоматическое ограничение кол-ва символов в 121 символ.
og:image: Если у вас указана активность параметра og:image и вы не укажите картинку для og:image, то по умолчанию подставится картинка из PREVIEW_PICTURE, если она не указана, то подставится картинка из DETAIL_PICTURE.
Свойства, которые не доступны для пользовательского редактирования:
Как вывести OpenGraph у элементов (точная интеграция):
Вам необходимо прописать в result_modifier.php шаблона используемого компонента следующее:
Как вывести OpenGraph у разделов (точная интеграция):
Вам необходимо прописать в result_modifier.php шаблона используемого компонента следующее:
И обязательно сбросить кэш.
Поддержка установки Open Graph свойств с помощью SetPageProperty, SetDirProperty оставлена, но с пониженным приоритетом.
Логика: (данные записываются только если значение пусто)
Если возникнет сложность в настройке, мы вам поможем!
Если есть нарекания или предложения по улучшению модуля пишите на почту техподдержки.
Если у вас истекла лицензия Битрикса, то можете скачать модуль с .
Что делает модуль:
Модуль автоматически добавляет:
- og:title - из title страницы
- og:description - из description страницы
- og:url - текущая страница
- og:site_name - название сайта
- og:image - картинка из текущего элемента или раздела
- og:image:type - mime-type картинки
- og:image:width - ширина картинки
- og:image:height - высота картинки
- og:image:secure_url - ссылка при https
- любое другое свойство вам нужно указать в настройках
- Выводит у элементов и разделов Open Graph поля, для заполнения.
- Позволяет задать общую картинку для Open Graph.
- Кэширует данные, тем самым не нагружая сайт лишними запросами.
- Позволяет добавить страницы-исключения.
- Автоматически определяет og:image
- Позволяет задать максимальный размер для og:image и ресайзить картинки "на лету"
- Позволяет задать порядок применения алгоритмов присваивания значений в Open Graph
- Позволяет легко настроить Open Graph
- время жизни кэша
- страницы исключений
- вывод таба с Open Graph полями в элементах
- вывод таба с Open Graph полями в разделах
- установка картинки, по умолчанию
Кому пригодится:
Подойдет всем.
Если возникнет сложность в настройке, мы вам поможем!
Как пользоваться:
Порядок применения алгоритмов - вы можете указать какой порядок присваивания данных для вас является наиболее приемлемым.
По умолчанию порядок таков:
- og_fields (Данные из полей OpenGraph элементов/разделов) - поиск значений в полях во вкладке OpenGraph у элементов и разделов
- iblock_fields (Данные из полей элементов/разделов) - пустые значения заполняются данными из полей iblock у элементов и разделов
- prop_fields (Данные из SetPageProperty/SetDirProperty) - пустые значения заполняются данными из указанных свойствах страниц (SetPageProperty или SetDirProperty)
- default (Данные из алгоритма "по умолчанию") - оставшиеся пустые значения заполняются данными по старому алгоритму
Картинка по умолчанию - указывается в админке. Выводится при отсутствии картинки в свойства og:image.
Страницы исключений - пути до страниц от корня сайта, на которых мета-данные Open Graph выводиться не должны. Указывать со всеми расширениями, без GET-параметров. Если нужно исключить главную страницу сайта, то прописываем index.
Обозначение свойств в админке у элементов и разделов - на странице редактирования элементов тебе можно заполнять Open Graph поля. (Вкладка "Настройки Open Graph")
og:title: Если не задан, то подставится значение из "Названия элемента" (NAME).
og:description: Если не задан, то подставится значение из "Краткое описание" (PREVIEW_TEXT), если оно путо, то значение из "Детальное описание" (DETAIL_TEXT). Внимание: Автоматическое ограничение кол-ва символов в 121 символ.
og:image: Если у вас указана активность параметра 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
Как вывести OpenGraph у элементов (точная интеграция):
Вам необходимо прописать в result_modifier.php шаблона используемого компонента следующее:
// подгружаем все модуль и все его классы
\Bitrix\Main\Loader::includeModule('dev2fun.opengraph');
\Dev2fun\Module\OpenGraph::Show($arResult['ID'],'element');
// где arResult['ID'] - идентификатор элемента
// где element - тип, т.к. мы выводим для элемента, поэтому element |
Как вывести OpenGraph у разделов (точная интеграция):
Вам необходимо прописать в result_modifier.php шаблона используемого компонента следующее:
// подгружаем все модуль и все его классы
\Bitrix\Main\Loader::includeModule('dev2fun.opengraph');
\Dev2fun\Module\OpenGraph::Show($arResult['ID'],'section');
// где arResult['ID'] - идентификатор раздела
// где section - тип, т.к. мы выводим для раздела, поэтому section |
И обязательно сбросить кэш.
Поддержка установки Open Graph свойств с помощью SetPageProperty, SetDirProperty оставлена, но с пониженным приоритетом.
Логика: (данные записываются только если значение пусто)
- поиск данных в элементах/разделах
- поиск данных в SetPageProperty, SetDirProperty
- установка данных из значений по умолчанию
- заворачивание данных в мета-теги
- вывод мета-тегов
| название события | передаваемые переменные | описание |
| OnBeforeAddOpenGraph | &$arSettings - массив настроек &$cache_id - идентификатор кэша | Событие запускается перед запуском всех алгоритмов |
| OnAfterAddOgFields | &ogValues - массив полей со значениями | Событие запускается после алгоритма og_fields |
| OnAfterAddIBlockFields | &ogValues - массив полей со значениями | Событие запускается после алгоритма iblock_fields |
| OnAfterAddPropFields | &ogValues - массив полей со значениями | Событие запускается после алгоритма prop_fields |
| OnAfterAdd | &ogValues - массив полей со значениями | Событие запускается после всех алгоритмов |
| OnBeforeOutput | &$arData - массив полей со значениями | Событие запускается перед выводом свойств (не кэшируется!) |
Если возникнет сложность в настройке, мы вам поможем!
Если есть нарекания или предложения по улучшению модуля пишите на почту техподдержки.
Характеристики
|
Дата публикации
|
06.11.2016 |
|
Число установок
|
Более 1000 раз |
|
Дата обновления
|
18.06.2026 |
|
Включает в себя
|
Модуль Переводы |
|
Последняя версия
|
1.4.3 |
|
Адаптивность
|
Да |
|
Поддержка композита
|
Да |
|
Совместимо с Сайты24
|
Нет |
|
Подходящие редакции 1С-Битрикс
|
3373 3380 3381 3382 3383 3384 3442 3443 |
|
Наличие демо-режима
|
Да |
|
Продолжительность демо-периода
|
Нет |
- - улучшение поддержки php8.0
- - добавлена поддержка php8.0
- - улучшена обрезка строки для og:description
- улучшено сохранение картинки "по умолчанию" - - в алгоритм "по-умолчанию" добавлен функционал поиска картинки для og:image у элементов и разделов
- поправлено несколько не значительных багов
- улучшена производительность - - Улучшена обработка полей
- - Улучшена проверка на протокол в setPropertyPropFields
- - Добавлена поддержка og:image:secure_url
- Добавлена возможность отключать вывод Open Graph полей для разделов/элементов
- Добавлена возможность проброса CACHE_TIME в ключе options
\Dev2fun\Module\OpenGraph::Show( $arResult['ID'], // идентификатор элемента 'element', // тип element или section [ 'options' => [ // точечные настройки 'CACHE_TIME' => 360000 ], 'default' => [ // точечные значения Open Graph полей 'og:title' => 'Кастомный title' ], 'ogOnProperty' => [], // кастомизация значений в алгоритмах (PRO) ] ); - - В тег добавлено закрытие
- - В og:url добавленна поддержка мультидомменов
- - Исправлен баг в алгоритме "SetPageProperty/SetDirProperty" с og:description
- - Улучшено слияние основных полей с дополнительными
- - Исправлен баг с site_name в алгоритме default
- - Исправлен баг с сохранением картинки при выборе из структуры
- Исправлен баг с кодировкой в названии блок с дополнительными полями
- Улучшена загрузка картинки по умолчанию - - Исправлен баг с сохранением картинки по умолчанию и картинки в полях. Баг был на некоторых серверах
- Добавлен функционал поддержки любых кастомных полей OpenGraph (добавляются, как "Дополнительные поля")
- Убрано кеширование при 404 и также убрано кэширование при статусах 4xx/3xx
- Добавлена кнопка сброса кэша полей OpenGraph для всех страниц
- Добавлен функционал постраничного обновления кэша. Работает от администратора при GET clear_cache=Y
- Добавлено свойство позволяющее вкл/выкл автоматическое заполнение полей
- В 3-ий параметр ($params) метода ```OpenGraph::Show($refId, $type = 'element', $params = [])``` добавлен ключ 'default', c помощью которого вы можете передать значения по умолчанию
Огромное спасибо всем за рекомендации и сообщения о проблемах/неудобствах. - - улучшено кэширование
- добавлено свойство позволяющее удалять из og:url index.php|index|index.html - - улучшена работа с кэшем. добавлена поддержка мультидоменов
- в событие OnBeforeAddOpenGraph добавлен 3-ий параметр &$cachePath - - исправлен баг не подключения языкового файла в табах
- - исправлен баг при котором картинка по умолчанию не удалялась
- теперь в og:description очищаются все переходы на новую строку - - исправлен баг с сохранением настройки "Добавить OG в элементах"
- исправлен баг с сохранением настройки "Добавить OG в разделах" - - исправлен баг с поломкой валидности верски, при использовании кавычек "'
- - исправлена ошибка при установки картинки по умолчанию
- - исправлены ошибки при работе c default og:image
- - Добавлен функционал исключения по регулярному выражения
- Поправлен баг с выводом ссылки картинки, при использовании CDN - - Техническое обновление
- - Улучшена обработка og:description
- - Исправлен баг с не копированием js и css
- Добавлена проверка и исправление событий
- Переделана логика установки OpenGraph значений и вывод их
- Исправлен баг в выводе DETAIL_PICTURE или PREVIEW_PICTURE у элементов
- В OpenGraph::Show добавлен 3-ий (необязательный) параметр $params, с поддержкой ключа ogOnProperty
- Добавлено событие OnBeforeAddOpenGraph - параметры &$arSettings, &$cache_id
- Добавлено событие OnAfterAddOgFields - параметр &$ogValues, после og_fields
- Добавлено событие OnAfterAddIBlockFields - параметр &$ogValues, после iblock_fields
- Добавлено событие OnAfterAddPropFields - параметр &$ogValues, после prop_fields
- Добавлено событие OnAfterAddDefault - параметр &$ogValues, после default
- Добавлено событие OnAfterAdd - параметр &$ogValues, после всех
- Добавлено событие OnBeforeOutput - параметр &$arData, перед отправкой на вывод
- - Исправлен warning у key_exists
- Добавлен авторесайз og:image
- Добавлены настройки авторесайза og:image
- Введены 4 основных алгоритма: og_fields, iblock_fields, prop_fields, default
- Добавлена возможность пользовательской сортировки алгоритма, при присваивании значений в OpenGraph(beta)
- Добавлен алгоритм вывода title, pictures, description для iblock элементов/разделов, даже если у этих элементов/разделов не заполнены поля OpenGraph
- Добавлен вывод DETAIL_PICTURE для разделов
- Теперь ключ кэша всегда равен странице вывода
- - Добавлен фукнционал страниц исключений вывода OpenGraph
- Добавлен вывод таба с OpenGraph полями в элементах ИБ
- Добавлен вывод таба с OpenGraph полями в разделах ИБ
- Добавлены новые настройки
- Добавлена загрузка картинки для OpenGraph, по умолчанию
- Добавлен метод `\Dev2fun\Module\OpenGraph::Show($refId,$type);`
- Переписан инсталлятор и деинсталлер
- Закончена поддержка версий php младше 5.4
- Улучшено кэширование
- Добавлено несколько значительных нюансов, читайте их на странице модуля в макркетплейсе
- - улучшена поддержка старых версий php
- - улучшена поддержка http/https
- улучшена поддержка url сервера
- обнаружен и исправлен баг с og:image
- исправлен баг с og:image:type
- исправлен баг http/https у og:image:type
- исправлен баг с og:image:width
- исправлен баг с og:image:height
- исправлен баг в админке с name
- - улучшена поддержка старых версий php
- - Добавлено исправление двойных кавычек на одинарные у og:site_name
- Добавлена поддержка https у og:url и og:image
- Исправлен баг с og:description. Теперь og:description, по умолчанию равен $APPLICATION->GetProperty('description')
- У og:image добавлена поддержка пути от корня сайта
- Поправлен баг у og:image:height
- Админка: добавлен функционал настроек
- Админка: Добавлена настройка времени жизни кэша - - обновлено название и описание