Вы смотрите тему оформления "example"
Данное руководство предназначено для верстальщиков / дизайнеров, которые хотят создать свою собственную тему оформления.
Для программистов создателей модулей, будет отдельная документация по разработке.
У движка есть тема "default", которая является системной, поставляется вместе с дистрибутивом и находится в папке /themes/default
.
В этой теме находятся все необходимые для работы файлы по умолчанию: шаблоны, стили, картинки, скрипты и т.д.
Также, каждый отдельный модуль может иметь свою папку с шаблонами /module_name/templates
, или другими файлами общего доступа /assets/modules/module_name
.
Нельзя редактировать, или удалять файлы в этих папках, нельзя ничего туда добавлять, иначе Вы потеряете совместимость с последующими обновлениями, или же в работе движка могут возникнуть ошибки, вплоть до полной потери работоспособности.
/themes
./assets
в которой размещаются стили, картинки и JS, и /templates
, где соответственно размещаются шаблоны.
Пустые папки, если в них ничего не копируется, создавать не нужно.
Учиться лучше всего на практике, поэтому давайте создадим свою первую несложную тему оформления. Начнем с задачи, которая изначально возникнет практически у всех, кто установит себе JohnCMS: мы будем менять Главную страницу сайта и логотип. Ниже будут даны пошаговые инструкции.
Перед тем, как взяться за создание своей темы, Вы должны четко знать, что хотите сделать и составить примерный план предполагаемых работ. Давайте же для нашего урока мы тоже создадим короткий список с техзаданием (ТЗ):
Для удобства работы, рекомендуется иметь неа своем компьютере локальный сервер (например Open Server), где должен быть установлен и настроен JohnCMS. В крайнем случае некторые действия можно проводить непосредственно на хостинге, однако так делать крайне не рекомендуется.
/themes
создаем папку lesson
/modules/homepage
./templates
а в ней лежит файл index.phtml
- это и есть Главная страница, этот файл нам и нужен./themes/lesson
- это папка с нашей темой, которую мы создали выше.
Мы должны скопировать сюда файл index.phtml
из модуля homepage.
Для шаблонов в папке с нашей темой должна быть подпапка templates
.templates
создается подпапка с названием
пространства имен для шаблонов модуля (обычно совпадает с именем папки модуля) и уже в нее копируется нужный нам файл.
/themes/lesson
создаем подпапку templates
а в ней подпапку с именем модуля ( в нашем случае это homepage
) откуда мы копируем шаблон.
В итоге должно получиться /themes/lesson/templates/homepage/
сюда и копируем наш index.phtml
Пока все. Дальнейшие инструкции будем писать все вместе.