Модуль дозволяє редагувати дані модулів і інтерфейс з призначеної для користувача частини сайту. Модуль складається з двох частин: що підключається частина і обробка запиту на редагування в адміністративній частині.
підключення
Підключається частина - файл modules / useradmin / useradmin.inc.php. У ньому описаний клас Useradmin_inc. У модулі до об'єкту класу можна звернутися через змінну $ this -> diafan -> _useradmin. Примірник класу створюється при першому виклику змінної.
string get (string $ text, string $ name, integer $ element_id, string $ table_name, [integer $ lang_id = 0], [string $ type = '']) - генерує посилання на форму редагування.
- string $ text: значення змінної
- string $ name: назва змінної
- integer $ element_id: номер елемента
- string $ table_name: таблиця
- integer $ lang_id: номер мови
- string $ type: тип даних
// для адміністратора зробимо доступним редагування тексту новини
$ Text = $ this -> diafan -> _useradmin -> get ($ text. 'Text'. $ Id. 'News'. _LANG);
string get_lang (string $ value, string $ name, string $ module_name) - генерує посилання на форму редагування перекладу.
- string $ value: поточний переклад
- string $ name: рядок для перекладу
- string $ module_name: модуль
$ Text = $ this -> diafan -> _useradmin -> get_lang ( 'hello'. 'Привіт'. 'Site');
array | boolean false get_meta (integer $ element_id, string $ module_name) - Отримує посилання для редагування мета-даних через панель адміністрування.
- integer $ element_id: номер елемента
- string $ module_name: модуль
// отримуємо посилання для редагування мета-даних для сторінки новини ID = 3
$ Useradmin_links = $ this -> diafan -> _useradmin -> get_meta (3. "news");
echo '';
echo '';
echo '';
void edit () - генерує дані для форми редагування.
echo $ this -> diafan -> _useradmin -> edit ();
// виведе форму редагування даних, заданих в $ _GET масиві
string type (string $ name) - Повертає тип даних по імені змінної.
- string $ name: ім'я редагованої змінної
echo 'Тип даних поля created:'. $ This -> diafan -> _useradmin -> type ( "created");
// виведе:
// Тип даних поля created: date
для розробника
Використовується в основному в моделях модулів при генерації даних, рідше в шаблоні для надання доступу до панелі швидкого редагування.
Робота з модулем повинна проводитися поза зоною кешування.
// news.model.php
if (! $ this -> result = $ this -> diafan -> _cache -> get ($ cache_meta. 'news'))
$ This -> diafan -> _cache -> save ($ this -> result. $ Cache_meta. 'News');
>
//.
foreach ($ this -> result # 91; "Rows" # 93; as $ Row)
//.
$ row # 91; "Name" # 93; = $ This -> diafan -> _useradmin -> get (
$ row # 91; "Name" # 93 ;, 'name'. $ row # 91; "Id" # 93 ;, 'news'. _LANG
);
$ row # 91; "Anons" # 93; = $ This -> diafan -> _useradmin -> get (
$ row # 91; "Anons" # 93 ;, 'anons'. $ row # 91; "Id" # 93 ;, 'news'. _LANG
);
$ row # 91; "Date" # 93; = $ This -> diafan -> _useradmin -> get (
$ row # 91; "Date" # 93 ;, 'created'. $ row # 91; "Id" # 93 ;, 'news'
);
//.
>
Як працює панель швидкого редагування
Для редагування інформації з призначеної для користувача частини сайту необхідно включити цю можливість для потрібного користувача на сторінці редагування користувача в адміністративній частині. Налаштування «Підключити панель швидкого редагування» з'являється тільки для типів користувачів, яким дозволений доступ до адміністративної частини.
Веб-майстер повинен встановити скрипти для роботи панелі редагування см. Підключення.
Після включення режиму редагування в адміністративній частині, на сайті зверху з'явиться адміністративна панель. На цій панелі потрібно включити режим редагування. Режим включений, коли підсвічений червоним кольором.
При наведенні на редагований елемент з'явиться іконка «Олівець». При натисканні на обраний елемент відкриється спливаюче вікно, в якому ви зможете відредагувати елемент.
Після збереження елемента для подальшої навігації по сайту необхідно вимкнути режим редагування. При вимкненому режимі червоне підсвічування зникне.
modules / useradmin / admin / useradmin.admin.action.php - обробка запиту на редагування даних з призначеної для користувача частини;
modules / useradmin / js / useradmin.edit.js - форма редагування контенту з призначеної для користувача частини, JS-сценарій;
modules / useradmin / js / useradmin.js - панель швидкого редагування, JS-сценарій;
modules / useradmin / useradmin.action.php - подгрузка панелі швидкого редагування;
modules / useradmin / useradmin.css - панель швидкого редагування, CSS;
modules / useradmin / useradmin.edit.php - форма редагування контенту з призначеної для користувача частини;
modules / useradmin / useradmin.edit.css - форма редагування контенту з призначеної для користувача частини, CSS;
modules / useradmin / useradmin.inc.php - підключення модуля;
modules / useradmin / useradmin.install.php - установка модуля;
modules / useradmin / views / useradmin.view.edit.php - шаблон форми редагування даних;
modules / useradmin / views / useradmin.view.get.php - шаблон даних, доступних для редагування за допомогою панелі швидкого редагування;
modules / useradmin / views / useradmin.view.panel.php - шаблон панелі швидкого редагування.