Русский English Український

    Edit

    OpenGraphTags

    OpenGraphTags: Виведення OG-тегів для статті

    Сніпет виведення OG-тегів для статті у Evolution CMS.

    Автор: Aharito

    Параметри:

    tplList

    список шаблонів через кому, ОБОВ'ЯЗКОВИЙ!!

    locale

    string за замовчуванням "ru_RU"

    site_name

    string за замовчуванням [(site_name)]

    flag

    string, ім'я ТВ-параметра-прапора (чекбокс, ним можна увімкнути/вимкнути виведення OG-тегів для статті, навіть якщо її шаблон у списку $tplList). За замовчуванням 1 (увімкнено).

    thumbSnippet

    string - сніппет для превьюшек як у SG та FastImage. Наприклад, "sgThumb" або "phpthumb". За промовчанням пусто.

    thumbOptions

    string - опції превьюшки, задані як у SG або FastImageTV або phpthumb. За промовчанням пусто.

    NOTE: Для роботи сніпета повинні бути створені наступні ТВ-параметри:

    • og_on_off - ТВ-параметр-прапор (чекбокс, ним можна включити/відключити виведення OG-тегів для статті, навіть якщо її шаблон є у списку $tplList)< /li>
    • og_title - заголовок для соцмереж, якщо не заданий, соцмережі найчастіше беруть Title.
    • og_description - опис для соцмереж, не більше 137 символів за моїми експериментами
    • og_image - картинка для соцмереж, якщо не задана, соцмережі шукають картинки в контенті

    Приклад виклику сніппета:

    [[OpenGraphTags? &tplList=`31,32` &site_name=`[(cfg_company_brand_name)]` &thumbSnippet=`sgThumb` &thumbOptions=`840x420`]]

    Код сніпету:

    <?php
/**
 * OpenGraphTags
 * Виводить OG-теги лише для вказаних шаблонів.
 *
 * @category snippet
 * Це повинні бути тільки шаблони статей (og_type – жорстко прописаний як article)!!!
 * Виводить непусті значення тегів OpenGraph, зазначені в адмінці для посту
 *
 * @param $tplList - список шаблонів через кому, ОБОВ'ЯЗКОВИЙ!!
 * @param $locale, string, за замовчуванням "ru_RU"
 * @param $site_name, string, за замовчуванням [(site_name)]
 * @param $flag, string, ім'я ТВ-параметра-прапора (чекбокс, ним можна включити/вимкнути виведення OG-тегів для статті, навіть якщо її шаблон у списку $tplList). За замовчуванням 1 (увімк.).
 *
 * @param &thumbSnippet, string - сниппет для превьюшек як у SG та FastImage. Наприклад, "sgThumb" або "phpthumb". За промовчанням порожньо.
 * @param &thumbOptions, string - опції превьюшки, задані як у SG або FastImageTV або phpthumb. За промовчанням порожньо.
 *
 * @NOTE: Для роботи сніпету повинні бути створені наступні ТВ-параметри:
 * og_on_off - ТВ-параметр-прапор (чекбокс, ним можна включити/вимкнути висновок OG-тегів для статті, навіть якщо її шаблон є у списку $tplList)
 * og_title - заголовок для соцмереж, якщо не заданий, соцмережі найчастіше беруть Title.
 * og_description - опис для соцмереж, не більше 137 символів за моїми експериментами
 * og_image - картинка для соцмереж, якщо не задана, соцмережі шукають картинки в контенті
 *
 *
 * @internal @category SMO
 *
 * @version 0.2
 * @author Aharito http://aharito.ru
 *
 *
 * @example [[OpenGraphTags? &tplList=`31,32` &site_name=`[(cfg_company_brand_name)]` &thumbSnippet=`sgThumb` &thumbOptions=`840x420`]]
**/

$out = '';

$tplList = str_replace(" ", "", $tplList); //Прибираємо можливі зайві прогалини між ID шаблонів у списку
$_tplList = explode(",", $tplList);

$docObject = $modx->documentObject;

if ( in_array($docObject['template'], $_tplList) && $docObject['og_on_off'][1] ) { // Якщо шаблон у списку $tplList, і якщо прапор "увімкнено"

// Ці параметри задані один раз при викликі сніпету OpenGraphTags
$site_name = isset($site_name)? $site_name : $modx->getConfig('site_name');
$locale = isset($locale)? $locale: "ru_RU";

// Ці параметри задаються під час редагування кожної статті
// Якщо вони не задані, то для них 100% дефолтні значення, вони і виводяться
$title = !empty($docObject["og_title"][1]) ? $docObject["og_title"][1] : $docObject["pagetitle"];
$url = $modx->makeUrl($docObject["id"], '', '', 'full'); // Була нагода редагувати УРЛ, але я прибрав за непотрібністю

// Ці параметри задаються під час редагування кожної статті
// Для них немає 100% дефолтних значень, тому якщо вони не задані, то взагалі не виводимо відповідний метатег
$desc = !empty($docObject["og_description"][1]) ? $docObject["og_description"][1] : $modx->runSnippet('summary', array('text' => $docObject['content'], 'len' => '50'));
$descTPL = !empty($desc)? '<meta property="og:description" content="' .$desc. '">' : '';

$imgTPL = !empty($docObject["og_image"][1]) ? '<meta property="og:image" content="' .(isset($thumbSnippet) ? $modx->runSnippet($thumbSnippet, array("input" => $docObject["og_image"][1], "options"=>$thumbOptions)) : $docObject["og_image"][1]).'">' : '';

$out .= '';
$out .= PHP_EOL."\t".'';
$out .= PHP_EOL."\t".'';
$out .= PHP_EOL."\t".'';
$out .=$descTPL? PHP_EOL."\t".$descTPL : '';
$out .=$imgTPL? PHP_EOL."\t".$imgTPL : '';
$out .= PHP_EOL."\t".'';
}

return $out;