OctoberCMS. Скрытый компонент «Ресурсы»

Введение

В OctoberCMS ресуры (CSS и JS файлы) на страницу или в шаблон (layout) добавляются с использованием методов контроллера addCss() и addJs(), которые следует размещать в хуке жизненного цикла onStart(), например:

public function onStart()
{
    $this->addCss(['assets/css/hello.css', 'assets/css/goodbye.css']);
    $this->addJs(['assets/js/app.js', 'assets/js/nav.js']);
}

Однако существует альтернативный декларативный способ добавления ресурсов на страницы.

Компонент «Ресурсы»

Предназначен для простого добавления ресурсов на страницу. Непосредственно компонент \modules\cms\components\Resources.php является одним из 3 встроенных компонентов CMS и наряду с компонентом ViewBag скрыт по-умолчанию в аминистративном интерфейсе CMS и добавляется через текстовый редактор.

Компонент предоставляет четыре массива js[], css[], less[] и sass[] для ресурсов + массив vars[] для создания пар переменная-значение. Поиск файлов осуществляется внутри каталога assets активной темы в соответствующих подпапках (assets\js, assets\css, assets\less и assets\sass.

Пример добавления CSS файла <site>\themes\<theme_name>\assets\css\pages\maintenance.css на страницу:

[resources]
css[] = "pages/maintenance.css"

Другой пример: на страницу добавляется OctoberCMS framework и 2 js файла.

[resources]
js[] = "../vendor/masonry-layout/dist/masonry.pkgd.min.js"
js[] = "pages/blog.js"
js[] = "../../../../modules/system/assets/js/framework.js"
js[] = "../../../../modules/system/assets/js/framework.extras.js"
css[] = "../../../../modules/system/assets/css/framework.extras.css"

После добавления компонента через текстовый редактор, он становится доступен для редактирования в административном интерфейсе.

// «Под капотом» содержимое отправляется в комбайн CombineAssets::combine для объединения.

Другие записи из подборки «OctoberCMS. Backend.»

Похожие записи

Как в OctoberCMS сделать простейшую переадресацию с одной страницы на другую?

Создаём страницу (Page), задаем URL и в секции код добавляем обработчик на хук жизненного цикла страницы. В данном случае это onStart, которая выполняется перед началом загрузки страницы.

function onStart()
{
    return Redirect::to('http://tyapk.ru');
}

OctoberCMS и HTTPS

Настройка конфигурационного файла cms.php для создания https ссылок.