Темы оформления
Тема оформления отвечает за внешний вид сайта. Она представляет собой набор css, js файлов, файлов изображений и файлов шаблонов.
У каждого сайта может быть любое количество тем оформления, но только одна из них является основной. Основная тема оформления это та, которая доступна посетителям сайта в данный момент.
Для просмотра списка доступных тем оформления сайта, зайдите в интерфейс администратора и выберите пункт меню Система — Темы оформления
Структура каталогов
Структура каталогов файлов css, js, файлов изображений и прочих вспомогательных файлов шаблона может быть любой.
Особое внимание следует обратить на каталог Outofbox/Templates. В данном каталоге лежат системные файлы шаблона на языке Twig.
- Синтаксис шаблонов
- Переменные и функции
- Стандартные шаблоны
- Skins sync
Темы оформления
Темы оформления являются традиционным способом настроить внешний вид страниц веб-приложения. Применив новую тему, мы можем изменить внешний вид всего приложения за считанные секунды.
В Yii каждая тема представлена как папка, содержащая файлы представлений, макетов и прочих необходимых файлов, таких, как CSS, JavaScript и пр. Название папки соответственно определяет название темы. Все темы хранятся в папке WebRoot/themes , при этом быть активной, т.е. использоваться в текущий момент, может только одна из тем.
Подсказка: Папку, где по умолчанию хранятся темы — WebRoot/themes — можно легко изменить путем установки свойств basePath и baseUrl компонента themeManager на желаемые.
Для активации темы нужно установить значение theme равным имени соответствующей темы. Это можно проделать путем конфигурации приложения или прямо в ходе выполнения в действиях контроллера.
Примечание: Имя темы чувствительно к регистру, и, если попытаться активировать несуществующую тему, свойство Yii::app()->theme вернет null .
Содержимое папки с темами должно быть организовано точно также, как и содержимое базовой директории приложения, то есть, все файлы представлений должны находитьс в папке views , макеты представлений в папке views/layouts , а файлы системных представлений в папке views/system . Например, если необходимо заменить представление create контроллера PostController на представление темы classic , нужно сохранить новый файл представления как WebRoot/themes/classic/views/post/create.php .
Для представлений контроллеров в модулях, соответствующие файлы оформленных представлений нужно также поместить в папку views . Например, если упомянутый выше контроллер PostController входит в модуль forum , необходимо сохранить файл представления create как WebRoot/themes/classic/views/forum/post/create.php . Если модуль forum является составной частью другой модуля support , то файл представления должен быть сохранен как WebRoot/themes/classic/views/support/forum/post/create.php .
Примечание: Папка views может содержать данные чувствительные с точки зрения безопасности, поэтому необходимо ограничить доступ к папке извне сервера.
В момент вызова метода render или renderPartial для отображения представления происходит обращение к соответствующим файлам представлений и макетов активной темы. Если файлы найдены, начнется формирование странички, в противном случае, будут использоваться файлы оформления по умолчанию, месторасположение которых устанавливается свойствами viewPath и layoutPath.
Подсказка: Часто в представлениях темы приходится ссылаться на прочие файлы темы, например, для отображения картинки, находящейся в подпапке темы images . Используя свойство baseUrl активной темы, можно сформировать корректную ссылку на картинку следующим образом:
Yii::app()->theme->baseUrl . '/images/FileName.gif'
Что такое тема оформления
ReadyScript позволяет изменять тему оформления сайта из раздела Веб сайт → Настройка сайта административной панели. Для открытия диалога выбора темы оформления необходимо нажать кнопку Выбрать в поле «Тема».
Диалог выбора темы оформления
Диалог отображает все темы оформления, присутствующие в папке /templates. Для загрузки новой темы оформления нажмите на кнопку Выбрать zip-файл. Далее выберите zip-файл, в котором присутствует папка с темой оформления. Сразу после загрузки новая тема отобразится в списке. Поставьте флажок Заменить тему, если таковая уже присутствует, если желаете обновить существующую тему.
Некоторые темы оформления поддерживают выбор цветовой схемы. В этом случае необходимо сначала кликнуть мышью на нужный цвет, а затем выбрать тему. После выбора темы оформления произойдет загрузка сведений обо всех страницах, что можно увидеть в разделе Конструктор сайта.
Если в разделе Конструктор сайта были внесены изменения в отображение страниц сайта, то рекомендуется сохранить их до установки новой темы, сделав экспорт в xml-файл, иначе изменения будут потеряны.
Темы оформления
Тема — это внешний вид сообщения, в котором определяется расположение различных элементов, художественный стиль и способ отображения текста сообщения. Включает в себя программный HTML-код, таблицы стилей и дополнительные шаблоны для отображения контента.
Контекстная панель
| Кнопка | Описание |
|---|---|
| Добавить шаблон | Переход на страницу с формой создания новой темы. |
| Загрузить шаблон | Переход к форме загрузки (импорта) темы в систему. |
| Настроить | Переход к диалогу настройки внешнего вида отчетной формы. |
| Excel | Экспорт данных из отображаемой таблицы в формат MS Excel. |
Список тем
- Изменить — переход к форме редактирования темы;
- Копировать — копирование (дуплицирование) темы;
- Скачать — сохранение темы;
- Удалить — удаление темы.
Новинки документации в соцсетях:
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.
Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.