Cuándo incluir elementos de navegación
Cuando se desarrolla una aplicación web (p.ej. una calculadora, un mapa...), una de las cuestiones que es necesario definir es cuál es el sitio web en el que se va a publicar. En muchos casos, la aplicación se insertará en el Portal de la Junta de Andalucía, ya sea en el portal principal o en la web orgánica de una consejería o agencia.
Todas las plantillas de página contempladas en el Sistema de diseño de la Junta de Andalucía incluyen una cabecera (con identificación del sitio y menú de navegación) y un pie de página personalizado. Por tanto, si la aplicación se presenta integrada en un sitio web que cumpla el sistema de diseño es necesario incorporar la cabecera y el pie de página apropiado.
Cómo incluir la cabecera y el pie
Hay dos alternativas sencillas para incluir la cabecera y el pie de un sitio web en tu aplicación:
Componentes web de cabecera y pie
Dentro del catálogo de componentes web de la Junta de Andalucía puedes encontrar:
- matter-header: representa la cabecera y el menú de navegación a partir de los datos disponibles en un fichero json.
- matter-footer: representa el pie de página a partir de los datos disponibles en un fichero json.
En ambos casos, para utilizar los componentes web es necesario disponer de un conjunto de datos en formato json (que incluye la información para construir el contenido, p.ej. la jerarquía de la navegación y la ruta de las imágenes). En el caso del portal principal y las webs orgánicas, estos datos se pueden obtener a través del siguiente microservicio:
- Microservicio de exportación de datos para los webcomponents de cabecera y pie (solo accesible desde RCJA).
- Documentación del microservicio de exportación de datos (con autenticación, solo accesible desde RCJA).
De esta forma se pueden obtener la cabecera y el pie de página del portal principal y de las webs orgánicas integradas en él.
API de apoyo a las adaptaciones gráficas
La API de apoyo a las adaptaciones gráficas es un servicio ofrecido desde la plataforma para facilitar la incorporación en cualquier aplicación web de una manera sencilla de los elementos gráficos más comunes: la cabecera, el pie de página y el tema bootstrap oficial de la Junta de Andalucía.
Frente a la solución descrita anteriormente (la inclusión directa de los componentes web de cabecera y pie), esta API aporta las siguientes ventajas:
- La versión de los web components y del tema bootstrap se actualiza automáticamente, lo que garantiza que se muestre siempre la última versión alineada con la utilizada en el Portal Junta de Andalucía, sin necesidad de hacer cambios en el desarrollo.
- La configuración de los web components (microservicio de exportación de datos) se incluye automáticamente, aislando de esa complejidad al equipo de desarrollo.
- Incluye URLs absolutas en los enlaces del menú hacia otras secciones del Portal Junta de Andalucía, para garantizar que no se rompen.
Toda la información sobre cómo utilizar el servicio de la API de apoyo a las adaptaciones gráficas se encuentra en el siguiente repositorio de gitlab:
- Proyecto API gráfica en gitlab (con autenticación, solo accesible desde RCJA).
La documentación incorpora ejemplos de uso para desarrollos basados en distintas tecnologías:
- Java
- PHP
- Python
- Ajax
El alta de nuevas webs orgánicas en la API de apoyo a las adaptaciones gráficas se realiza bajo demanda. Para solicitar el alta de un nuevo organismo, contacta con cau.transparenciayportal@juntadeandalucia.es.