В этом уроке мы кратко разберем пример адаптации шаблона от Joomla 1.5 под версию Joomla 2.5. Для учебных целей возьмем шаблон Joomla 1.5 по умолчанию - "rhuk_milkyway" и последовательно адаптируем его под нативную версию Joomla 2.5.
Замечание:
В этом уроке рассматривается исключительно вопрос адаптации шаблона Joomla; подразумевается, что у вас уже установлен и настроен сам сайт на Joomla 2.5 или осуществлена его миграция с более ранней версии 1.5.
Итак, нужно выполнить 5 шагов.
- Сделать копию всех файлов шаблона Joomla 1.5
- Упорядочить структуру файлов
- Отредактировать файл "templateDetails.xml"
- Отредактировать файл "index.php"
- Установить и протестировать адаптированный нами шаблон Joomla 2.5
Шаг 1. Делаем копии всех файлов шаблона Joomla 1.5
Первое, что нужно сделать, это скопировать всю папку шаблона от версии 1.5 в соответствующую папку вашего сайта на Joomla 2.5.
Скопируйте папку целиком
- Идите в папку с шаблонами Joomla 1.5 (
/ваш_сайт/templates/) - Создайте папку под названием rhuk_milkyway25
- Скопируйте все файлы из папки шаблона rhuk_milkyway от Joomla 1.5 и вставьте их (перенос без удаления) в только что созданную папку rhuk_milkyway25
Шаг 2. Редактируем структуру файлов
Теперь нам нужно отредактировать структуру папок для обеспечения совместимости шаблона с Joomla 2.5.
Редактируем структуру папок для обеспечения совместимости
- Удалите файл params.ini.
В версии 1.5 этот файл использовался для хранения значений параметров шаблона. Но в версии 2.5, все параметры шаблона хранятся в базе данных. Поэтому теперь надобности в файле "params.ini" нет. - Скопируйте файл "error.php" из дефолтного шаблона “atomic" вашей
Joomla 2.5 и вставьте его в корень шаблона rhuk_milkyway25. В версии 2.5 представлен новый файл error.php для шаблонизации страниц ошибок. Файл прост и мы можем воспользоваться примером из дефолтного шаблона "atomic" - Создаем новый файл template_preview.png.
В Joomla 2.5 появился новый файл - template_preview.png, в котором содержится большое превью изображения шаблона. Необходимо сделать изображение шаблона с разрешением 640x480 пикселей и назвать файл template_preview.png.
Шаг 3. Редактируем файл templateDetails.xml.
Итак, теперь пришло время для редактирования файла templateDetails.xml для совместимости с версией version 2.5.
- Переименовываем тег <install> на <extension>
Старые значения
Новые значения
<install version="1.5"...
<extension version="2.5"...
<p ></install> </extension>
- Изменяем название шаблона в теге <name>
- Заменяем многократные теги <filename> на одиночный тег <folder> Это новая фишка в Joomla 2.5. Теперь нам не нужно описывать все файлы каждой папки, а достаточно объявить лишь папку.
- Удаляем описание для файла params.ini
- Добавляем описание для новых файлов, созданных на этапе 2
Добавим следующие 2 строки:- <filename>error.php</filename>
- <filename>template_preview.png</filename>
- Переименовываем теги в разделе <params>
|
Old value |
New value |
|
<params> |
<config> |
|
<param... |
< field... |
|
</param> |
</field> |
|
</params> |
</fieldset> |
Шаг 4. Редактируем файл index.php
После редатирования файла templateDetails.xml", вам нужно приступить к редактированию файла index.php.
- Добавляем PHP код для загрузки библиотеки Mootools. Добавляем стринг
"JHtml::_('behavior.framework', true);"в область, показанную на скриншоте ниже.
- Заменяем текст rhuk_milkyway в шаблоне на php код. Joomla 2.5 позволяет нам получить название шаблона прямо из файла templateDetails.xml, поэтому нет надобности описывать название шаблона текстом.
Старый код
Новый код
rhuk_milkyway
<?php echo $this->template ?>
Шаг 5. Устанавливаем и тестируем адаптированный шаблон под Joomla 2.5
Теперь адаптированный Joomla 2.5 шаблон представлен в папке с шаблонами, но мы не видим его в менеджере шаблонов поскольку он еще не установлен. Необходимо выполнить следующие шаги:
- Идите в Панель администрирования > Расширения > Менеджер расширений > Поиск.
- Нажимаем иконку “Найти” в верхней правой части админ.панели
Выбираем объект rhuk_milkyway25 в списке и нажимаем на кнопку “Установить”
- Теперь установка шаблона Joomla 2.5 завершена и мы можем назначить его по умолчанию в менеджере шаблонов.
Итак, сегодня на примере шаблона rhuk_milkyway мы завершили его перенос на Joomla 2.5. У вас есть собственные идеи касательно переноса и адаптации шаблона от версии 1.5 к 2.5? Поделитесь своими мыслями в комментариях.
От переводчика: автор статьи ничего не рассказал об адаптации CSS стилей, что является немаловажным моментом, поскольку CSS классы у Joomla 1.5 и Joomla 2.5 имеют отличия. Об этом мы расскажем в части II.
Автор перевода: Евгений Сивоконь
