• Страница 1 из 1
  • 1
Учимся писать модули с админпанелью для DLE

vover6
Друзья
Сообщений 1090
+
+10431
-
Ваши награды 34
1. Создаём файел test.php в директории engine/modules/test.php
2. Создаём файел config.test.php в директории engine/data/config.test.php
3. Создаём файел test.tpl кидаем в ту тему которая у вас по умолчанию

Открываем engine/modules/test.php Внего вставим:
Code
<?php
<strong>require_once</strong>(ENGINE_DIR.'/data/config.test.php');
$txt = $config_test['text'];
$txt_detail = $config_test['detail'];
$version = $config_test['version'];

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


Как видим, в данном модуле все переменные берутся из файла engine/data/config.test.php, и далее уже по известному сценарию мы подгружаем шаблон и производим замену переменных на их значения. В нашем случае будет производится три замены.
Файл engine/data/config.test.php на самом начальном этапе необходимо создать. Его содержимое может быть пустым и в дальнейшем при управление модулем через админпанель код файла engine/data/config.test.php будет генерироваться автоматически.

Теперь откроем шаблон test.tpl и вставим в него:
Code
<html>
<body>
{txt} - <i>{detail_txt}</i>
<p>Версия модуля: {version}</p>
</body>
</html>


На этом можно считать, что фундамент построен и можно двигаться дальше. Займёмся созданием панели администрирования. Для этого откроем файл engine/inc/options.php и увидим в нём двумерный массив $options. Этот массив отвечает за формирования разделов в админпанели движка.

Code
$options['config'] – отвечает за разделы в блоке «Настройки скрипта»
$options['user'] – отвечает за разделы в блоке «Управление пользователями»
$options['templates'] – отвечает за разделы в блоке «Управление шаблонами»
$options['filter'] – отвечает за разделы в блоке «Управление фильтрами»
$options['others'] – отвечает за разделы в блоке «Другие разделы»


Размещать все сторонние модули в массиве:

Code
$options['others']


уже есть некоторые разделы:

Code
array(
'name' => $lang['opt_static'],
'url' => "$PHP_SELF?mod=static",
'descr' => $lang['opt_staticd'],
'image' => "spset.png",
'access' => "1",
),

array(
'name' => $lang['opt_banner'],
'url' => "$PHP_SELF?mod=banners&action=list",
'descr' => $lang['opt_bannerc'],
'image' => "ads.png",
'access' => "1",
),


Добавим к ним свой собственный, но для начала разберёмся в структуре массива раздела

Code
array(
'name' - Переменная, отвечающая за название раздела
'url' - Переменная, отвечающая за ссылку на раздел
'descr' - Переменная, отвечающая за описание раздела
'image' - Переменная, отвечающая за картинку раздела
'access' - Переменная, отвечающая за доступ к разделу
),


Теперь можно создать и наш собственный раздел

Code
array(
'name' => 'Тест',
'url' => "$PHP_SELF?mod=test_adm",
'descr' => 'Настрйка модуля тест',
'image' => "test.png",
'access' => "1",
),


Теперь, если вы зайдёте в админпанель, то увидите в категории «Другие разделы» и ваш, только что созданный тестовый раздел. Одно но, иконка не отображается, и красный крест вместо неё мало радует глаз. А в чём проблема, давайте зайдём в папку engine/skins/images и загрузим туда любую иконку, которая вам нравится, и назовём её test.png. Желательно чтобы её размеры были 48*48, тогда, в админпанели будет царить гармония и симметрия. С разделом вроде разобрались, теперь сделаем возможным вход в данный раздел в админпанели, для этого нужно открыть доступ на файл администрирования, который мы пока не создали, но для дальнейших действий данный шаг является первоочередным. Итак, открываем файл admin.php любым текстовым редактором и видим там массив

Code
$system_modules


Без тени сомнения добавляем туда и наш будущий файл администрирования модуля test_adm, а если быть более точным, вам необходимо добавить строку

Code
'test_adm'=> 'admin'


Данная строка показывает, что файл test_adm.php будет доступен только админам. На этом мы разобрались со всеми доступами и можем приступить к созданию файла администрирования, о котором уже столько было сказано.
Итак, заходим в папку engine/inc и создаём там файл test_adm.php. Открываем данный файл в текстовом редакторе и добавляем туда следующий текст:

Code
<?php
/* Подключаемые файлы */
<strong>require_once</strong>(ENGINE_DIR.'/inc/test.functions.php');
<strong>require_once</strong>(ENGINE_DIR.'/data/config.test.php');

