Общие настройки
Все настройки интуитивно понятны из названия. Вот некоторые, которые требуют пояснения:
Значение атрибута prefix тега HTML
Эта настройка добавляет в тег HTML вашей страницы заданные атрибуты, итоговый тег будет выглядеть примерно так:
Это требуется для валидности разметки. Если вы добавляете кастомные теги со своим префиксом, то этот префикс должен присутствовать в этой строке.
Формировать дополнительную разметку для изображений (ширина, высота, тип)
Если включено, то для каждого изображения разметки будут сформированы теги (со своими параметрами content):
Спецификация их наличия не требует. Включение на ваше усмотрение.
Маски страниц, для которых не нужна разметка Open Graph
Здесь вы указываете маски страниц по аналогии с отрицательными масками страниц виджетов. На этих страницах не будет генерироваться разметка Open Graph. Например, это не нужно для всяческих форм редактирования, админки и т.п.
Автоматическая генерация изображений и пресеты
Компонент может генерировать изображения с текстом текущей страницы. Для этого есть пресеты, которые можно создать в админке компонента. Пресеты назначаются в настройках типов контента и в общих настройках компонента (по умолчанию).
Для каждого пресета можно задать цвета всех элементов, изображение подложки, ватермарк, указать позиции элементов. Отдельно стоит описать опции «Макет» и «Шрифт».
Макеты
Макеты — это PHP класс в директории system/controllers/opengraph/libs/og/Layout/Layouts. В нём описывается основная логика, как будут расположены элементы на изображении. Если вам нужна своя кастомизация, создайте свой класс по аналогии с существующим (требуются знания PHP). В большинстве случаев достаточно тех макетов, что есть в комплекте.
Шрифты
Логика так же описана в PHP классах в директории system/controllers/opengraph/libs/og/Theme/Fonts. Это максимальной простой класс, где описывается путь к файлам шрифта. Вы также можете добавить свой шрифт, создав свой класс по аналогии с существующими. Сами шрифты лежат в директории /system/controllers/opengraph/libs/resources/fonts/Шрифт/static/Шрифт-Стиль.ttf
Настройки в типах контента
В настройках типов контента после установки компонента появляется блок «Open Graph». По умолчанию разметка выключена. Включите так, где необходимо.
Опция Как формировать изображения даёт возможность выбрать тип вывода изображений. Если выбрана генерация из пресетов, то будет сгенерировано одно изображение согласно пресету, выбранному ниже. Если выбрано на основе изображений записей, то вы сможете выбрать поля с изображениями и их пресеты. Поддерживается вывод более одного изображения и выбор изображения, если в записи изображения нет.
В опциях также можно заполнить SEO паттерны для текста. Если они заполнены, то будут иметь больший приоритет над системными паттернами.
Вы можете задавать Дополнительные поля разметки для записей. Нажмите «Добавить поле» и заполните Название поля и Заданное значение. Название, согласно спецификации OpenGraphProtocol или рекомендаций Яндекс. В значениии используйте поля записи, вставляя их названия в фигурных скобках. Например, {title}, {category} и т.п. Можно использовать обработку значений, подробнее в документации. Доступно ключевое выражение {host}, которое будет заменено на текущий хост сайта с префиксом протокола, например {host}video/embed/{id} будет заменен на https ://site.ru/video/embed/123.