1. goo.gl/iczYR
Создание
custom модуля
yulia.tsyba@volcanoideas.com

2. 2/21
1. Структура модуля
2. Способы создания
3. Стандарты кодирования
4. Настройка редактора, систем управления
версиями файлов для автоматического
контроля стандартов.
5. Подготовка к публикации модуля
на drupal.org

3. 3/21
ИДЕЯ ПОИСК
СОЗДАНИЕ АВТО
МОДУЛЯ
ПРОВЕРКА
РУЧНОЕ
КОДА
SANDBOX

4. 1. Структура модуля 4/21
css
.install
.module .info
PHP
js

5. 1. 5/21
modulename.info

6. 1. 6/21
modulename.install

7. 2. Создание модуля 7/21

8. 2. 8/21

9. 2. Способы создания 9/21
Module Builder + DRUSH
$ drush mbdl
$ drush mb-list
$ drush mb my_module menu --name="My module" --dep=
“views“ --write
$ drush mb my_module --name="My module" --noi --
write --yes

10. 3. Стандарты кодирования 10/21
http://drupal.org/coding-standards

11. 3. Стандарты кодирования 11/21
Настрой свою IDE!
http://drupal.org/node/723470
http://drupal.org/node/1019816

12. 4. Coder 12/21

13. 4. DRUPAL CODE SNIFFER 13/21
PHP_CodeSniffer + Drupal Coding Standards
$ phpcs /path/to/code/my_dir
$ phpcs --standard=Drupal --report=xml --report-file=rep.xml --
extensions=php,module,inc,install /path/to/test
$ alias drupalcs='phpcs --standard=/path/to/drupalcs/Drupal/ruleset.
xml --extensions=php,module,inc,install,test,profile,theme'
$ drupalcs /path/to/test > log.log

14. 4. DRUPAL CODE SNIFFER 14/21
FILE: ...unk/sites/all/modules/contrib/coder/coder_review/coder_review.
drush.inc
--------------------------------------------------------------------------------
FOUND 14 ERROR(S) AFFECTING 14 LINE(S)
--------------------------------------------------------------------------------
22 | ERROR | String concat is not required here; use a single string instead
25 | ERROR | String concat is not required here; use a single string instead
26 | ERROR | String concat is not required here; use a single string instead
53 | ERROR | Missing function doc comment
85 | ERROR | BREAK statements must be followed by a single blank line
93 | ERROR | BREAK statements must be followed by a single blank line
98 | ERROR | BREAK statements must be followed by a single blank line
108 | ERROR | If the line declaring an array spans longer than 80 characters,
| | each element should be broken into its own line
247 | ERROR | Concat operator must be surrounded by spaces
.......................................................................................................................................................
--------------------------------------------------------------------------------

15. 4. PAREVIEW.SH 15/21
Install:
git clone --branch 7.x-1.x http://git.drupal.org/project/pareviewsh.git
sudo ln -s ${HOME}/${DDD}/pareviewsh/pareview.sh /usr/local/bin
Usage:
cd /path/to/drupal
pareview.sh GIT-URL [BRANCH]
pareview.sh DIR-PATH
Online review:
http://ventral.org/pareview

16. 4. SVN PRE-COMMIT REVIEW 16/21
Копируем файл шаблона хука:
cd $REPO/hooks/
mv pre-commit.tmpl pre-commit
Редактируем:
#!/bin/sh
REPOS="$1"
TXN="$2"
/usr/bin/scripts/phpcs-svn-pre-commit "$REPOS" -t "$TXN"
--standard=Drupal >&2 || exit 1
exit 0
Даем права на выполнение:
chmod +x pre-commit

17. 4. SVN PRE-COMMIT REVIEW 17/21
Результаты:
И уже знакомый вывод ошибок:

18. 4. GIT PRE-COMMIT REVIEW 18/21
phpcs-pre-commit
git clone https://github.com/s0enke/git-hooks.git
Копируем файл шаблона хука:
.git/hooks/pre-commit
Редактируем:
PHPCS_BIN = /usr/bin/phpcs
PHPCS_CODING_STANDARD = Drupal

19. 5. Публикация модуля на drupal.org 19/21
1. http://drupal.org/user таб Edit->Git access (Desired Git
username)
2. http://drupal.org/node/add/project-project можно создать проект
- Project categories (модуль, тема, ... ; Категория - Content,
Mobile, ...)
- Vocabularies (Maintenance status, Development status)
- Project information (title, description)
- Project resources
- Revision information
3. release-ready
4. Project application checklist
5. Открыть новый вопрос в http://drupal.
org/project/issues/projectapplications

20. 5. Публикация модуля на drupal.org 20/21
Review bonus
- Issues for Drupal.org Project applications ( выбрать >= 3)
- Reviews of other projects: и дать прямую ссылку на
комментарии
- Issue tags: PAReview: review bonus

21. Вопросы
yulia.tsyba
yulia.tsyba@volcanoideas.com