Описание

Плагин Tachyons для системы управления контентом GetSimple CMS позволяет пользователю автоматически подключать минифицированный CSS файл библиотеки Tachyons к любой используемой теме оформления веб-сайта.

Возможности

• удобство работы: подключение CSS файла библиотеки Tachyons выполняется автоматически и не требует от пользователя внесения изменений в файлы шаблонов оформления текущей темы оформления веб-сайта;
• гибкость использования: плагин Tachyons позволяет пользователю выбирать шаблоны и контролировать условия, при которых требуется подключение CSS файла библиотеки Tachyons.

Использование

После установки и активации плагина Tachyons в каждый шаблон темы оформления, в котором вызывается стандартная функция GetSimple CMS get_header(), будет автоматически подключаться файл tachyons.min.css – минифицированный CSS файл библиотеки Tachyons.

Важно! Подключаемая версия библиотеки зависит от используемой версии плагина Tachyons.

По умолчанию подключается CDN версия файла библиотеки Tachyons, однако при необходимости плагин позволяет переключиться на использование локальной версии. Выбор между CDN и локальной версией выполняется стандартным для GetSimple CMS способом — через задание значения константы GSNOCDN в файле gsconfig.php. Так для подключения локальной версии библиотеки следует задать постоянной GSNOCDN значение true.

define("GSNOCDN", true);

Если подключение библиотеки Tachyons для всех шаблонов оформления и страниц веб-сайта нежелательно, то плагин Tachyons предоставляет возможность подключения файла tachyons.min.css только для выбранных шаблонов. Для этого необходимо отключить глобальное использование библиотеки Tachyons, путём определения глобальной переменной $TACHYONS со значением false в файле gsconfig.php для настройки всего веб-сайта или в файле functions.php текущей темы оформления для настройки конкретной темы оформления.

$TACHYONS = false;

После глобального отключения автоматической работы плагина Tachyons для подключения файла tachyons.min.css в файле шаблона оформления должна быть вызвана функция tachyons_register().

<?php
  tachyons_register();
  get_header();
?>

Важно! Вызов функции tachyons_register() должен быть осуществлён раньше вызова функции get_header()! В противном случае файл tachyons.min.css подключен не будет.

Для динамического подключения библиотеки Tachyons, например, для определённых страниц веб-сайта, следует разместить требуемую логику в файле functions.php текущей темы оформления.

# массив, содержащий перечень страниц, для которых требуется включить плагин Tachyons
$slugs = array('page-1', 'page-2', 'page-3', 'page-4');
if (in_array(get_page_slug(false), $slugs)) {
  $TACHYONS = true;
}

Если требуется отключить работу плагина Tachyons только для определённых шаблонов оформления, не изменяя его глобальной настройки, следует в файле шаблона оформления вызвать функцию tachyons_deregister().

<?php
  tachyons_deregister();
  get_header();
?>

Важно! Вызов функции tachyons_deregister() должен быть осуществлён раньше вызова функции get_header()! В противном случае файл tachyons.min.css всё равно будет подключён.

Функция плагина Tachyons tachyons_deregister() является обёрткой для стандартной функции GetSimple CMS dequeue_style(). Поэтому для отключения работы плагина на уровне шаблона оформления может быть использован следующий код.

<?php
  dequeue_style('tachyons', GSFRONT);
  get_header();
?>

Логика для динамического отключения работы плагина Tachyons размещается в файле functions.php текущей темы оформления по аналогии с уже рассмотренным примером динамического включения работы плагина.

# массив, содержащий перечень страниц, для которых требуется отключить плагин Tachyons
$slugs = array('page-1', 'page-2', 'page-3', 'page-4');
if (in_array(get_page_slug(false), $slugs)) {
  $TACHYONS = false;
}

Работа плагина Tachyons протестирована с системой управления контентом GetSimple CMS 3.3.13 и, разрабатываемой на момент публикации, версией GetSimple CMS 3.4.x.