→ Как добавить свой модуль на drupal.org

Этот материал не актуален, с момента перехода drupal.org на систему контроля версий Git.

Итак, вы сделали рабочий модуль для drupal. Что же дальше? Сделать заметку в своем блоге, которую увидят только те, кто читают ваш блог и те, кто угадают ваше описание, искав что-то подобное в Google. Так не пойдет, особенно если у вас есть желание поделиться. Вам нужно выложить ваш модуль на сайте drupal.org. С чего же начать? Да, не так уже все и сложно.

Сегодня (18 апреля 2010 г.) я выпустила официальный релиз модуля по ранее опубликованному сниппету в записи Мухоловка — количество запросов заблокированных CAPTCHA. Более всего мне было интересно дадут ли CVS аккаунт, так как слышала истории, о том что с этим бывает сложно. Так вот, CVS аккаунт для доступа к репозиторию cvs.drupal.org дали уже на второй день. Процедура стандартная. Следующим этапом является оформление страницы с модулем и загрузка модуля в CVS репозиторий. посему и решила написать как и чего.

Этап 1. О чем это я (т.е. вы)?

Для начала, как можно подробнее опишите о что делает ваш модуль и для чего он нужен. Затем переведите все это на английский язык. И добавьте в ваш модуль файл README.TXT, где и будет это описание. Это же описание добавите на страницу вашего проекта.

Этап 2. Наводим порядок

Во все файлы модуль добавьте первую строку, по принципу:

  • для PHP и JavaScript файлов внутри <?php ?>
    // $Id$
  • в файлах CSS
    /* $Id$ */
  • в файле .info
    ; $Id$
  • в текстовых файлах
    $Id$

Загляните в Системный Журнал (admin/reports/dblog) на наличие PHP ошибок в вашем модуле. При помощи модуля Coder проверьте код вашего модуля и поправьте где нужно.

Этап 3. Запрос и получение доступа к репозиторию cvs.drupal.org

Зайдите или зарегистрируйтесь на drupal.org, перейдите на страницу CVS application form и заполните необходимые поля. Дальше либо смотрите почту, либо загляните в ваш трекер и увидите там сообщение с темой «Ваше_Имя_Пользователя [Ваше_имя_пользователя]». Упаковываете ваш модуль в ZIP или GZIP и прикрепляете в первом камменте меняя статус на “needs review”. А дальше по стандартной процедуре будет вопрос(ы), отвечая на которые ставьте статус „needs review“. Как только получите статус “fixed”, значит вы получили CVS аккаунт. Проверьте почту ответ будет там.

Этап 4. Создание страницы проекта

Создание странцы проектаКак только вам дадут понять, что вы получили CVS аккаунт, вы сможете добавлять страници проектов и все что для этого нужно. На странице "Create content" добавятся:

  • Book page — для написания более подробной инструкции к вашему модулю — handbook;
  • Image — для скриншотов к модулю;
  • Project — сам проект;
  • Project release — для создания релиза проекта.

При создании проекта обязательно заполняйте поле CVS directory оно обязательное (хотя и написано что можно не заполнять), например /modules/короткое_название_модуля/.

Дополнительно

В дополнение к моему личному опыту, рекомендую прочитать следующее:

  • Apply for contributions CVS access
  • Start a new project

Следующий материал: Как добавить проект в CVS репозиторий cvs.drupal.org (Cygwin).

Комментарии