Текущее время: 18 окт 2017, 11:23


Учимся писать модули с админпанелью для DLE

Учимся писать модули с админпанелью для DLE

Сообщение HAMMER » 20 янв 2011, 23:23

Учимся писать модули с админпанелью для DLE

1. Создаём файел test.php в директории engine/modules/test.php
2. Создаём файел config.test.php в директории engine/data/config.test.php
3. Создаём файел test.tpl кидаем в ту тему которая у вас по умолчанию

Открываем engine/modules/test.php Внего вставим:
Код: Выделить всё
<?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 и вставим в него:
Код: Выделить всё
<html>
<body>
{txt} – <i>{detail_txt}</i>
<p>Версия модуля: {version}</p>
</body>
</html>


На этом можно считать, что фундамент построен и можно двигаться дальше. Займёмся созданием панели администрирования. Для этого откроем файл engine/inc/options.php и увидим в нём двумерный массив $options. Этот массив отвечает за формирования разделов в админпанели движка.
$options['config'] – отвечает за разделы в блоке «Настройки скрипта»
$options['user'] – отвечает за разделы в блоке «Управление пользователями»
$options['templates'] – отвечает за разделы в блоке «Управление шаблонами»
$options['filter'] – отвечает за разделы в блоке «Управление фильтрами»
$options['others'] – отвечает за разделы в блоке «Другие разделы»

Размещать все сторонние модули в массиве:
Код: Выделить всё
$options['others']


уже есть некоторые разделы:
Код: Выделить всё
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?,
),


Добавим к ним свой собственный, но для начала разберёмся в структуре массива раздела
Код: Выделить всё
array(
‘name’       – Переменная, отвечающая за название раздела
‘url’           – Переменная, отвечающая за ссылку на раздел
‘descr’       – Переменная, отвечающая за описание раздела
‘image’     – Переменная, отвечающая за картинку раздела
‘access’     – Переменная, отвечающая за доступ к разделу
),


Теперь можно создать и наш собственный раздел
Код: Выделить всё
array(
‘name’      => ‘Тест’,
‘url’          => «$PHP_SELF?mod=test_adm»,
‘descr’      => ‘Настройка модуля тест’,
‘image’     => «test.png»,
‘access’     => «1?,
),


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


Без тени сомнения добавляем туда и наш будущий файл администрирования модуля test_adm, а если быть более точным, вам необходимо добавить строку
Код: Выделить всё
‘test_adm’=> ‘admin’


Данная строка показывает, что файл test_adm.php будет доступен только админам. На этом мы разобрались со всеми доступами и можем приступить к созданию файла администрирования, о котором уже столько было сказано.
Итак, заходим в папку engine/inc и создаём там файл test_adm.php. Открываем данный файл в текстовом редакторе и добавляем туда следующий текст:
Код: Выделить всё
<?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 style=»padding:4px;»>
<b> Текст выводимой строки: </b><br />
<span> например: Hello world </span>
<td align=»middle» width=»400?>
<input 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 style=»padding:4px;»>
<b> Комментарий к тексту: </b><br />
<span> например: Это ваш первый пример модуля с админпанелью </span>
<td align=»middle» width=»400?>
<input 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 style=»padding-bottom:10px; padding-top:10px; padding-left:10px;» colspan=»2?>
<input type=»hidden» name=»action» value=»dosave» />
<input 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.
Код: Выделить всё
<?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>$value</div></td>
</tr>
</table>
<div></div>
HTML;
}
?>


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


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


Добавляем:
Код: Выделить всё
«./engine/modules/test.php»,
«./engine/data/config.test.php»,
«./engine/inc/test.functions.php»,
«./engine/inc/test_adm.php»,


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

Автор статьи: GreenFest
АКЦИЯ: Каждому флудеру/оффтопщику - день бана в подарок! Приведи с собой друга и отгреби за двоих!

VIP группа на форуме BestCoding.info

FAQ по SEO (постепенно пополняется)
Мой любимый форум phpBB

HAMMER

Автор темы
Аватара пользователя
Администратор
 
Сообщения: [ 930 ]
Зарегистрирован: 20 янв 2011, 13:54
Откуда: Зеленоград
Благодарил (а): 9 раз.
Поблагодарили: 85 раз.

Вернуться в DataLife Engine (DLE)

Кто сейчас на конференции

Зарегистрированные пользователи: нет зарегистрированных пользователей

cron