Введение
Целью данного учебника является служить введение в создание Joomla! шаблонов. Она будет охватывать важных файлов и код, необходимый для создания базового шаблона. Код представлен так что можно вырезать и вставить с очень незначительными изменениями необходимо.
Создание структуры каталогов
Чтобы сделать самый основной шаблон, создайте новую папку в "шаблоны" папку. Название этой папки после шаблона т.е. "mynewtemplate".
С помощью текстового редактора (или выделенные редактор, например Adobe Dreamweaver) создать файлы "index.php" и "templateDetails.xml"
Чтобы все было организовано, сделать 2 новые папки называемые "образы" и "CSS". Внутри "CSS" папке создать файл с именем "style.css".
Хотя это прекрасно, чтобы поставить все ваши CSS код непосредственно в "index.php" файл, чтобы начать, многие веб-разработчики предпочитают размещать свои CSS код в отдельном файле, который может быть связан с нескольких страниц с помощью "связь" тега.
Это самые основные практические установки.
Структура папок и файлов структура:
* Mynewtemplate /
- CSS /
- + Style.css
- изображения /
- index.php
- component.php
- templateDetails.xml
Создание основных templateDetails.xml файл
TemplateDetails.xml файл является существенным. Без этого шаблона не будет видно по Joomla!. Файл содержит ключ "метаданных" о шаблоне.
Давайте посмотрим на пример:
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd"> <install version="1.5" type="template"> <name>mynewtemplate</name> <creationDate>2008-05-01</creationDate> <author>John Doe</author> <authorEmail> Этот e-mail адрес защищен от спам-ботов, для его просмотра у Вас должен быть включен Javascript </authorEmail> <authorUrl>http://www.example.com</authorUrl> <copyright>John Doe 2008</copyright> <license>GNU/GPL</license> <version>1.0.2</version> <description>My New Template</description> <files> <filename>index.php</filename> <filename>component.php</filename> <filename>templateDetails.xml</filename> <filename>template_thumbnail.png</filename> <filename>images/background.png</filename> <filename>css/style.css</filename> </files> <positions> <position>breadcrumb</position> <position>left</position> <position>right</position> <position>top</position> <position>user1</position> <position>user2</position> <position>user3</position> <position>user4</position> <position>footer</position> </positions> </install>
Так что, как видите, у нас есть набор информацией между теги разметки (<thing>). Вашсамый лучший подход к вырезать и вставить это
в ваш "templateDetails.xml" файл и изменить соответствующие биты (например, <имя> <author>).
<files> Часть должна содержать все файлы, которые вы используете - вы, возможно, не знаю, что их называют еще - не волнуйтесь,
обновить его позднее.
Написать в позиции, поскольку они - это общий набор так что вы сможете легко переключаться от стандартных шаблонов.
Создание основной файл index.php
Index.php файл становится основной части каждой страницы, что Joomla! поставляет. По сути, вы делаете страницу
(как и любой HTML-страницы), но место PHP код, в котором содержание вашего сайта должны идти.
Вот скелет кода готова для вырезания и вставки.
Начнем сверху:
<?php defined( '_JEXEC' ) or die( 'Restricted access' );?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
Первая линия останавливается непослушные люди, глядя на ваши кодирования и получать до плохие вещи. Вторая рассказывает браузер
(и webbots) какие страницы он. Третья строка говорит, что язык сайта дюйма
Теперь заголовок для реальной:
<head> <jdoc:include type="head" /> <link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/system/css/system.css" type="text/css" /> <link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/system/css/general.css" type="text/css" /> <link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template?>/css/style.css" type="text/css" /> </head>
Первая строка получает Joomla поставить правильную информацию заголовка дюйма Это включает в себя заголовок страницы,
мета-информации, а также системы JavaScript. Остальные создает ссылки на двух листах системы стиль и собственную таблицу стилей
(если он называется style.css и находится в папке CSS).
Теперь для основной части:
<body> <jdoc:include type="modules" name="top" /> <jdoc:include type="component" /> <jdoc:include type="modules" name="bottom" /> </body>
Удивительно, что этого будет достаточно! Да, это очень простой макет, но он будет делать эту работу. Все остальное будет сделано Joomla!.
Примечание: Вам необходимо для обеспечения вашего меню отправиться в путь в "верхней" позиции модуля.
Прикончить его - последний бит:
</html>
Полный исходный код шаблона:
<?php defined( '_JEXEC' ) or die( 'Restricted access' );?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" > <head> <jdoc:include type="head" /> <link rel="stylesheet" href="/<?php echo $this->baseurl ?>/templates/mynewtemplate/css/style.css" type="text/css" /> </head> <body> <jdoc:include type="modules" name="top" /> <jdoc:include type="component" /> <jdoc:include type="modules" name="bottom" /> </body> </html>
СОВЕТ: Есть несколько способов, которыми Вы можете просмотреть страницу индекса, как вы их вместе, либо вставить стили в голову главную страницу или непосредственно связать его с стилей вы будете использовать временно. Вы можете удалить эти ссылки перед упаковкой файла.
Упаковка шаблон для установки
Каталог с несколькими свободных файлов не удобный пакет для распространения. Так окончательный шаг, чтобы сделать пакет.
Это сжатый архив, содержащий структуру каталога и все файлы. Пакет может быть в формате ZIP (с расширением. ZIP расширения),
в формате TAR-GZIP (с расширением. Tar.gz расширения), или в TAR-bz2 формате (с расширением. Tar.bz2 расширения).
Если шаблон в каталоге MyTemplate / то, чтобы сделать пакет, который вы можете подключить к этому каталогу и использовать
такие команды, как:
- tar cvvzf ../mytemplate.tar.gz *
- zip -a -r ..\mytemplate.zip *.*
Примечание для Mac OS X пользователей
Примечание для разработчиков, использующих шаблон Mac OS X системы: Finder's "сжимать" пункт меню производит удобном формате ZIP пакет, но с одним поймать. Он сохраняет файлы в формате AppleDouble, добавив дополнительные файлы с именами, начинающимися с "._". Таким образом он добавляет файл с именем ". _templateDetails.xml, Что Joomla 1.5.x могут иногда неправильно. Симптомом является сообщение об ошибке:" Ошибка разбора XML в масштабе 1:1. Ошибка 4: пустой документ COPYFILE_DISABLE "к" истинным ", прежде чем использовать" сжать "или" смолы "Смотрите AppleDouble статье для получения дополнительной информации" Решением является компресс из командной строки, и установить переменную оболочки окружающей среды "...
Чтобы установить переменную окружения на Mac, откройте окно терминала и введите:
Примечание для разработчиков, использующих шаблон Mac OS X системы: Finder's "сжимать" пункт меню производит удобном формате ZIP пакет, но с одним поймать. Он сохраняет файлы в формате AppleDouble, добавив дополнительные файлы с именами, начинающимися с "._". Таким образом он добавляет файл с именем ". _templateDetails.xml, Что Joomla 1.5.x могут иногда неправильно. Симптомом является сообщение об ошибке:" Ошибка разбора XML в масштабе 1:1. Ошибка 4: пустой документ COPYFILE_DISABLE "к" истинным ", прежде чем использовать" сжать "или" смолы "Смотрите AppleDouble статье для получения дополнительной информации" Решением является компресс из командной строки, и установить переменную оболочки окружающей среды "...
Чтобы установить переменную окружения на Mac, откройте окно терминала и введите:
export COPYFILE_DISABLE=true
Затем в том же окне терминала перейдите в каталог, где в файлах шаблона проживать и вопрос ZIP команды.
Например, если ваши файлы шаблонов были построены в папке в вашем личном каталоге MyTemplate, то вы могли бы сделать следующее:
cd myTemplate zip -r myTemplate.zip *
Заключение
Теперь вы создали шаблон, который работает. Это не будет выглядеть как много еще. Лучшее, что можно сейчас сделать,
это начать экспериментировать с макетом.
