Présentation
Ce plugin, couplé au plugin Google Maps API permet d’afficher des cartes GoogleMaps sur les pages publiques du site. Les articles et mots-clés du site peuvent être géolocalisés par des marqueurs sur les cartes. Un clic sur un marqueur permet d’afficher les informations de l’article associé (titre et lien vers l’article, chapo, logo, lecteur mp3).
Installation et paramétrage
Avant d’utiliser ce plugin vous devez installer et configurer le plugin Google Maps API.
Ce plugin est développé pour une compatibilité avec SPIP 1.9.2.
Après avoir téléchargé l’archive sur votre disque dur, décompressez-la et déposez - via FTP - le dossier Gis dans le dossier plugins de votre site SPIP.
Une fois cette opération effectuée, rendez-vous dans l’espace privé de votre site et activez le plugin.
Publier des articles en utilisant GIS
Lors de l’affichage d’un article dans l’espace privé, cliquez le bouton “Déplier”.
Il faut cliquer sur la carte pour marquer un point à faire apparaître (une icône apparaît ainsi que des coordonnées placées en dessous). Puis enclencher le bouton actualiser, qui se trouve à côté des coordonnées.
On voit comment l’icône apparaît effectivement à cet endroit à chaque fois que l’on va sur l’article. Si l’on veut changer la localisation sur la carte, il faut recliquer sur déplier et actualiser la position du marqueur.
Utilisation dans les squelettes
Pour faire apparaître la carte dans la partie publique, on doit ajouter ces quelques lignes de code entre les balises <head> et </head> du squelette où l’on souhaite publier la carte :
<INCLURE{fond=inc-gis_map}{id_rubrique}{id_mot}{id_auteur}
{recherche}{id_article}{zoom}{latit}{lonxit}{type=xxx}>Si on ne l’inclut pas dans un contexte, cette boucle retournera tous les articles de la page. Si on l’inclut dans un contexte, dans une boucle rubrique, par exemple, ou en posant un numéro dans les paramètres de l’inclusion précédente, comme par exemple :
{id_rubrique=1}la carte publiera les articles de ce contexte ; ici, de cette rubrique 1.
Le paramètre {type=xxx} permet de définir le type de carte à afficher. Il est optionnel et peut prendre plusieurs valeurs :
- satellite (valeur par défaut si le paramètre n’est pas défini)
- carte
- hybride
Puis ajouter ce code à l’endroit où vous voulez faire apparaître la carte dans votre squelette :
<div id="map" style="width: 700px; height: 400px; top:0px"></div>
La bulle qui apparaît sur la carte, lorsque l’on clique sur l’icône de localisation, fera apparaître le chapeau de l’article :
#CHAPOainsi que la première image que l’on chargera en document de l’article, ou le lecteur de mp3, si l’on a ajouté un mp3 comme document de cet article.
Truc : Si l’on veut une carte pour chaque article, on inclura les codes cités précédemment dans le squelette article.html et dans le lien pointant sur chaque article : + on fera une boucle gis dans une boucle articles, qui conservera, elle, les variables de latitude et de longitude de l’article :
- <BOUCLE_centrado(GIS){id_article}>
- #SET{latitude,#LAT}
- #SET{lonxitude,#LONX}
- </BOUCLE_centrado>
+ ainsi qu’un lien pointant sur cet article :
<a href="[(#URL_ARTICLE)&zoom=16[&latit=(#GET{latitude})]
[&lonxit=(#GET{lonxitude})]]">#TITRE</a>Balises et boucles du plugin
On crée une boucle gis pour récupérer les coordonnées de localisation de l’article sur la carte ; et de la même façon on crée les balises :
#LAT, pour récupérer les coordonnées de l’article.
Exemple de boucle gis :
Ouverture d’une bulle d’info depuis un lien
On peut accéder aux articles de manière dynamique depuis l’extérieur de la carte, de telle sorte que face à une liste d’articles, un simple clic sur ceux-ci les fasse apparaître automatiquement sur la carte. Pour activer cela, il suffit de créer une boucle telle que :
Dans ce cas, il faut ajouter une nouvelle ligne, écrite ainsi :
<a href="javascript:abrirVentana([(#ID_ARTICLE)])">Personnalisation des marqueurs
Il est possible de personnaliser l’apparence des marqueurs présents sur la carte. Pour cela créez un groupe de mots-clés nommé marker_icon et attribuez un logo aux mots-clés de ce groupe.
Remarque : l’image doit être aux mêmes dimensions que les marqueurs d’origine (20 pixels de large et 34 pixels de haut) et enregistrée au format png transparent.
Ensuite lorsqu’on attache un mot-clé de ce groupe à un article ou une rubrique, le logo du mot-clé est bien affiché sur la carte à la place du marqueur par défaut.
Superposition de fichiers KML
Vous pouvez joindre un fichier kml à vos articles ou rubriques et le contenu de celui-ci sera affiché sur la carte de l’espace public.
Pour générer ce type de fichier vous pouvez utiliser le site de google maps et cliquer sur l’onglet mes cartes. Après avoir dessiné les tracés sur votre carte, il faut cliquer sur le lien KML (en haut au-dessus de la carte) pour télécharger le fichier.
Insertion de la carte dans un article
On peut aussi utiliser le modèle fournit par le plugin pour afficher une carte dans la partie publique. Pour cela il suffit d’ajouter ce code dans le texte de votre article :
<carte_gis1|id_article=9>
On peut passer les mêmes paramètres au modèle que lors de l’inclusion du squelette présentée plus haut dans cet article (id_rubrique, id_article, id_mot, id_auteur, recherche, zoom, latit, lonxit, type=xxx). Deux autres paramètres sont disponibles pour définir la taille de la carte :
- width
- height
Prochaines versions :
Les prochaines versions de ce plugin permettront de créer une nouvelle balise #ZOOM, ainsi qu’un formulaire pour ajouter un article avec Googlemaps dans l’espace public du site.
Auteurs du plugin :
Traductions de l’interface
L’interface est traduite en ce jour en :
galicien
espagnol
français
J’utilise spip 1.9.2c
RSS 2.0