Часть 2. Создание своего модуля для Битрикс :: Управление сайтом

Начнем с главного вопроса: что надо сделать, чтобы создать свой модуль для Битрикс? Как это ни странно будет звучать, но практически ничего. Посмотрев раздел «Управление модулями» в Битрикс SDK мы обнаружим, что формально для описания своего модуля нам понадобится всего три файла:

«/include.php»

«/options.php»

«/install/index.php»

Не так много работы, верно? Тем не менее, в этой статье мы постараемся дать более широкие требования к оформлению модуля. Во-первых, это даст более точное представление о том, что нам придется каждый раз делать при создании своих модулей, а во-вторых, позволит делать эти модули максимально похожими на стандартные, что упростит потом их поддержку и развитие. Забегая вперед, мы можем показать дерево каталогов внутри нашего модуля гостевой книги:

Рис. 1. Дерево каталога модуля гостевой книги.

Коротко опишем, для чего понадобятся те, или иные каталоги.

«Classes/general» понадобится для описания класса CIX_Guestbook, который будет регулировать роли пользователей.

Раздел «/Help» будет содержать пользовательскую документацию и справку для разработчиков.

Каталог «install» понадобится нам для описания класса ix_guestbook, который как раз и будет заниматься регистрацией модуля в БУС. Он же зарегистрирует шаблоны для почтовых нотификаций, описанных в разделе «/install/events/».

В каталоге «/install/templates» мы опишем компоненты для использования нашей гостевой книги в визуальном HTML-редакторе.

Особое внимание обратим на каталог «/install/lang/». Обычно возникают определенные трудности с пониманием, куда и какие константы класть. Например, если мы хотим, чтобы русские константы были доступны внутри файла

«/bitrix/modules/ix_guestbook/install/templates/ix_guestbook/index.php»

надо было создать файл

«/bitrix/modules/ix_guestbook/install/templates/lang/ru/ix_guestbook/index.php».

Для создателей БУС это вполне очевидно, а для нас, увы, оказалось нет. Теперь перейдем к подробностям.