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

Модуль который добавляет поддержку протокола Open Graph для 1С-Битрикс.

Что делает модуль

Модуль автоматически добавляет:

og:title - из title страницы
og:description - из description страницы
og:url - текущая страница
og:site_name - название сайта любое другое свойство вам нужно указать в настройках

Также модуль:

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

Присутствуют настройки

время жизни кэша
страницы исключений
порядок применения алгоритмов
вывод таба с Open Graph полями в элементах
вывод таба с Open Graph полями в разделах
установка картинки, по умолчанию
включение/выключение авторесайза
установка ресайза ширины и высоты изображения
установка алгоритма для ресайза

Внимание! Чтобы увидеть изменения нужно сбрасывать кэш

Как пользоваться

Добавляем нужные нам og поля. Все параметры берутся с офсайта OpenGraph;
Добавляем страницы исключения;
Выбираем нужную сортировку алгоритмов;
Чтобы увидеть изменения, нужно сбрасывать кэш.

Как добавить og:image

Добавляем поддержку "og:image" в настройках модуля и сохраняем;
Указываем картинку "по умолчанию";
Включаем ресайз и указываем размер (рекомендуем ширину 1024, а высоту 99999);
По умолчанию картинка берется из текущего элемента или раздела, но вы также можете указать её в коде (ниже). У статичных страниц картинку надо указать в коде, иначе будет взята картинка "по умолчанию"

Порядок применения алгоритмов

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

По умолчанию порядок таков:

og_fields (Данные из полей OpenGraph элементов/разделов) - поиск значений в полях во вкладке OpenGraph у элементов и разделов
iblock_fields (Данные из полей элементов/разделов) - пустые значения заполняются данными из полей iblock у элементов и разделов
prop_fields (Данные из SetPageProperty/SetDirProperty) - пустые значения заполняются данными из указанных свойствах страниц (SetPageProperty или SetDirProperty)
default (Данные из алгоритма "по умолчанию") - оставшиеся пустые значения заполняются данными по старому алгоритму

Уменьшение размеров (resize)

Уменьшение размеров (resize) - вы можете включить автоматическое уменьшение размеров картинок. Также вы можете указать максимальную ширину/высоту и выбрать 1 из 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.

Свойства, которые не доступны для пользовательского редактирования:

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 у разделов: