DataLife Engine > Версия для печати > Учимся писать модули для DataLife

Итак, приступим к делу. Возьмём любой сторонний скрипт, к примеру, скрипт который будет выводить да более знакомую и порядком, поднадоевшую фразу "Hello world".

Вот код скрипта:

<?php
echo 'Hello world';
?>

Создадим текстовый документ, занесём туда эти строки и сохраним его с расширением php. Назовём наш файл, к примеру, test.php. Далее мы поместим наш файл с кодом в папку engine/modules/ и на этом можем считать, что половина дела сделана, самая лёгкая половина. Теперь нужно разрешить нашему скрипту выполняться в среде движка по определённому запросу. Для этого мы отредактируем файл engine.php, который располагается в папке engine. Откроем его любым текстовым редактором и в самом начале увидим длинную цепочку, состоящую из операторов «выбора» case. Здесь мы ставим задачку перед нашим движком, и ему приходится решать, какой модуль подгрузить в зависимости от переданных ему параметров. Для наглядности приведу пример. Вот мы вбиваем в адресной строке браузера ссылку следующего вида:

http://your_site.ru/index.php?do= register

Если вы знакомы с азами протокола tcp/ip, то вы с лёгкостью можете сказать, что по данной ссылке происходит передача переменной do со значением register на обработку сценарием index.php. Но в действительности данную строку будет обрабатывать не index.php, а файл engine.php, который благодаря функции включения (require_once) внедряется в index.php. Итак мы разобрались, каким образом переменные из браузера поступают в сценарий, теперь посмотрим как они обрабатываются. Открыв файл engine.php, мы в самом его начале можем увидеть следующую строку

if (isset ($_REQUEST['do'])) $do = $_REQUEST['do']; else $do = "";

она то и принимает на себя весь «огневой удар» переменных переданных из браузера, здесь как мы видим, в зависимости от того была ли переданная переменная сценарию или нет, происходит создание локальных переменных. Если переменная была передана, то мы создаём её локальный прототип и направляем в оператор switch. И там уже решается, какой модуль подгружать в зависимости от переданного параметра. В нашем случае мы передаём нашему сценарию значение register. Для этого случая предусмотрено подгружения модуля регистрации.

case "register" :
include ENGINE_DIR.'/modules/register.php';
break;

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

Добавим после строк:

case "register" :
include ENGINE_DIR.'/modules/register.php';
break;

Строки подгружения нашего скрипта:

case "test" :
include ENGINE_DIR.'/modules/test.php';
break;

Теперь при запросе из адресной строки браузера по ссылки

http://your_site.ru/index.php?do= test

будет выполняться ваш скрипт, но вот беда, строка Hello world выводится вне контента в самом верху сайта. Это не то, что вы ожидали? Мда, те шаги что мы проделали не последние. Придётся ещё немного потрудится. DataLife имеет шаблонную структуру и поэтому нам придётся для своего модуля создать шаблон, чтобы все данные которые выводятся после выполнения нашего скрипта, оказались в пределах контента. Для этого создадим простейший tpl файл, который будет содержать следующее:

Файл назовём test.tpl и поместим его в папку содержащую файлы шаблона сайта, к примеру в /templates/Default.
Далее мы откроем наш файл со скриптом и не много его отредактируем чтобы все его данные выводились в нашем шаблоне (test.tpl).

<?php

   $test = 'Hello world';

  // Подгружаем шаблон
     $tpl->load_template('test.tpl');
     $tpl->set('{test}', $test);
     $tpl->compile('content');
     $tpl->clear();
?>

Скрипт не много усложнился, но не более того. Воспользовавшись встроенным шаблонизатором мы подгружаем наш шаблон, затем заменяем в нём строку

{test}

на значение переменной нашего скрипта. Далее мы указываем, что наш шаблон должен располагаться в контенте сайта, и в завершение вызываем метод

(clear();)

Вот теперь у вас есть работающий пример создания модуля для DataLife. Я разобрал простейший пример, но этого вполне достаточно, чтобы понять механизм внедрения в движок стороннего скрипта. Для полного завершения нужного проделать ещё несколько операций, а именно сделать доступность данного модуля по красивой ссылки применив чпу. Для этого в корне сайта мы найдём файл .htaccess откроем его текстовым редактором и в конце файла перед строкой

#?>

добавим:

# вывод тестового модуля
RewriteRule ^test(/?)+$ /?do=test

Благодаря этой строчки ваш скрипт будет доступен по ссылкам:

http://your_site.ru/index.php?do= test

http://your_site.ru/ test

И наконец, чтобы антивирус движка не ругался при сканирование сервера, нужно отредактировать файл antivirus.php, располагающийся в папке engine/ajax.

Открываем его в текстовом редакторе, и в длинную череду данных массива

$good_files

вставляем строку:

"./engine/modules/test.php",

Вот теперь ваш первый модуль имеет полную завершённость и вы можете насладится своим успехом в программирование под DataLife. Желаю успехов в постижение нового.

Автор: vssp.ru.