Пишем модуль под 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-овый формат конца строки.
;; Не обязательно, но желательно
;; Id - это идентификатор используемый СVS сервером сайта drupal.org для
;; автоматической идентификации вашего проекта (если вы вдруг
;; соберетесь опубликовать свой модуль на данном ресурсе
; $Id$

;; name - собственно наименовние вашего модуля
name = Cctracker

;; Не обязательно
;; Описание вашего модуля. Данное описание будет видно на странице admin/build/modules
description = Enables extending tracking.

;; Не обязательно
;; Зависимость вашего модуля от других модулей. Здесь мы устанавливаем зависимость
;; от стандартных модулей comment - что бы выводить в наш трэкер количество комментариев
;; и от модуля statistics - что бы показывать количество просмотров для данного материала
dependencies[] = comment
dependencies[] = statistics

;; Не обязательно
;; Пакет в который устанавливается модуль. В принципе это просто
;; поле группировки для списка модулей, если не знаете что написать,
;; то просто пропустите этот параметр,
;; я же следую своей традиции, помещу модуль в секцию Ccpackages - где располагаются
;; все разработанные мною модули
package = "Ccpackage"

;; core - указывает на версию ядра Друпала
core = 6.x

Шаг номер 3:
Ну и создаем файл cctracker.module
пока со следующим кодом

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

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

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