Конфигурация темы¶
В Grav можно легко получить доступ к конфигурации темы и информации из схемы из файлов Twig и PHP.
Доступ к информации из схемы темы¶
Информацию из файла blueprints.yaml активной темы можно получить из объекта theme. Используем следующий файл blueprints.yaml как пример:
Любой из этих пунктов можно получить через grav.theme, используя стандартный синтаксис с точками:
Те же значения можно получить из плагина Grav с помощью синтаксиса PHP:
Доступ к конфигурации темы¶
У тем тоже есть файлы конфигурации. Файл конфигурации темы называется <themename>.yaml. Файл по умолчанию находится в корневой папке темы (user/themes/<themename>).
Настоятельно рекомендуется не менять YAML-файл темы по умолчанию, а переопределять настройки в папке user/config/themes. Так исходные настройки темы останутся нетронутыми, и вы сможете быстро получить доступ к изменениям и/или откатить их при необходимости.
Для примера рассмотрим тему Antimatter. По умолчанию в корневой папке темы есть файл antimatter.yaml. Его содержимое выглядит так:
Это простой файл, но он даёт представление о том, что можно делать с настройками темы. Давайте переопределим эти настройки и добавим новую.
Создайте файл user/config/themes/antimatter.yaml со следующим содержимым:
Замечу, что
enabledздесь не повторяется. Если файлы конфигурации объединяются, а не просто заменяются, это следует явно указать.
Затем в шаблонах темы эти переменные можно получить через объект grav.theme.config:
Это должно отрендериться так:
Grav is awesome!
В PHP текущую конфигурацию темы можно получить так:
Просто! В конфигурации тем вас ограничивает только небо. Вы можете использовать её как угодно! :)
Альтернативная запись¶
Следующие псевдонимы тоже работают:
Хотя grav.themes.<themename> поддерживается, этого следует избегать, потому что это делает невозможным правильное наследование темы.