Создаем шаблон для Joomla с нуля. Часть 3

Вернуться
Опубликовано: 1.03.2015 г.

В CMS Joomla для того чтобы сообщить движку, какие файлы используются в шаблоне, существует специальный файл templateDetails.xml. Как понятно из расширения файла, это специальным образом сформированный XML-документ, где содержимся полный перечень всех файлов и папок темы, а также инструкции по установке шаблона в систему. Ниже мы рассмотрим построчно содержимое данного файла.

 

 

Из чего состоит templateDetails.xml

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

Как водится, первая строка указывает, какая кодировка используется. Лучше всего использовать UTF-8:

<?xml version="1.0" encoding="utf-8"?>

Следующая строка – привычный нам DOCTYPE, который в этот раз выглядит немного необычно:

<!DOCTYPE install PUBLIC "-//Joomla! 3/0//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/3.0/template-install.dtd">

Дальше мы указываем движку, что данный файл – это именно инструкция по установке. За это отвечает атрибут «type» главного тега <extension>. Кроме того, здесь же указывается версия движка, с которой совместим наш шаблон. Мы укажем третью версию:

<extension version="3.0" type="template" client="site">

Следующие строки – Это общая информация о шаблоне: его имя, версия, дата создания, сведения об авторе, лицензия, по которой распространяется шаблон, краткое описание. Все эти параметры описываются с помощью специальных тегов:

Не забывайте: каждый тег обязательно должен закрываться!

В принципе, любой из данных тегов, кроме <name> и <version>, можно опустить, однако лучше их всё же указывать, хотя бы пустые.

Когда данные инструкции внесены, начинается секция, где перечисляются все файлы и папки. Которые используются в шаблоне. Начинается секция тегом <files>, в котором. В свою очередь, указываются директории тегами <folder>, а в них – имена файлов <filename>. Выглядит это примерно так:

Здесь важно соблюдать правильную вложенность: к примеру, если вы начали описывать папку images, нужно вначале перечислить все файлы, которые лежат в ней, а только потом переходить к следующей папке.

Последняя секция – это блок, где перечислены все позиции наших моделей шаблона. Каждый элемент находится в теге <position>, а вся секция располагается между тегами <positions> </positions>:

Когда все модули перечислены, мы закрываем тег </extension> и сохраняем файл. Наш установочный templateDetails.xml полностью готов.

Установка готового шаблона в систему

После того как создан файл установки, можно переходить к инсталляции нашего шаблона. Для этого нам вначале понадобится создать установочный пакет. Он создается при помощи любого удобного и привычного для вас архиватора: WinRAR, 7zip, WinZip и т.д. Все файлы и папки, которые мы ранее создали, запаковываем в архив типа ZIP, называем его, к примеру, test.zip. Теперь мы имеем установочный пакет шаблона.

После этого идем в панель управления Joomla, и в разделе расширений при помощи команды «Установка» открываем и запускаем наш архив test.zip. Если всё прошло успешно, то во вкладке «Стили» проявится наш свежесозданный шаблон. Его можно сразу установить по умолчанию, и тогда сайт начнет использовать его вместо основного. Теперь во вкладке «Шаблоны» он также появится, и там можно будет редактировать некоторые его параметры. Если же при установке наблюдались проблемы или ошибки, проверьте еще раз корректность templateDetails.xml.

Чтобы посмотреть шаблон в действии, создайте несколько тестовых записей, после чего зайдите на главную страницу сайта. Конечно, особой красоты вы там не увидите, ведь используется пустой CSS, который мы создали ранее, и ожидать какого-либо дизайна пока рано. Но если на страницах сайта не сыпятся ошибки, то пока вы всё сделали правильно. И в следующей части вас ждет создание основного CSS, который наведет порядок с дизайном.

Создаем шаблон для Joomla с нуля. Часть 1

Создаем шаблон для Joomla с нуля. Часть 2

Создаем шаблон для Joomla с нуля. Часть 4

Создаем шаблон для Joomla с нуля. Часть 5

2988 1

Один комментарий на «“Создаем шаблон для Joomla с нуля. Часть 3”»

  1. Williamurip:

    This is one awesome forum post. Keep writing. Vivino

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *