Темизация drupal: файлы шаблона и подтемы (Sub-theme)
05.09.2018
Здравствуйте, уважаемые читатели! Это третья и, пожалуй, заключительная статья в рамках базового курса, посвященная темам Drupal. В ней я расскажу о темизации Drupal , а если говорить по-русски, то о том, как устроены шаблоны. Эти знания помогут вам отредактировать внешний вид сайта по своему разумению и довести его до ума.
9.2. Создание темы Drupal 8 на основе Bootstrap. Настраиваем PhpStorm и LESS compiler
Все установленные в Drupal темы лежат в директории /sites/all/themes каждая в своей папке. Чаще всего в теме присутствуют следующие каталоги:
fonts — здесь лежат шрифты. images — каталог с картинками. js — файлы JavaScript: скрипты, позволяющие реализовать некоторые эффекты. Например, слайдер, выпадающее меню и так далее. templates — папка с шаблонами. О них поговорим более подробнее чуть ниже. css — дополнительные стили CSS. translations — папка с языковыми пакетами.Кроме этого, в корневой директории лежат следующие файлы:
13. Добавление своих настроек theme settings. Cоздание тем в Drupal 8 - вводный курс для начинающих.
favicon.ico — иконка фавикон , которая используется темой по умолчанию. Считается правилось хорошего тона наличие файла favicon.ico в теме. НАЗВАНИЕ_ТЕМЫ.info — данный файл обязательно должен присутствовать в теме, иначе Drupal ее просто не увидит. В нем прописываются регионы, файлы стилей и скриптов, поддерживаемая версия Drupal, значения параметров по умолчанию, название темы и так далее. logo.png — логотип, используемый по умолчанию. screenshot — фотография внешнего вида темы. Предназначена для удобства, чтобы выбирать тему из общего списка можно было не только по ее названию, но и по внешнему виду. style.css — файл с основными стилями CSS. Чаще всего лежит в корневом каталоге, но бывает его кидают в папку css. template.php — файл на языке программирования php, в котором описывается основная логика и задаются некоторые переменные для шаблонов. Если помните, именно в файле template.php нужно прописывать мета теги Description и Keywords для главной страницы сайта. theme-settings.php — здесь прописываются дополнительные настройки темы. REARME.txt — справочная информация для пользователя.
Шаблоны темы Drupal
Шаблоны отвечают за формирование какого-то определенного элемента страницы. При этом соблюдается некоторая иерархия, которая заключается в том, что одни шаблоны задействуют в себе другие шаблоны (подключают их). Это напоминает матрешку — более мелкие элементы объединяются в более крупные.
Для лучшего понимания обратимся к рисунку. На нем представлена структура файлов и каталогов темы под названием example.
Здесь цветами показано, какой шаблон за какую область страницы отвечает:
html.tpl.php — включает в себя весь html код страницы (DOCTYPE, разделы head и body). page.tpl.php — отвечает за содержимое элемента body. region.tpl.php — здесь прописываются регионы темы. block.tpl.php — функциональные блоки. node.tpl.php — отвечает за вывод материала страницы. comment-wrapper.tpl.php — отвечает за вывод всех комментариев и форму создания сообщения. comment.tpl.php — вывод отдельного комментария.К примеру, comment-wrapper.tpl.php задействует шаблон comment.tpl.php для вывода оставленных пользователями комментариев и добавляет к ним форму для создания нового сообщения, в свою очередь node.tpl.php подключает к себе шаблон comment-wrapper.tpl.php и еще добавляет вывод содержимого страницы (материала).
Если один из шаблонов отсутствует, то используется шаблон по умолчанию, заданный в ядре Drupal.
Создание отдельного шаблона Drupal для главной страницы
Что делать, если нужно поменять оформление или содержание главной страницы сайта не затрагивая все остальные? Такая проблема очень часто встречается на практике. Например, вывести над анонсами статей в области контента поле для справок или список текущих конкурсов. Казалось бы, надо добавить в шаблон page.tpl.php пару строчек кода! Нет, все не так просто. В этом случае поле для справок будет выводится на всех страницах, а не только на главной.
Проблема решается элегантно и просто — для главной нужно создать отельный шаблон page--front.tpl.php . Порядок действий следующий.
1. Чаще всего за основу шаблона для главной страницы берется page.tpl.php. Скачиваем этот файл из используемой темы Drupal к себе на компьютер, переименовываем в page--front.tpl.php и загружаем обратно в папку с другими шаблонами. Для работы с сервером советую использовать бесплатный ftp клиент FileZilla . Меня еще никогда не подводил!
2. Открываем продвинутым редактором кода Notepad++ файл page--front.tpl.php и добавляем наш код для поля со справками.
3. Чтобы Drupal подхватил новый шаблон, необходимо почистить кэш: «Конфигурация» — «Разработка» — «Производительность» — кнопка «Очистить кэш». Настоятельно рекомендую использовать модуль Administration menu .
Вот и все!
Создание отдельного шаблона для определенного типа материалов
Идем дальше в своих изысканиях. Теперь нам захотелось выделить определенные типы материалов. Например, статьи (машинное имя: post). В этом случае последовательность действий будет следующая.
1. Заходим на сервер в папку с активной темой Drupal и открываем на редактирование файл template.php . Прописываем в нем следующую функцию.
| function НАЗВАНИЕТЕМЫ_preprocess_page ( & $vars , $hook ) { if ( isset ( $vars [ 'node' ] ) ) { $vars [ 'theme_hook_suggestions' ] [ ] = 'page__' . str_replace ( '_' , '--' , $vars [ 'node' ] -> type ) ; } } |
Не забудьте вписать в код название темы, после чего сохраните файл template.php.
2. Далее можно создавать отдельный шаблон для определенного типа материала Drupal. В общем виде он будет называться так: page--ТИПМАТЕРИАЛА.tpl.php . Для примера со статьей: page--post.php. За его основу можно взять файл page.tpl.php.
3. Не забудьте очистить кэш!!!
Sub-themes (подтемы)
Sub-themes — такие темы не имеют полного комплекта шаблонов, они просто задействуют некоторые шаблоны из другой темы (родительской). Это обязательно должно быть прописано в файле НАЗВАНИЕ_ТЕМЫ.info. При этом, родительская тема должна быть включена в Drupal, а подтема включена и установлена по умолчанию. В свою очередь родительская тема может быть подтемой для другой темы. Таким образом, в Drupal возможна иерархия тем.
На этом на сегодня все. Материал может показаться несколько сложным, все эти папки, файлы, шаблоны Drupal и подтемы, но тут главное уловить суть, понять. Как только придет понимание — все встанет на свои места. Спасибо за внимание! Берегите себя.
Лучший способ выразить благодарность автору - поделиться с друзьями!
Узнавайте о появлении нового материала первым! Подпишитесь на обновления по email:
Следите за обновлениями в Twitter и RSS.