Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
abills:docs:modules:info:ru [2015/12/04 11:53] anton [Info] |
abills:docs:modules:info:ru [2017/10/23 12:09] (текущий) bohdan [Использование] |
||
|---|---|---|---|
| Строка 9: | Строка 9: | ||
| Создать таблицы в базе. | Создать таблицы в базе. | ||
| - | # mysql -D abills < db/Info.sql | + | # mysql --default-character-set=utf8 -D abills < db/Info.sql |
| Подключение модуля. | Подключение модуля. | ||
| Строка 19: | Строка 19: | ||
| </code> | </code> | ||
| + | Создайте папки для хранения документов и картинок: | ||
| + | # mkdir -p /usr/abills/Abills/templates/Info/docs/ | ||
| + | # chown -R apache /usr/abills/Abills/templates/Info/docs/ | ||
| + | # mkdir -p /usr/abills/Abills/templates/Info/images/ | ||
| + | # chown -R apache /usr/abills/Abills/templates/Info/images/ | ||
| + | ==== Структура ==== | ||
| + | Модуль состоит из файлов: | ||
| + | * Abills\mysql\Info.pm | ||
| + | * Abills\modules\Info\webinterface | ||
| + | * cgi-bin\styles\default_adm\js\info.js | ||
| + | * cgi-bin\styles\default_adm\css\info.css | ||
| + | |||
| + | В файле ''cgi-bin\styles\default_adm\js\info.js'' содержатся JavaScript функции для реализации AJAX технологии.\\ | ||
| + | Это позволяет удалять, добавлять и обновлять блок комментариев без перезагрузки страницы. | ||
| + | |||
| + | В файле ''cgi-bin\styles\default_adm\js\info.css'' стили для шаблонов. | ||
| ==== Использование ==== | ==== Использование ==== | ||
| - | Для отображения блока комментариев используется функция ''show_comments($object_type, $object_id)''.\\ | + | Для отображения блока комментариев используется функция ''show_comments($object_type, $object_id, $attr)''.\\ |
| Аргументы функции: \\ | Аргументы функции: \\ | ||
| * $object_type - тип объекта (Название таблицы). Служит для создания уникального ключа идентификации комментариев. | * $object_type - тип объекта (Название таблицы). Служит для создания уникального ключа идентификации комментариев. | ||
| * $object_id - id объекта | * $object_id - id объекта | ||
| + | * $attr - дополнительные атрибуты для tpl_show(); | ||
| Результатом выполнения функции будет вывод HTML-кода с блоком комментариев, в котором присутствуют кнопки для добавления и удаления комментариев.\\ | Результатом выполнения функции будет вывод HTML-кода с блоком комментариев, в котором присутствуют кнопки для добавления и удаления комментариев.\\ | ||
| + | \\ | ||
| + | {{:abills:docs:modules:info:info_comments.png?nolink&800|}} | ||
| + | \\ | ||
| Каждому добавленному комментарию присваивается текущее время и id администратора, который добавил комментарий.\\ | Каждому добавленному комментарию присваивается текущее время и id администратора, который добавил комментарий.\\ | ||
| Строка 32: | Строка 51: | ||
| <code> | <code> | ||
| load_module('Info', $html); | load_module('Info', $html); | ||
| - | info_show_comments('admins', 25); # Show comments for 'admins' table object with id 25 | + | info_comments_show('admins', 25); # Show comments for 'admins' table object with id 25 |
| </code> | </code> | ||
| - | |||
| ==== Внешний API модуля ==== | ==== Внешний API модуля ==== | ||
| - | Для получения списка комментариев используется функция $Info->get_comments ($type, $id) \\ | + | Для получения списка комментариев используется функция $Info->get_comments ($type, $id, $attr) \\ |
| - | Аргументы те же, что и для show_comments();\\ | + | Аргументы функции: \\ |
| + | * $object_type - тип объекта (Название таблицы). Служит для создания уникального ключа идентификации комментария. | ||
| + | * $object_id - id объекта | ||
| + | * $attr - дополнительные атрибуты для SQL-запроса (''SORT'', ''PAGE_ROWS'' , ''DESC'', ''PG''); | ||
| \\ | \\ | ||
| Возвращает массив комментариев для объекта.\\ | Возвращает массив комментариев для объекта.\\ | ||