/**
* Сохранение настроек модуля
*/
if ($action == "dosave") {
  $find[] = "'\r'";
  $replace[] = "";
  $find[] = "'\n'";
  $replace[] = "";

if ($member_db[1] != 1) {
  msg ("error", $lang['opt_denied'], $lang['opt_denied']);
}
$handler = @fopen(ENGINE_DIR.'/data/config.test.php', "wb");
fwrite ($handler, "<?php \n\n//Test configurations
  \n\n\$config_test = array(
  \n\n'version' => \"v.1.0\",\n\n");

foreach ($save_con as $name => $value) {  
  $value = trim(stripslashes ($value));
  $value = htmlspecialchars ($value, ENT_QUOTES);
  $value = preg_replace($find, $replace, $value);
  fwrite($handler, "'{$name}' => \"{$value}\",\n\n");
}
   
fwrite($handler, ");\n\n?>");
fclose($handler);

msg ("info", "Строка изменена",
  "{$lang['opt_sysok_1']}<br /><br />
  <a href=\"{$PHP_SELF}?mod=test_adm\">{$lang['db_prev']}</a>");
}

/**
* Вывод header
*/
echoheader("Test", "Админпанель модуля test");

/**
* Вывод блока настроек
*/
opentable();
tableheader('Настройка модуля');
echo<<<HTML
<form action="" method="POST">
<table width="100%">
  <tr>
  <td class="option" style="padding:4px;">
  <b> Текст выводимой строки: </b><br />
  <span class="small"> например: Hello world </span>
  <td align="middle" width="400">
  <input class="edit" style="text-align:center" size="40" value="{$config_test['text']}" name="save_con[text]"></td>
  </tr>
   
  <tr><td background="engine/skins/images/mline.gif" height="1" colspan="2"></td></tr>
   
  <tr>
  <td class="option" style="padding:4px;">
  <b> Комментарий к тексту: </b><br />
  <span class="small"> например: Это ваш первый пример модуля с админпанелью </span>
  <td align="middle" width="400">
  <input class="edit" style="text-align:center" size="40" value="{$config_test['detail']}" name="save_con[detail]"></td>
  </tr>
   
  <tr><td background="engine/skins/images/mline.gif" height="1" colspan="2"></td></tr>
   
  <tr>
  <td class="option" style="padding-bottom:10px; padding-top:10px; padding-left:10px;" colspan="2">
  <input class="buttons" type="hidden" name="action" value="dosave" />
  <input class="buttons" type="submit" name="do" value=" Сохранить " /></td>
  </tr>
   
</table>
</form>
HTML;
closetable();

/**
* Вывод footer
*/
echofooter();
?>


Это самое сердце модуля в данном сценарии реализуется, как графическая веб-форма панели администрирования, так и сохранение введенных данных. В начале мы подключаем файлы test.functions.php и config.test.php. В первом из них реализованы функции, которые отвечают за создание дизайна админпанели, благодаря ним мы имеем более доступный код, неотегащённый лишним html кодом.
Приведу листинг файла test.functions.php, который будет необходимо создать в папке engine/inc.

Code
<?php
if (!defined('DATALIFEENGINE')) {
  die("Hacking attempt!");
}

/**
* Элементы дизайна админпанели
*/
function opentable() {

echo <<<HTML
<table width="100%">
  <tr>
  <td width="4"><img src="engine/skins/images/tl_lo.gif" width="4" height="4" border="0"></td>
  <td background="engine/skins/images/tl_oo.gif"><img src="engine/skins/images/tl_oo.gif" width="1" height="4" border="0"></td>
  <td width="6"><img src="engine/skins/images/tl_ro.gif" width="6" height="4" border="0"></td>
  </tr>
  <tr>
  <td background="engine/skins/images/tl_lb.gif"><img src="engine/skins/images/tl_lb.gif" width="4" height="1" border="0"></td>
  <td style="padding:5px;" bgcolor="#FFFFFF">
HTML;
}

function closetable() {
echo <<<HTML
  </td>
  <td background="engine/skins/images/tl_rb.gif"><img src="engine/skins/images/tl_rb.gif" width="6" height="1" border="0"></td>
  </tr>
  <tr>
  <td><img src="engine/skins/images/tl_lu.gif" width="4" height="6" border="0"></td>
  <td background="engine/skins/images/tl_ub.gif"><img src="engine/skins/images/tl_ub.gif" width="1" height="6" border="0"></td>
  <td><img src="engine/skins/images/tl_ru.gif" width="6" height="6" border="0"></td>
  </tr>
</table>
HTML;
}

function tableheader($value) {
echo <<<HTML
<table width="100%">
  <tr>
  <td bgcolor="#EFEFEF" height="29" style="padding-left:10px;">
  <div class="navigation">$value</div></td>
  </tr>
</table>
<div class="unterline"></div>
HTML;
}
?>


Далее необходимо создать пустой файл config.test.php в папке engine/data (не забудте установить на этот файл права chmod =777). Теперь снова приступим к разбору файла test_adm.php. После подключения файлов мы видим код отвечающий за сохранение введенных данных в веб-форме. Массив данных переданных методом POST заносится в файл config.test.php. Кроме того помимо переданных данных я решил включить в массив статические переменные не требующие частых изменений, в данном случае это переменная

Code
'version' => "v.1.0",


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

Code
$good_files


Добавляем:

Code
"./engine/modules/test.php",
"./engine/data/config.test.php",
"./engine/inc/test.functions.php",
"./engine/inc/test_adm.php",


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

Автор статьи: GreenFest and vover6
«Пред. тема След. тема»
  • Страница 1 из 1
  • 1
Поиск:
Топ пользователей: