1. Drupal
Contribuir
Ruben Egiguren (keopx)
06/05/2017

2. Me podéis encontrar en:
▸ Blog: www.keopx.net
▸ Drupal: www.drupal.org/u/keopx
▸ Twitter: @regiguren
Me llamo
Ruben Egiguren
(keopx)

3. Podéis encontrarnos en:
▸ Web: www.biko2.com
▸ Drupal: www.drupal.org/Biko2
▸ Twitter: @biko2
Trabajo en

4. Definimos,
diseñamos
y construimos
negocios digitales

5. Podemos presumir de trabajar con ...
¿Te interesa unirte a Biko? ¡Búscanos!

6. ¿Te vienes a
?

7. Introducción

8. Introducción
Objetivo
▸ Crear las bases para contribuir a Drupal.
▸ Facilitar recursos para poder comenzar.
▸ Tener un entorno para poder continuar en el
futuro.
▸ Pautas para no morir en el intento.

9. Por dónde empezar
Prepararnos para el sprint
▸ Regístrate en drupal.org.
▸ Leernos la documentación para novatos y
conocer el proceso a seguir.
▹ https://www.drupal.org/novice
▸ Instalar el entorno LAMP o similar.
▹ docker-compose: Linux & Mac:
▹ https://github.com/keopx/docker-drupa
l-contrib
▹ Acquia Dev Desktop
▹ Otros.

10. Por dónde empezar
Prepararnos para el sprint
Configura un cliente de IRC.
▸ https://www.drupal.org/irc
▹ Únete a los canales #drupal,
#drupal-contribute, #drupal-es y
relacionados.
▹ También se puede usar Slack o HipChat si
se hace en un grupo específico, pero el IRC
es un buen lugar.

11. Por dónde empezar
Atribuciones

12. Por dónde empezar
Estados de las issues
Templates for issue status transitions

13. Por dónde empezar
Prepararnos para el sprint
▸ Configurar un IDE con los coding standards de
Drupal.
▹ https://www.drupal.org/coding-standards
▹ Herramientas adicionales:
▹ Coder
▹ PAReview.sh
Si no cumples los coding standards tus
parches/módulos/temas nunca serán
publicados.

14. Por dónde empezar
Más recursos
▸ Importante leerlo: Recursos para contribuir,
generación de parches, como aplicarlos, etc.
▹ https://www.drupal.org/contribute/development
▸ Conocer una experiencia real y ver cómo hacerlo:
▹ http://2014.drupalday.es/sesion/publica-tu-proye
cto-en-drupalorg.html
▹ Video: https://vimeo.com/113362254
▹ Slides:
http://2014.drupalday.es/sites/default/files/
publica_tu_proyecto_en_drupal.org_.pdf

15. Contribuir a Drupal

16. No es difícil
▸ Contribuir al core no significa que tengas que
ser un crack.
▸ Hay tareas de todo tipo y de todos los niveles,
pero antes es necesario leerse estos apuntes
para conocer los procesos a la hora de
contribuir.
▸ Hasta yo lo he hecho :D

17. Novice
▸ Para empezar a contribuir lo primero es buscar
una issue novice.
▸ Es el mejor camino para empezar a realizar las
primeras aportaciones.
▸ Para ello podemos usar el siguiente enlace:
▹ https://www.drupal.org/project/issues/sear
ch/drupal?project_issue_followers=&issue
_tags_op=%3D&issue_tags=Novice

18. Novice - interdiff
▸ Para realizar los parches que se actualicen, es
necesario añadir los ficheros interdiff para
facilitar al resto de colaboradores la lectura de
los cambios entre un parche y otro.
▸ El proceso parece complejo, pero al final resulta
más sencillo de lo que es.
▹ https://www.drupal.org/documentation/git/i
nterdiff
Nota: Procurar siempre que sean issues del tipo
minor o normal para facilitar las cosas.

19. ▸ Una de las acciones más sencillas puede ser
hacer un reroll.
▸ Qué es exactamente hacer un reroll:
▹ El parche existente, aun estando bien,
resulta que por cambios en otros issues, ha
afectado a la issue actual.
▹ Por tanto el parche no se puede utilizar y
necesita reajustarse para su uso.
▹ https://www.drupal.org/patch/reroll
▹ No necesita cambios, solo adaptarse.
Novice - reroll

20. ▸ Podemos encontrar issues de ese tipo aquí:
▹ https://www.drupal.org/project/issues/sear
ch/drupal?project_issue_followers=&issue
_tags_op=%3D&issue_tags=Needs+reroll
Nota: Procurar siempre que sean issues del tipo
minor o normal para facilitar las cosas.
Novice - reroll

21. ▸ La issue no existe. Buscad bien.
▸ Coger una plantilla existente para rellenar la
información y publicar el parche que consideres
oportuno poniéndolo en need review.
▸ A partir de ahí, es cuando empieza la comunidad
a intervenir.
▸ Si tienes cualquier cuestión no dudes en
preguntar.
▸ Aquí podemos encontrar dichas plantillas:
▹ https://www.drupal.org/issue-summaries
Creación de issues

22. ▸ En cualquier caso podemos utilizar las issues
existentes.
Recordad: Procurar siempre que sean issues del tipo
minor o normal para facilitar las cosas.
Issues genéricas

