7.1.Структура темы PHP-Nuke

Создание собственной темы для вашего сайта очень важно, так как это позволит Вам придать своему сайту индивидуальность, сделать его не похожим на другие. Индивидуализация портала начинается от разработки графика. Зная, как создать тему в PHP-Nuke, вы сможете самостоятельно ее разработать. В этой главе, для примера, будет использоваться тема - NukeNews, сделанная Франсиско Бурзи для PHP-Nuke. Это - тема, составленная из нескольких файлов HTML, включаемых в theme.php. Данное решение, в отличие от использования единого файла theme.php, позволит Вам управлять графической частью темы через HTML редактор (на подобии DreamWeaver) т.к. использует небольшое количество кода PHP.

Тема NukeNews структурирована следующим способом:

• theme.php: Главный управляющий файл. Содержит функции для оформления темы.

• tables.php: Управляет функциями opentable (); и closetable ();

• header.html: Файл оформления верхней части вашего сайта

• footer.html: Файл оформления нижней частьти вашего сайта

• blocks.html: Файл оформления блоков

• center_right.html: Файл оформления перед правой колонкой блоков (после центральной части страницы)

• center_left.html: Файл оформления после левой колонки блоков (до центральной части страницы)

• story_home.html: Файл оформления вывода новостей на главной странице

• story_page.html: Файл оформления страницы с полной версией новости (статьи)

Эти файлы включены в функции, указанные в theme.php. Мы также имеем таблицу стилей, в виде файла с названием style.css (style/style.css) который подключается в header.html и находящийся в папке темы. По принятому в сообществе PHP-Nuke правилу, файл с таблицей стилей нужно всегда называть style.css и он всегда должен находиться в подкаталоге "style" каталога темы. Изображения располагаются в подкаталоге "images", который всегда расположен в каталоге темы.

Структура папки темы NukeNews выглядит так:

• themes/NukeNews

• themes/NukeNews/style/

• themes/NukeNews/images/

Всегда помните! Регистр важен. Для UNIX-систем буквы ВЕРХНЕГО РЕГИСТРА отличаются от нижнего.

Включение файла HTML встречается не во всех темах, некоторые программисты включают весь HTML в theme.php файл, но включение HTML-кода отдельно, решает много проблем типа форматирования HTML кода, которое было бы невозможно при использовании единого файла theme.php. Это дает нам возможность редактирования темы визуальным редактором (РЕЖИМ НАГЛЯДНОГО ОТОБРАЖЕНИЯ - WYSIWYG).

theme.php - файл, который содержит управляющие функции компонентов всей структуры PHP-Nuke (заголовок, нижний колонтитул, центральные части, блок ...).

Функция themeheader() управляет верхней частью сайта. Осуществляет вывод таблиц формирующих заголовок страницы, может также определять элементы, которые не включены в таблицу стилей и переменные, которые помещены во включенных файлах html.

Код в theme.php (который определяет переменную $theuser)

Код в header.html (который визуализирует переменную $theuser

<td width="15% "nowrap >< font class="content" color="#363636 " >
<b> $theuser </b></font></td>

themefooter(); функция управляет нижней частью сайта.

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

Прежде всего, если визуализируемая страница имеет переменную $index равную 1, то она будет отображаться с правыми блоками, но если вместо этого $index равен 0, тогда правые блоки не будут отображаться.

Функция themeindex() управляет новостями на Главной странице, форматирует их, добавляя элементы согласно различным сценариям, с использованием функции "if". Выводится данная функция файлом story_home.htm.

Функция themearticle() управляет внутренней страницей новостей, той, которую мы видим перейдя на данную новость; помните, что выводит данную функцию файл story_page.htm, но блоки, которые должны быть включены (обзоры статей, связи и т.д.) определяются модулем новостей.

Функция themesidebox () управляет размещением блоков (см Глава 8), и выводится файлом blocks.htm, в котором определяется стиль и оформление.

Стоит так же упомянуть о некоторых элементах самого файла theme.php. Это переменные, форматирования текста и внешнего вида таблиц, часть из них определена в CSS (каскадной таблице стилей), а часть определена в начале файла theme.php.

Переменные NukeNews темы:

$bgcolor1 = "# efefef";
$bgcolor2 = "# cfcfbb";
$bgcolor3 = "# efefef";
$bgcolor4 = "# cfcfbb";
$textcolor1 = "# 000000";
$textcolor2 = "# 000000";

Как вы видно из примера, значения этих переменных приведены не в десятичном формате.

Определим цвета вашего сайта - $bgcolor2 используется для граней таблицы, при выводе opentable(), $bgcolor1 определяет цвет фона таблицы. Оставшиеся две фоновые переменные используют те же самые критерии. $textcolor1 и $textcolor2 определяют цвет текста.

Теперь рассмотрим что содержится в файле tables.php. В нем содержатся 4 функции (opentable(); closetable(); opentable2(); closetable2();), которые включают в себя html-тэги, открывающие и закрывающие таблицы.

Такой подход удобен при создании модулей (см Глава 9), Вам не нужно переписывать HTML каждый раз, когда Вы хотите создать таблицу, а просто указываете для этого следующие параметры:

opentable();
echo "Content of the table";
closetable();

Таким способом таблицы создаются  - быстро и эффективно, а так же всему сайту придается единый стиль. Посмотрим как структурирована данная функция. Рассмотрим для начала opentable() и closetable();

	Пожалуйста обратите внимание
	это - функции php, так что нужно соблюдать синтаксис HTML внутри php добавляя обратный слеш перед двойными кавычками (то есть align="left", нужно написать align=\"left\")

Синтаксис очень прост, не так ли?
Рассмотрим данную функцию поэтапно:

1. Функция открыта

2. Вызываются необходимые переменные ($bgcolor1, $bgcolor2)

3. Открываем таблицу шириной 100%, мы определяем цвет ее фона (на странице это будет цветом рамки нашей таблицы).

4. Открываем столбец и строку

5. Вставляем новую таблицу шириной 100% 

6. Определяем цвет ее фона (на странице этот будет общим фоном нашей таблицы).

7. Открываем столбец и строку

Остановимся на этом, т.к. на этом функция заканчивается и начинается закрытие таблицы

function CloseTable() {
echo "</td ></tr ></table ></td ></tr ></table > \n";
}

Вот ее поэтапное выполнение:

1. Функция открыта

2. Закрываем столбец, закрываем строку

3. Закрываем внутреннюю таблицу

4. Закрываем столбец, закрываем строку

5. Закрываем внешнюю таблицу

Что может быть проще создания функций HTML с PHP?