Перейти к содержанию

Конфигурация темы

В Grav можно легко получить доступ к конфигурации темы и информации из схемы из файлов Twig и PHP.

Доступ к информации из схемы темы

Информацию из файла blueprints.yaml активной темы можно получить из объекта theme. Используем следующий файл blueprints.yaml как пример:

name: Antimatter
slug: antimatter
type: theme
version: 1.7.0
description: "Antimatter is the default theme included with **Grav**"
icon: empire
author:
  name: Team Grav
  email: devs@getgrav.org
  url: https://getgrav.org
homepage: https://github.com/getgrav/grav-theme-antimatter
demo: http://demo.getgrav.org/blog-skeleton
keywords: antimatter, theme, core, modern, fast, responsive, html5, css3
bugs: https://github.com/getgrav/grav-theme-antimatter/issues
license: MIT

Любой из этих пунктов можно получить через grav.theme, используя стандартный синтаксис с точками:

Author Email: {{ grav.theme.author.email }}
Theme License: {{ grav.theme.license }}

Те же значения можно получить из плагина Grav с помощью синтаксиса PHP:

$theme_author_email = $this->grav['theme']['author']['email'];
$theme_license = $this->grav['theme']['license'];

Доступ к конфигурации темы

У тем тоже есть файлы конфигурации. Файл конфигурации темы называется <themename>.yaml. Файл по умолчанию находится в корневой папке темы (user/themes/<themename>).

Настоятельно рекомендуется не менять YAML-файл темы по умолчанию, а переопределять настройки в папке user/config/themes. Так исходные настройки темы останутся нетронутыми, и вы сможете быстро получить доступ к изменениям и/или откатить их при необходимости.

Для примера рассмотрим тему Antimatter. По умолчанию в корневой папке темы есть файл antimatter.yaml. Его содержимое выглядит так:

enabled: true
color: blue

Это простой файл, но он даёт представление о том, что можно делать с настройками темы. Давайте переопределим эти настройки и добавим новую.

Создайте файл user/config/themes/antimatter.yaml со следующим содержимым:

Замечу, что enabled здесь не повторяется. Если файлы конфигурации объединяются, а не просто заменяются, это следует явно указать.

color: red
info: Grav is awesome!

Затем в шаблонах темы эти переменные можно получить через объект grav.theme.config:

<h1 style="color:{{ grav.theme.config.color|e }}">{{ grav.theme.config.info|e }}</h1>

Это должно отрендериться так:

Grav is awesome!

В PHP текущую конфигурацию темы можно получить так:

$color = $this->grav['theme']->config()['color'];
$info = $this->grav['theme']->config()['info'];

Просто! В конфигурации тем вас ограничивает только небо. Вы можете использовать её как угодно! :)

Альтернативная запись

Следующие псевдонимы тоже работают:

1
2
3
4
5
Theme Color Option: {{ config.theme.color_option|e }}
   or
Theme Color Option: {{ theme_var(color_option)|e }}
   or
Theme Color Option: {{ grav.themes.antimatter.color_option|e }} [AVOID!]

Хотя grav.themes.<themename> поддерживается, этого следует избегать, потому что это делает невозможным правильное наследование темы.