Отказ от старого default-шаблона. Схема перехода к MaxSite CMS 0.84

Строго говоря речь идет не об отказе от Default-шаблона, а о смене его на вариант, основанный на shared-каталоге. Такая смена приведет к неработоспособности всех старых шаблонов, основанных на default. Я решил, что версия MaxSite CMS 0.83 будет последней, которая будет содержать нынешний default-шаблон. После этого все новые версии будут уже работать только на shared-каталоге, а default заменю на другой вариант.

Такая схема позволит без проблем обеспечить работу старых шаблонов до версии 0.83. Вместе с тем, я разработал схему обновления шаблонов, которая позволит отказаться от default-шаблона и в будущем без проблем позволит обновлять систему до любой версии.

Различия схем «default» (старый) и «shared»

Прежде чем приступить к переделкам, необходимо дать краткое описание отличий этих двух схем.

До MaxSite CMS 0.84 у нас было два варианта построения шаблона: основанный на default-шаблоне и основанный на shared-каталоге. Оба этих подхода предполагают, что любой шаблон будет заимствовать часть программного кода или файлов либо из default-шаблона, либо из shared-каталога.

В этих вариантах есть несколько принципиальных отличий, в первую очередь — разные структуры каталогов и файлов, что делает их несовместимыми друг с другом.

Для проверки какой именно у вас вариант, достаточно открыть index.php шаблона. В shared-шаблонах используется меньше кода и он содержит строчку:

if ($fn = mso_dispatcher()) require($fn);

Вариант «default» больше по размеру примерно в 5 раз.

Варианты переделок шаблонов

Конечно, самым лучшим вариантом был бы перевод шаблона на shared-схему. Это потребует довольно серьезной работы, которая по сути сведется к созданию нового шаблона (на основе нового default) только со старым дизайном. Вариант подходит тем, кто разбирается в вёрстке сайтов.

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

Некоторые шаблоны, вроде Clouds, достаточно популярны и используются с небольшими изменениями на сайтах. В таких случаях можно взять новый Default (или D2), только добавить небольшие правки по цветам. Новые шаблоны многократно перекрывают все старые, и к тому же, отлично настраиваются прямо из админ-панели. Таким образом повторить дизайн старого Default или того же Clouds можно вообще без программирования. Единственное — это добавить небольшие css-стили.

Вариант, о котором и пойдет речь ниже — это перенос из default-шаблона общих файлов. Таким образом шаблон не будет использовать default вовсе. Этот вариант хорош тем, что шаблон становится сам по себе и на него уже не будут влиять никакие внешние изменения; можно будет обновлять MaxSite CMS без ограничений по версии; он полностью сохранит функциональность и внешний вид; он очень простой и годится для «чайников».

Схема обновления своего шаблона к MaxSite CMS 0.84 (и выше)

Изменения необходимо выполнять последовательно. Если есть возможность, то лучше сделать это на локальном сервере.

Обратите внимание, что шаблон Default в MaxSite CMS 0.84 уже заменен на новый вариант, основанный на shared. Поэтому для обновления вашего шаблона используйте старый вариант, который всегда доступен как старый шаблон default ⁸³⁸. Если у вас версия менее 0.84, то этот шаблон включен в комплект системы.

В этой инструкции default-шаблон подразумевается только в старом варианте!

1. Сделать резервную копию своего шаблона вне каталога templates.

2. В каталог type своего шаблона копируем все type-файлы из default-шаблона. При этом следим за тем, чтобы не затереть уже существующие файлы. Если каталога type нет, то просто копируем его целиком из default-шаблона.

3. Проверяем файлы css-стилей в шаблоне (каталог css). Если в каталоге css шаблона присутствуют файлы style-all.css, style-all-mini.css, my_style.css или css.php, то ничего не делаем. Иначе — копируем из default-шаблона файл style-all-mini.css.

4. Копируем в свой шаблон из default файл functions-template.php.

5. Открываем в своем шаблоне файл functions.php и меняем строчку

if (file_exists(getinfo('templates_dir') . 'default/functions-template.php')) 
	require(getinfo('templates_dir') . 'default/functions-template.php');

на

if (file_exists(getinfo('template_dir') . 'functions-template.php')) 
	require(getinfo('template_dir') . 'functions-template.php');

6. Копируем из default-шаблона файл options.ini.

7. Обновляем в браузере страницу (F5) и смотрим исходный html-код (Ctrl+U). Внимательно просматриваем секцию HEAD, где все подключения css-файлов должны быть из текущего шаблона, а не из default (см. link rel="stylesheet" ... ). Если какие-то css-стили подключаются из default-шаблона, значит еще раз внимательно проверяем предыдущий пункт.

8. Здесь же в режиме исходного кода запускаем поиск по тексту (Ctrl+F) и вводим поисковое слово «default/». Проверяем все найденные вхождения, чтобы они не были частью пути к default-шаблону. Если всё сделано без ошибок, то вхождений не должно быть и сам сайт должен работать без ошибок и изменений.

9. Теперь шаблон использует только свои файлы и никак не связан с default и вы можете обновиться до последней версии MaxSite CMS, согласно инструкции в install-ru.txt.

Схема рассчитана на типовой вариант построения шаблона. Некоторые шаблоны могут иметь другие зависимости: если возникнет php-ошибка, то в ней будет указан путь к отсутствующему файлу. Если это какие-то связи в других файлах, например в css-стилях, то попробуйте запустить поиск по содержимому файлов шаблона по фразе «default/».

Вариант «быстрого» обновления

Есть ещё один способ сохранить совместимость вашего шаблона с новыми версиями MaxSite CMS.

Если у вас MaxSite CMS 0.84 и выше, то после обновления системы, переименуйте каталог default (например в default-new), а на его место загрузите старый шаблон default ⁸³⁸.

Такой вариант очень простой, но операцию придется проделывать при каждом обновлении MaxSite CMS.