Personalizar un bundle existente

Esta guía permite entender los ajustes que son posibles realizar para personalizar el comportamiento de un bundle que se ofrece en el portal SIU-Huarpe.

Esta opción es válida cuando:

• NO se desea realizar un fork del portal
• NO se desea personalizar en profundidad un bundle
• se necesita aplicar configuración que se quiera tener en la imagen Docker
• usando imagen Docker original, se modifica en forma simple un bundle existente

A tener en cuenta:

• normalmente no es necesario ajustes al archivo Dockerfile original
• Se debe contar con un repositorio y registro privado donde alojar la imagen Docker! No puede ser público.

Donde alojar los cambios

Al personalizar un bundle, es recomendable contar con un repositorio Git, un lugar donde:

• guardar el archivo Dockerfile
• guardar las modificaciones al bundle
• guardar los archivos adicionales que quieran modificar de los originales

En Symfony, los bundles se pueden sobreescribir. Mas detalles en la documentación oficial.

Ejemplo

Supongamos que vamos a personalizar el bundle MapucheBundle, se redefine el template de la vista correspondiente a Recursos Humanos -> Vacaciones y Licencias con alguna personalización propia.

Personalizar las plantillas

Para personalizar el diseño de la plantilla Twig, por ej, copiamos el siguiente plantilla de la vista:

src-bundles/SIU/MapucheBundle/Resources/views/Mapuche/vacaciones_licencias/vacaciones.html.twig

Utilizando el mecanismo de personalización de plantillas de bundles en Symfony, se debe copiar la plantilla al destino:

templates/bundles/MapucheBundle/Resources/Mapuche/vacaciones_lcencias/vacaciones.html.twig

Organización del repositorio

El repositorio propio donde ir alojando los cambios, deberá tener una estructura similar a esto:

├── MapucheBundle
│   └──Resources
│      └── vacaciones_lcencias
│         └──  vacaciones.html.twig

Construir y empaquetar

A partir de este punto, el proceso consiste en construir y publicar la imagen Docker, siguiendo los pasos indicados aquí.