Плюшка CMS#11.04.2018 новое

/* Создан для быстрой разработки приложений */
Скачать Демо

18. Шаблоны, информация для верстальщика

07.10.2015

Информация в этом разделе может быть полезна не только программисту, но и верстальщику.

Шаблоны хранятся в директории /template и представляют из себя HTML-документы, содержащие специальные теги для вставки контента. Имена файлов формируются по следующему принципу:

(pc|pda).ИМЯ_ШАБЛОНА.html

Тут pc – шаблон дня настольных ПК, pda – шаблон для мобильных устройств. Версия для мобильных устройств доступна на поддомене pda. Переключение или редирект с одной версии на другую должен определяться в шаблоне с помощью явного указания ссылок или при помощи JavaScript.

ИМЯ_ШАБЛОНА определяется программистом и устанавливается при помощи модуля «управление шаблонами» или же непосредственно в коде вызовом функции core::template(). В большинстве случаев есть только один шаблон и имя соответствующего файла «pc.default.html».

Все ресурсы (CSS, JavaScript, картинки и т. д.) должны находиться в пределах директория /public, рекомендуется складывать «всё в кучу» в директорий /public/template, но это не является обязательным требованием.

В шаблоне могут быть использованы следующие специальные теги:

 

Рядом с этим тегом может быть и другой текст, например название сайта, если оно брендируется.

 

.

и в это место будут подставлены JavaScript и CSS для конкретных страниц.

В шаблоне можно вывести любой виджет при помощи тега {{widget}}, однако для этого нужно знать какие он должен принимать параметры. Формат этого тега следующий:

{{widget[ИМЯ][ДАННЫЕ][ВРЕМЯ_КЕШИРОВАНИЯ][ЗАГОЛОВОК]}}

ИМЯ — это имя виджета (соответствует имени файла в директории /widget.
ДАННЫЕ — параметры, необходимые для отображения виджета. Это может быть просто строка или число или массив, тогда он должен быть задан в таком формате: параметр_1:"значение",параметр_2:"значение"... ВРЕМЯ_КЕШИРВАНИЯ — время актуальности кеша в минутах (не обязательный параметр). Если не задан, то виджет не будет кеишроваться. ЗАГОЛОВОК — текстовый заголовок виджета (не обязательный параметр).

В шаблоне сайта может быть задано любое количество секций при помощи тега {{section}} — это, по сути, контейнер для публикации виджетов. Но всё же если виджет должен быть опубликован на всех страницах сайта, то лучше вставить его явно при помощи тега {{widget}}.

Внимание! Виджеты и шаблоны кешируются, поэтому, если в шаблон вносятся изменения, то нужно очистить кеш, либо перевести сайт в отладочный режим (в «общих настройках») для автоматической очистки кеша.

Содержимое тега {{content}} зависит от отображаемой страницы сайта. HTML-разметку контента можно найти в файлах в директории /view. HTML-разметка виджетов может находится также в директории /view или в файлах в директории /widget.