Presentacion del taller para la introducción al desarrollo de modulos en Drupal 7. Taller realizado en la DrupalCampSpain 2014

1. Introducción al desarrollo
de módulos en Drupal 7
Ruben Egiguren
17/05/2014

2. Acerca de mí
Ruben Egiguren a.k.a. keopx
Profesional: www.isarea.com
Blog: www.keopx.net
Drupal: www.drupal.org/u/keopx
Miembro de:
• Drupal association
• Asociación Española de Drupal
• G.D.O Basque Country
• …
Drupal Developer, Software Libre enthusiast, new technologies and geek

3. Acerca de mí
Programador senior
Drupal Developer, Software Libre enthusiast, new technologies and geek

4. De qué hablaremos
Hablaremos de
• Estándares
• Herramientas
• Organización de módulos
• Organización de código
• Código

5. ¿Quién sabe de qué?
Conocer a los asistentes
•Instalación y crear contenido.
•Editar menús, bloques.
•Instalación y configuracion de modulos.
•Desarrollado algún módulo.
SIN MIEDO

6. Estándares

7. Estándares
Drupal code standars
• https://drupal.org/coding-standards (PHP)
• https://drupal.org/node/172169 (javascript)
• https://drupal.org/node/1886770 (CSS)
Documentación
• https://drupal.org/node/1354

8. Estándares
Netbeans setup
• Estándares: https://drupal.org/node/1019816
• Template: https://drupal.org/project/nb_templates
• Plugin:
• https://drupal.org/node/1764074
• https://github.com/HollyIT/NBDrupalDevel
Eclipse
• https://drupal.org/node/75242

9. Herramientas
Drush
• http://drush.ws/
• https://github.com/drush-ops/drush
Devel
• https://drupal.org/project/devel
Coder
• https://drupal.org/project/coder

10. Estructura de directorios

11. Directorios
• sites/all/modules/contrib - Contiene los módulos de Drupal.org. Nota: no
se modifican estos módulos, sino es para parches. Consejo: mover a
patches.
• sites/all/modules/custom - Módulos desarrollados.
• sites/all/modules/features - Si usa features, usa este directorio para
organizarlo.
• sites/all/themes/contrib - Contiene los temas de Drupal.org. Nota: usa
subtemas.
• sites/all/themes/custom - Temas propios o subtemas.
• sites/all/libraries - Contiene librerías de terceros como el editor wysiwyg
o plugins javascript.
Estructura de directorios

12. Estructura de directorios
Existen múltiples opciones de usar los directorios de
módulos.
Mi preferencia:
|-- sites
| |-- all/site_name
| | |-- modules
| | | |-- contrib
| | | |-- custom
| | | |-- features
| | | |-- patches
Fuente: http://befused.com/drupal/module-directory-structure

13. Organizar el módulo

14. Módulo a medida.
Los módulos suele tener esta estructura:
● mimodulo.info - Fichero de informacion. https://drupal.org/node/542202
● mimodulo.module - Fichero principal, implementación de hook
● mimodulo.install - (Des)Instalador del módulo, esquema de información.
● mimodulo.admin.inc - Callbacks del menú de administración, añadir/editar
● mimodulo.pages.inc - Callbacks de menú públicos, accesible para a todos
● mimodulo.inc - Funciones adicionales.
● includes/ - Contienen clases, vistas,...
● templates/ - Fichero relacionados con el tema (*.tpl.php,...)
● plugins/ - Este directorio para plugins como puede ser Ctools.
● css/ - Estilos CSS.
● images/ - Imagenes.
● js/ - Javascript.
Fuente: http://www.urbaninsight.com/2014/02/24/module-and-theme-organization
Organizar el módulo

15. Qué deberíamos leer/conocer

16. Qué deberíamos leer/conocer
• Existe multitud de material el drupal.org
• Buscar no es difícil
• Lo difícil es saber qué buscar
• Algunas referencias

17. Qué deberíamos leer/conocer
ahh y sobre todo….

18. Qué deberíamos leer/conocer
CONTRIBUIR
ahh y sobre todo….

19. Qué deberíamos leer/conocer
• Trabajando con el API de Drupal
• https://api.drupal.org/api/drupal
• Buenas prácticas

20. Qué deberíamos leer/conocer
Uno de los más habituales son los formularios que nos
aportan multitud de posibilidades.
• api.drupal.org/api/drupal/developer!topics!
forms_api_reference.html/7
Esquema del API de Form
• https://drupal.org/node/165104

21. Qué deberíamos leer/conocer

22. Creando nuestro módulo

23. Creando nuestro módulo
Eres nuevo creando módulos
• http://deeson-online.co.uk/labs/are-you-developer-new-drupal-read
Creating modules - a tutorial: Drupal 7.x
• https://drupal.org/node/1074360
Examples
• https://drupal.org/project/examples

24. ¡Comenzamos!

25. Bonus

26. Bonus
Debug
• asociaciondrupal.es/taller-sobre-debugging-en-php
XDebug
• www.keopx.net/blog/configuracion-de-php-53-y-xdebug
Configuración del entorno:
• https://drupal.org/node/238805

27. Bonus
Por donde empezar a contribuir
Issue
• https://drupal.org/novice
• http://drupalize.me/videos/getting-started-issue-queue

28. Eskerrik asko zuen harretagaitik
GNU/GPL Licence
Gracias por vuestra atención
Thanks for your attention
Gràcies per la vostra atenció