Пишем модуль под Drupal. Часть 1. Определение модуля.

вт, 30.03.2010 20:36 :: olk

Для того чтобы Друпал «увидел» модуль, нам необходимо создать директорию (с именем соответствующим названию модуля) в пути где друпал ищет модули (обычно это /sites/all/modules) и создать два файла имя_моуля.info и имя_моуля.module.

Давайте, что бы перейти к конкретике и не оперировать вымышленными или условными именами, дадим нашему модулю имя. Назовем его для примера - cctracker. (В данном случае приставка «cc» - для тех, кто обладает чувством юмора, расшифровывается как - «Cool code») Итак приступаем.

Шаг номер 1: Создаем директорию /sites/all/modules/cctracker (путь указан относительно корня сайта) Шаг номер 2: Создаем в директории /sites/all/modules/cctracker файл cctracker.info со следующим содержанием

Я постараюсь подробно комментировать все файлы прямо внутри кода, или давать пояснения после листинга файлов. Все файлы надо сохранять, с кодировкой UTF-8 без BOM, желательно применять unix-овый формат конца строки.

  1. ;; Не обязательно, но желательно
  2. ;; Id - это идентификатор используемый СVS сервером сайта drupal.org для
  3. ;; автоматической идентификации вашего проекта (если вы вдруг
  4. ;; соберетесь опубликовать свой модуль на данном ресурсе
  5. ; $Id$
  6.  
  7. ;; name - собственно наименовние вашего модуля
  8. name = Cctracker
  9.  
  10. ;; Не обязательно
  11. ;; Описание вашего модуля. Данное описание будет видно на странице admin/build/modules
  12. description = Enables extending tracking.
  13.  
  14. ;; Не обязательно
  15. ;; Зависимость вашего модуля от других модулей. Здесь мы устанавливаем зависимость
  16. ;; от стандартных модулей comment - что бы выводить в наш трэкер количество комментариев
  17. ;; и от модуля statistics - что бы показывать количество просмотров для данного материала
  18. dependencies[] = comment
  19. dependencies[] = statistics
  20.  
  21. ;; Не обязательно
  22. ;; Пакет в который устанавливается модуль. В принципе это просто
  23. ;; поле группировки для списка модулей, если не знаете что написать,
  24. ;; то просто пропустите этот параметр,
  25. ;; я же следую своей традиции, помещу модуль в секцию Ccpackages - где располагаются
  26. ;; все разработанные мною модули
  27. package = "Ccpackage"
  28.  
  29. ;; core - указывает на версию ядра Друпала
  30. core = 6.x
Шаг номер 3: Ну и создаем файл cctracker.module пока со следующим кодом

  1. <?php
  2. // $Id$
  3. /**
  4.  * File: cctracker.module
  5.  * Enables extending tracking.
  6.  */
Вообще то вместо File: cctracker.module в комментариях, надо бы использовать @file для корректной идентификации Doxygen formatting conventions, но я что бы не запутать вас, буду в начале каждого фрагмента указывать непосредственно имя файла.

Вот собственно и все, что нужно, что бы Друпал увидел наш модуль (т.е. на странице admin/build/modules - должен присутствовать модуль cctracker). При этом если у вас уже включены модули comment и statistics, то модуль должен быть доступен для включения. Другое дело, что он пока не несет ни какой функциональной нагрузки.

Добавить комментарий
« Добавить комментарий
» Добавить комментарий