Утилита "Генератор модуля"

Утилита "Генератор модуля" для iCMS v1.10.3 ( также для 1.10.4). Назначение утилиты — избавить кодера от рутины и дать ему простой инструмент для создания заготовки модуля.

Постановка задачи

Пользователи Инстанта уже знают мои утилиты для генерации компонента и модуля. Данная версия генератора творит заготовку модуля, пустую, но полностью работоспособную, для релиза Инстанта 1.10.3.

Вопросы безопасности

Эта утилита, как и предыдущая, писалась как инструмент программиста, освобождающего его от рутины. Этот человек и так имеет доступ к своему сайту через ftp, а к базе через phpMyAdmin. Поэтому в ней отсутствуют механизмы безопасности. То есть совершенно! Утилита абсолютно бесполезна для чайников, ничего не понимающих в программировании, поэтому для них и не предназначалась.
Тем не менее, ни в коем случае не храните утилиту в корне удаленного сайта. Единственный способ ее использования — на локальном сайте. Если Вы создали сайт на локальном сервере, перед выкладыванием его на хостинг убедитесь, что моя утилита не отправится "зайцем" на удаленный сайт!

Работа с утилитой

Распакуйте утилиту в корень локального сайта. В адресной строке браузера наберите имя локального сайта, слэш, имя утилиты (sitename.my/generator_mod.php). Внимательно читайте инструкции, все необходимые указания там есть. Заполните поля формы:
1. Имя папки модуля, латиницей. Все модули Инстанта начинаются с префикса "mod_", поэтому в поле этот префикс уже подставлен. Допишите имя папки. Это имя является уникальным и не может совпадать с именами других папок модулей Инстанта.
2. Название модуля по русски. Будет показываться в админке.
3. Название модуля по русски. Будет выводится в качестве заголовка модуля на сайте (если вывод заголовков включен).
4. Автор модуля. Полагаю, это Вы. Я для вас только утилиту написал!
5. Галка публикации модуля. По умолчанию установлена. Можете снять ее, если не хотите публиковать модуль немедленно. Включить/выключить публикацию модуля всегда можно потом, из админки.
6. Админка модуля. Тут две опции: нужна/не нужна. Если вы задумали сотворить модуль без админки, поставьте радиокнопку "Нет". Если Вы укажете "Да", будет создана админка с расширением xml.
7. Позиция, в которую выводится модуль. Здесь есть один подводный камень. Утилита зачитывает файл позиций текущего шаблона, и предлагает соответствующий список. Поэтому советую перед сотворением модуля установить шаблон и включить его. Если Вы не переключили сайт на свой шаблон, Вам придется изменять позицию вывода позже, из админки, руками.
8. Включение заголовка модуля из пункта 3.
9. Укажите, какой шаблон модуля. Выбрать можно два: "module.tpl" и "module_simple.tpl". Если Вы планируете написать свой шаблон (или он у Вас есть и уже лежит в дефолтном шаблоне), Вам придется это сделать позже, из админки, нажав на шестеренку модуля и прописав имя шаблона руками.
10. Префикс таблиц. По умолчанию, естественно, "cms_". Если при установке Инстанта на сервер Вы прописали другой префикс, укажите его здесь.

Пока Вы не нажали на кнопку "Создать модуль", никакого изменения в файлах и базе сайта не произойдет. Если Вы оставили галку публикации модуля, сразу после сотворения модуль покажется у Вас на сайте в той позиции, которую Вы ему указали.

После сотворения модуль умеет делать два действия: выводит мем "Здравствуй, мир" и распечатывает содержание конфигурационного массива. Остальное зависит от вашего мастерства программиста. Открывайте файлы модуля редактором и предавайтесь творческой работе. Утилита сделала за Вас всю рутину. Модуль уже подключен к сайту, то есть никаких sql-запросов выполнять не надо.

Дизайн

Дизайн специально сделан кошмарным. Это я прикололся так. Это чтоб вы скорее, закончив работу, удалили утилиту.

Завершение работы

Если необходимо создать два модуля подряд, Вам придется после первого раза закрыть в браузере вкладку с утилитой (скрипт прекратит действие). После этого можно вновь открыть утилиту и повторить с другим модулем.

После создания модуля ОБЯЗАТЕЛЬНО УДАЛИТЕ утилиту из корня сайта. Иначе вы можете позабыть это сделать, и она окажется на удаленном сервере. Поскольку механизмов защиты в ней нет, злоумышленник получит прямой доступ к вашей БД через sql-инъекции.

Теперь пройдите в админку и убедитесь, что модуль появился в списке модулей. Нажмите шестеренку, чтобы настроить количество выводимых модулем фиговин. Кроме того, вам придется зайти в настройки модуля (карандашик) и выбрать страницу, на которой он будет выводится. Ну, или, поставьте галку "Показывать на всех страницах". Не забудьте нажать кнопку "Сохранить". После этого можете полюбоваться свежесотворенным модулем на страницах своего сайта.

Как скачать

Скачать можно по прежнему, из тут, из моего профиля. В архиве сама утилита и одноименный текстовый файл с подробной инструкцией.

Куда говорить спасибо

яд 410011913797936
wmr 342960323367

Удачи в программировании!