Дефолтный шаблон в MaxSite CMS

Поскольку скоро я выложу на всеобщее обозрение первую публичную рабочую версию своей системы, то решил в  последние дни более плотно заняться дефолтный шаблоном.

На самом деле это очень важная часть любой CMS. Такой шаблон должен решить две задачи. Во-первых он должен показать пользователю на что способна система. То есть пользователь выполнил только установку и еще не разбирается во всех тонкостях (и это естественно), но уже на этом этапе должен получить нечто рабочее и похожее на конечный продукт. Здесь конечно же следует обратить внимание на дизайн. Если бы разработчики систем придавали бы этому вопросу большее значение, то наверное их истемы были более популярны. Для примера можно взять тот же CodeIgniter или CakePHP. С таким дефолтным шаблоном первое впечатление создается более чем тягостное.

Вторая задача - это продемонстрировать сторонним разработчикам функциональные возможности системы и дать возможность «поковыряться» внутри. Тут, конечно же важно сделать так, чтобы процесс ознакомления проходил в «естественной» (для программистов) последовательности.

Дефолтным шаблоном я занялся пару месяцев назад и сейчас он потянет как минимум на нормальный сайт. (Конечно же мое мнение субьективно, но все-таки мой опыт позволяет мне так утверждать.)

В итоге я пришел к шаблону, который вы видите на этом сайте. Он и будет идти в комплекте. Я исходил из-того, что сейчас модна именно такая стуртура блоков: верхнее меню, три сайдбара, тексты, подвал. При этом я решил, что некоторые настройки шаблона можно вынести в админ-панель.

В частности можно сменить изображение в шапке (5 вариантов), стиль меню (15 вариатов), стиль (style) текста названия сайта и стиль текста описания. Это все уже прописано в ini-файле и при желании легко добавляется свой вариант. В общем, путем несложных телодвижений, можно получить сразу несколько вариантов внешнего вида.

Теоретически можно было бы кастомизировать и прочие элементы и блоки, но всегда должен быть разумный компромис. Мне кажется, что тот, кто захочет изменить или расширить функциональность, сможет без труда понять, каким образом это всё реализуется. А дальше можно делать по аналогии.

Для программиста важна будет возможность быстро оценить внутреннее устройство шаблона. Ну например я могу сказать, что любой шаблон начинается с index.php. Данного сообщения более чем достаточно, чтобы открыть этот файл и увидеть, что дальше подключаются файлы по типу данных. Например для главной страницы это home.php. Дальше - по цепочке.

То есть дефолтный шаблон, помимо демонстрации системы, несет еще и некую справочную функцию. Именно по этой причине я не стал сокращать или убирать какие-то «дубли», поскольку это усложнило бы логику самого шаблона. К слову сказать, для шаблона существует только один обязательный файл - index.php. Всё остальное на выбор программиста.

Так же я сознательно постарался использовать привычные имена файлов: home.php, page.php, category.php, header.php и т.д. Любой, кто хоть раз сталкивался с WordPress, поймет для чего предназначаются эти файлы.

Дальше пойдет техническая информация, в которой я расскажу как «физически» работает шаблон.

Итак, после отработки и инициализации системы (подключается БД, сессии, плагины, основные функции), управление передается на index.php текущего шаблона. Грубо говоря, можно сделать шаблон вообще только из одного этого файла. Но в нашем случае лучше разделить логику шаблона по разным файлам. Так будет проще.

В index.php выполняется проверка на типы данных, но перед этим смотрится is_feed() - то есть нужно ли отдавать RSS-ленту. Если нужно, то подключаем feed-файл соответствующего типа данных. Например для главной страницы - rss-лента содержит все последние записи. А в рубриках - только записи этой рубрики. Лента какой-то страницы содержит её комментарии.

Аналогично проверяется и другие типы данных. Сам тип определяется на основе входящего URL и служит для того, чтобы показать системе какие именно данные нужно выводить.

Сам же вывод осуществляется в отдельных файлах для каждого типа. (В принципе это не обязательно - можно просто добавить условие is_type() и получать/выводит данные в одном файле.)

Поскольку у нас единый шаблон для всех типов данных (кроме rss - он вообще «бесшаблонный»), то сам шаблон с точки зрения HTML разбивается на три части: main-start.php, файл типа, main-end.php. В main-start.php мы подключаем header.php, который содержит секцию <head> (до <body>). В main-end.php подключается footer.php. Естественно, что все эти файлы содержат какой-то html, который зависит от дизайна.

Таким образом у нас получается так, что изменяемая часть - это только файл типа данных. Именно в этом файле мы и выполняем получение данных для вывода. Примерно так:

• Получение данных для вывода (mso_get_pages)
• Подключение require('main-start.php')
• Вывод данных в цикле (foreach)
• Подключение require('main-end.php')

Почему нужно получать данные до main-start.php? Всё очень просто. Поскольку в main-start.php мы подключаем и секцию <head>, где указываются title, description и keywords, которые зависят от полученных данных. Например для конктерной страницы можно указать свой титул. Поэтому, пока мы не получим сами данные, выводить что-либо в браузер нет смысла.

Если сравнить с WordPress, то принципиальное отличие здесь именно в этом. WordPress получает данные до шаблона. С одной стороны мы делаем тоже самое, но с другой - какие именно данные мы решаем сами. Я, естественно, предусмотрел специальную функцию (mso_get_pages), которая значительно упрощает этот процесс, но в принципе можно указать и свой SQL-запрос. Более того, какие-то страницы можно вообще выводить без получения данных. Например «contact» - здесь располагается форма обратной связи и получать какие-либо данные не требуется.