Creating custom module

goo.gl/iczYR

Создание
custom модуля
yulia.tsyba@volcanoideas.com

2/21

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

3/21
ИДЕЯ ПОИСК

СОЗДАНИЕ АВТО
МОДУЛЯ

ПРОВЕРКА
РУЧНОЕ
КОДА

SANDBOX

1. Структура модуля 4/21

css
.install
.module .info

PHP
js

1. 5/21
modulename.info

1. 6/21
modulename.install

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

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

3. Стандарты кодирования 10/21

http://drupal.org/coding-standards

3. Стандарты кодирования 11/21

Настрой свою IDE!

http://drupal.org/node/723470

http://drupal.org/node/1019816

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

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
53 | ERROR | Missing function doc comment
85 | 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
.......................................................................................................................................................
--------------------------------------------------------------------------------

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

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

4. SVN PRE-COMMIT REVIEW 17/21

Результаты:

И уже знакомый вывод ошибок:

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

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

5. Публикация модуля на drupal.org 20/21
Review bonus

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

Вопросы

yulia.tsyba

yulia.tsyba@volcanoideas.com

Creating custom module

More Related Content

What's hot (13)

Viewers also liked (8)

Similar to Creating custom module (20)

Creating custom module