Plugin Gis para Spip. Google maps y Spip

12 marzo 2007

Esta es la documentación para el plugin Gis que el equipo de escoitar.org ha creado para el CMS SPIP.

El plugin Gis está desarrollado para la versión 1.9.2 de SPIP

Podeis descargar el plugin desde el trac zone de Spip, en esta dirección:

http://files.spip.org/spip-zone

En este directorio podeis encontrar varios .zip, que se correspondes a diferentes plugins de spip, entre ellos uno que se llama gis.zip, podeis hacer clic sobre el y comenzará la descarga. Una vez en tu ordenador, descomprime el archivo y sube la carpeta gis a tu servidor, dentro de la carpeta plugins de tu sitio spip.

Una vez subida la carpeta gis, vas a la parte privada de la web y activas el plugin.

Luego debes configurarlo, por lo que tienes que ir a Configuración y hacer clic en Configurar Plugin Gis .

Ahora tenemos que conseguir la llave de Google maps para que podamos usar su API en nuestra página web, por lo que haremos clic en el link conseguir, o en este link.

Dentro de la página de Google, aceptamos los terminos del contrato, marcando la casilla correspondiente, y ponemos la url de nuestra página web, donde utilizaremos la API de google maps, por ejemplo: www.escoitar.org, y le damos a generar google maps API key.

Luego seleccionamos la llave que nos aparece y la copiamos:

A continuación, vamos a la ventana de la configuración de nuestro plugin, pegamos la llave, le damos a ok, e ya tenemos nuestro plugin configurado. Por lo que podemos comenzar a publicar artículos:

Para publicar un artículo con google maps desde la parte privada, escribimos un nuevo artículo, ponemos el titulo, una cabecera, un texto y le damos a registrar.
Luego en la ventana del artículo, hacemos clic en un botón que se llama desplegar:

Hacemos clic en el mapa para marcar el punto a ubicar (aparece un icono y unas coordenadas más abajo), y le damos al botón actualizar, que hai al lado de las coordenadas para registrar los datos:

Vemos como efectivamente, el icono aparece ahora cada vez que vamos al artículo. Si quisieramos cambiar la ubicación en el mapa, volveriamos a darle a desplegar.

Agora solo nos falta hacer que el mapa aparezca en la parte pública, para lo cual pondremos la siguiente linea de código en nuestro esqueleto, donde queramos que apareza el mapa:

Si no se incluye dentro de un contexto, mostrará todos los artículos de la página, pero si se incluye dentro de, por ejemplo, un bucle rubrique, o poniendo un número en los criterios de selección del inclure anterior, como por ejemplo {id_rubrique=1}, solo mostrará en el mapa los artículos de ese contexto; en este caso, los artículos incluídos en la rubrique 1.

El globo que aparece en el mapa, al hacer clic sobre un icono de ubicación, mostrará la cabecera del artículo (#CHAPO) y la primera imagen que subamos como documento del artículo, asimismo también aparecerá un reproductor mp3, si adjuntamos un mp3 como documento.

BALIZAS Y BUCLES DEL PLUGIN:
Se ha creado un bucle gis para recoger las coordenadas de ubicación del artículo en el mapa:
Asimismo se crearon las balizas #LAT y #LONX, para recoger las coordenadas de ubicación del artículo.

Ejemplo de un bucle gis:


#LAT
#LONX

ACTUALIZACIÓN 20/03/07 [10550]:
Se ha implementado en el mapa poder acceder a los artículos dinámicamente desde fuera del mapa, de forma que teniendo una lista de artículos, haciendo clic en eloos, aparezcan automáticamente en el mapa.

Para que esto suceda, simplemente debemos crear un bucle com el que sigue:

La novedad está en la siguiente linea, que debe de estar escrita como sigue:

ACTUALIZACIÓN 28/04/07 [11688]:
Ha sido modificado el plugin para que fuera compatible con Internet Explorer.Hai importantes cambios a la hora de construir un esqueleto, sin los cuales no se verá el mapa Podeis hechar un ojo a estes cambios en la
página de test del plugin

PRÓXIMAS VERSIONES:
En versiones próximas se creará una nueva baliza #ZOOM, y un formulario para añadir un artículo con googlemaps desde la parte pública.

Truco: Si queremos mostrar un mapa para cada un de los artículos, incluiremos la linea

dentro del esqueleto article.html, y en el link que nos dirige a este artículo pondremos lo seguinte:

+ haremos un bucle gis dentro de un bucle articles, donde guardar las variables de longitud y latitud del artículo:


#SET{latitude,#LAT}
#SET{lonxitude,#LONX}

+ Y en el link que dirige a ese artículo pondremos lo seguinte:

AUTORES DEL PLUGIN:
Horacio González (horaciogd‘at’vhplab‘p’net)
Berio Molina (berio‘at’alg-a‘p’org)