Málaga city council CKAN Extension
HTML Python CSS JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
ckanext
ckanext_malaga.egg-info
Readme.md
setup.py

Readme.md

Logo datos abiertos Málaga

ckanext-malaga

El Portal de Datos Abiertos del Ayuntamiento de Málaga se ha implantado a partir de la plataforma CKAN.

CKAN es un portal de código abierto, diseñado y desarrolado para que los gobiernos locales y estatales puedan publicar y compartir su datos abiertos fácilmente.

ckanext-malaga es la extensión que el Centro Municipal de Informática CEMI ha desarrollado para adaptar la plataforma a las necesidades específicas del ayuntamiento.

Instalación y configuración del portal de datos abiertos.

Los pasos para reproducir el portal de datos abiertos del Ayuntamiento de Málaga son los siguientes:

Requisitos

  • ckanext-malaga usa la extensión ckanext-contacto, por lo que tiene que estar instalada también.

  • Esta extensión funciona en versiones de CKAN iguales o mayores a 2.3 (CKAN responsive), no está probada en versiones anteriores.

  • Versión compatible para CKAN 2.8 con bootstrap 2.

Descarga de la extensión

  • Conectarse a la máquina de CKAN con el usuario de ckan.
  • Ir al directorio de instalación de la extensión (en nuestro caso):

cd ckan/lib/default/src

* Clonar la extensión

git clone https://github.com/damalaga/ckanext-malaga

* Desplegarla

python setup.py develop

Configuración del fichero ini para CKAN 2.8

Para que siga usando bootstrap 2, añadir la siguiente configuración en el fichero .ini y reiniciar apache2:


# Uncomment following configuration to enable using of Bootstrap 2
ckan.base_public_folder = public-bs2
ckan.base_templates_folder = templates-bs2

Configuración de la extensión

Añadir la siguiente configuración en el fichero .ini y reiniciar apache2:


Añadimos la extension en ckan.plugins
ckan.plugins = .... malaga

Añadimos el listado de mapeos y las ubicaciones de los html correspondientes en la variable ckan_mlg.before_map:

ckan_mlg.before_map={'aplicaciones':'snippets/aplicaciones.html','detallestecnicos':'snippets/detallestecnicos.html', 'soporte':'snippets/soporte.html','disponibilidad':'snippets/disponibilidad.html'}


configuracion relacionada con el fichero de licencia
licenses_group_url = # Fichero de licencias en nuestro caso seria file:///home/ckan/ckan/lib/default/src/ckanext-malaga/ckanext/malaga/public/licencias.json

Funcionalidades implementadas:

  • Carrusel de la pantalla principal con bootstrap.
  • Opción "aplicaciones" en el menú principal que abre una sección con el listado de aplicaciones que usan nuestros catálogo de datos.
  • Tablero de grupos y organizaciones.
  • Formulario de contacto usando la extensión ckanext-contacto.
  • Modo responsive (compatible para móviles).

Slides de carrusel:

El carrusel usa el módulo bootstrap que incluye CKAN. La configuración y uso de la misma está hecha según la documentación oficial de la misma.

El carrusel se compone de cinco slides, los tres primeros: recuento de recursos, etiquetas más populares y estadísticas, se generan periódicamente (cada día por ejemplo) mediante un cron que crea un html estático con el contenido del slide. Con esto evitamos consultar la información cada vez que se accede al home del portal. El cron tiene las siguientes órdenes:


wget http://URL/home/snippets/generarcarrusel/get_carousel_tags.html -O /home/ckan/ckan/lib/default/src/ckanext-malaga/ckanext/malaga/theme/templates/home/snippets/carousel_tags.html

wget http://URL/home/snippets/generarcarrusel/get_carousel_stats.html -O /home/ckan/ckan/lib/default/src/ckanext-malaga/ckanext/malaga/theme/templates/home/snippets/carousel_stats.html

wget http://URL/home/snippets/generarcarrusel/get_carousel_resources.html -O /home/ckan/ckan/lib/default/src/ckanext-malaga/ckanext/malaga/theme/templates/home/snippets/carousel_resources.html

Siendo get_carousel_XXXX.html el html que recopila la información y carousel_XXXX.html el contenido estático.

NOTA: Una vez instalado esta extensión, hay que ejecutar los tres ficheros html para que se rellenen con información, porque inicialmente están vacíos.

Tablero de grupos y organizaciones

Inicialmente se recopilan los grupos y organizaciones del portal. Cada grupo/organización tiene dos imágenes de 50x50 píxeles uno con el nombre del grupo/organización y otro fichero con el nombre del grupo/organización terminado en "on".

Las imágenes de los grupos y organizaciones están clasificados según nuestras necesidades, por lo que los iconos sólo aparecen si los grupos y organizaciones existen, en otro caso, no aparecerá ninguna imagen.

Formulario de contacto

Los desarrolladores que usen nuestra API, pueden rellenar un formulario de contacto para que demos de alta su aplicación en nuestra página de "aplicaciones disponibles", para ello, hemos usado una extensión que hemos desarrollado y que está disponible en (https://github.com/damalaga/ckanext-contacto)

Federación:

La federación del portal en datos.gob.es se hace ahora con una extensión independiente a esta que también ha sido desarrollada por el CEMI.

La federación está disponible en ckanext-federador

Licencia:

El código de esta aplicación puede ser reutilizado, modificado y adaptado a las necesidades de los distintos portales de forma libre. Si utilizas nuestro código o parte de él, por favor, incluye nuestro logo en el cabecero o pie de página a modo de reconocimiento a Datos abiertos Málaga. Gracias!

Logo datos abiertos Málaga