23. ▸ Otro lugar para poder comenzar son los módulos
contrib, aunque no siempre resulta sencillo por
varios motivos.
▹ No sabes que deberia de hacer exactamente.
▹ No lo has hecho tú, aunque si es
medianamente drupalero no deberías tener
problemas.
Contrib

24. De cualquier manera, siempre hay tareas sencillas
para poder hacer:
▸ Añadir rutas de configuración.
▸ Añadir composer.json.
▸ …
Usad siempre el git del módulo para ver cómo
aplicar los cambios y crear los parches.
Contrib

25. ▸ Suele más accesible contactar con alguien que
lleve un módulo que alguien del core.
▹ Facilita mucho el tener feedback.
▹ O comprender mejor la necesidad de la
incidencia.
▸ Tendemos a solucionarlo para nuestros casos.
▸ NO SEAS PEREZOSO y comparte ese parche con
la comunidad, es bueno para ti, para ellos y para
el resto de la comunidad.
Contrib

26. ▸ Aquí está el listado de las personas que son las
encargadas de mantener cada
componente/modulo/tema:
▹ https://api.drupal.org/api/drupal/core!MAIN
TAINERS.txt/8
Maintainers

27. Crear nuestros propios módulos y contribuir a la
comunidad.
▸ Que no exista el módulo.
▹ Sino hace lo mismo, comenzar el proceso.
▹ Mejor colaborar que competir.
▸ Si existe, crear nuevas features para el módulo
que exista.
▸ Asegúrese de que su aplicación contiene un
enlace de repositorio (sandbox) y proyecto.
Project Application

28. Crear nuestros propios módulos y contribuir a la
comunidad.
▸ Cualquiera puede crear su módulo
▸ Pero!!!!!
▹ Que no exista el módulo.
▹ Sino hace lo mismo, comenzar el proceso.
▹ Mejor colaborar que competir.
▹ Si existe, crear nuevas features para el módulo
que exista.
▹ Asegúrese de que su aplicación contiene un
enlace de repositorio y proyecto.
Drupal.org security advisory
coverage applications

29. Estas son lecturas casi obligadas si deseas construir tu
propio módulo/theme.
▸ Project application checklist
▸ Review process for Full Project Applications
▸ Apply for permission to create full projects (no
necesario)
▸ https://www.drupal.org/project/projectapplications
▸ PAReview.sh (recomendado - revisar codigo)
▹ PAReview.sh (vía web)
▸ Coder
▸ Review bonus (acelerar el proceso - obligatorio)
Drupal.org security advisory
coverage applications

30. La recomendación más importante que te
puedo dar es que busques a un mentor
que te ayude.
Drupal.org security advisory
coverage applications

31. Recursos

32. ▸ Aquí está el listado de las personas que son las
encargadas de mantener cada
componente/modulo/tema:
▹ https://api.drupal.org/api/drupal/core!MAIN
TAINERS.txt/8
Recursos - Maintainers

33. ▸ https://www.drupal.org/novice
▸ https://www.drupal.org/irc
▸ https://www.drupal.org/contribute/development
▸ https://www.drupal.org/coding-standards
▸ http://2014.drupalday.es/sesion/publica-tu-proyect
o-en-drupalorg.html
▹ Video: https://vimeo.com/113362254
▹ Slides:
http://2014.drupalday.es/sites/default/files/pu
blica_tu_proyecto_en_drupal.org_.pdf
▸ http://blog.worldempire.ch/story/how-contribute-d
rupal
Recursos - Antes de empezar

34. ▸ https://www.drupal.org/contribute/core
▸ Make patch
▸ Advanced patch contributor guide
▸ https://www.drupal.org/patch/apply
▸ https://www.drupal.org/documentation/git/interdi
ff
Recursos - Drupal Core

35. ▸ Novice:
▹ https://www.drupal.org/novice
▹ https://www.drupal.org/project/issues/search/
drupal?project_issue_followers=&issue_tags
_op=%3D&issue_tags=Novice
▸ Reroll:
▹ https://www.drupal.org/patch/reroll
▹ https://www.drupal.org/project/issues/search/
drupal?project_issue_followers=&issue_tags
_op=%3D&issue_tags=Needs+reroll
Recursos - Drupal Core

36. ▸ https://www.drupal.org/issue-queue
▸ https://www.drupal.org/issue-queue/status
▸ Attribute this contribution
▸ Templates for issue status transitions
▸ Issue submission form fields
▸ https://www.drupal.org/issue-summaries
(plantillas para las issues)
▸ https://dreditor.org/ (plugin Chrome/Firefox)
▸ https://www.drupal.org/sprint-task-cards
▹ Spanish Task Cards
Recursos - Drupal Core

37. ▸ Project application checklist
▸ Review process for Full Project Applications
▸ Apply for permission to create full projects
▸ https://www.drupal.org/project/projectapplications
▸ PAReview.sh (recomendado - revisar codigo)
▹ PAReview.sh (vía web)
▸ Coder
▸ Review bonus (acelerar el proceso - obligatorio)
Recursos - Project Application

41. Biko2
www.biko2.com
+34.91.436.48.54
info@biko2.com
Ruben Egiguren (keopx)