Главная / Документация / Полное руководство / Разработчикам / Архитектура diafan.CMS / Как устроен модуль /

Инсталляция

Для того, чтобы модуль мог быть установлен опционально создается файл инсталляции модуля. Это файл modules/модуль/модуль.install.php.

В файле определены следующие переменные и функции:

$title – название модуля;
$sql – массив SQL запросов для установки модуля;
$example – массив SQL запросов для установки примеров заполнения модуля;
module_basic_shop() – выполняет действия для основной установки модуля;
module_example_shop() – выполняет действия для установки примеров заполнения модуля;
module_basic_uninstall_comments() – деинсталлирует модуль.

Если у полей таблиц модуля предусмотрено различное содержание для различных языковых версий, то в SQL запросе поле обрабатывается функцией multilang(). Данная функция повторяет код для каждой языковой версии при этом заменяя код LANG на номер языка. Если функции переданы несколько аргументов, то для первого языка выводится первый аргумент, для второго – второй и т. д. Если число языков превышает количество аргументов, переданных функции, то для последующих языков сайта берется последний аргумент.

Пример:

В модуле «Магазин» название товаров переводится. Сайт переводится на 4 языка: русский, английский, немецкий, французский.

// запрос на создание таблицы товаров, структура таблицы дана для примера упрощенная $sql[] = "CREATE TABLE {shop} ( `id` INT(11) UNSIGNED NOT NULL AUTO_INCREMENT, ".multilang("`nameLANG` TEXT NOT NULL DEFAULT '',")." PRIMARY KEY (`id`) ) CHARACTER SET utf8 COLLATE utf8_general_ci;"; // запрос на создание примера заполенения таблицы товаров $example[] = "INSERT INTO {shop} (id ".multilang(", nameLANG").") VALUES (1".multilang(", 'Коршун'", ", 'Vulture'", ", ''").");";

В результате сформируются следующие SQL запросы к базе данных:

CREATE TABLE diafan_shop ( `id` INT(11) UNSIGNED NOT NULL AUTO_INCREMENT, `name` TEXT NOT NULL DEFAULT '', `name2` TEXT NOT NULL DEFAULT '', `name3` TEXT NOT NULL DEFAULT '', `name4` TEXT NOT NULL DEFAULT '', PRIMARY KEY (`id`) ) CHARACTER SET utf8 COLLATE utf8_general_ci;

INSERT INTO diafan_shop (id, name, name2, name3, name4) VALUES (
1, 'Коршун', 'Vulture', '', ''
);

Файл инсталляции используется при установки diafan.CMS, при установки / удалении модуля из административной части, при восстановлении базы данных из административной части.

Не понятно? Уточните