Le plugin additionnel Diogène Géo permet aux administrateurs d’ajouter directement au sein du formulaire d’édition d’un article, une carte et les champs de géolocalisation du plugin SPIP GIS2.
Il nécessite l’installation et la configuration préalable du plugin GIS2.
Configuration des formulaires
Pour activer la prise en compte des informations de géolocalisation dans les formulaires, il suffit à l’administrateur de modifier le masque de Diogène correspondant en sélectionnant dans les champs ajoutés les informations géographique.
Il peut également choisir de ne pas afficher ces champs par défaut en cochant la case idoine, ce qui peut être utile lorsque peu d’éléments seront à géolocaliser. Dans ce cas, l’utilisateur devra choisir d’afficher ou pas les champs afin de les remplir.
Utilisation par les rédacteurs de contenus
Les rédacteurs auront alors dans leur formulaire d’édition une carte et quelques champs supplémentaires.
S’ils ne souhaitent pas ajouter de donnée de géolocalisation, il leur suffit de ne pas remplir ces champs.
Dans le cas contraire, quatre champs sont obligatoires :
- le titre ;
- la latitude ;
- la longitude ;
- le zoom ;
En fonction de la configuration du plugin GIS2, d’autres champs peuvent être affichés, et ne seront pas obligatoires comme :
- le descriptif ;
- les champs d’adresse ;
- le geocodeur permettant de positionner un point en partant d’un adresse ;
Également en fonction de la configuration, si l’option est activée, un rédacteur utilisant un navigateur moderne peut être amené à valider le fait de positionner la carte automatiquement sur sa propre position. Par défaut la carte est centrée sur celle de la configuration de GIS2.
Si le rédacteur édite un objet qui a déjà un point et qu’il souhaite le supprimer, il dispose d’une case à cocher afin de supprimer ce point.
Techniquement
Les pipelines utilisés
Le plugin additionnel s’insère dans plusieurs pipelines propres à Diogene :
-
diogene_ajouter_saisies
pour ajouter la saisie géographique dans le formulaire d’édition d’objet ; -
diogene_charger
récupère les valeurs précédemment postées ; -
diogene_verifier
qui est utilisé au moment de la vérification du formulaire d’édition, il vérifie la validité des champs de latitude, longitude, zoom, titre ; -
diogene_traiter
qui est utilisé au moment du traitement du formulaire d’édition, qui crée, supprime ou met à jour le point lié à l’objet ; -
diogene_champs_sup
qui ajoute dans les champs supplémentaires possibles à activer dans le formulaire d’édition de diogènes les champs de géolocalisation ; -
diogene_champs_texte
qui ajoute dans le formulaire d’édition de diogène la possibilité de demander de cacher la carte par défaut car elle prend beaucoup de place (utile pour les sites qui ne sont pas basés sur la géolocalisation d’objets) ; -
diogene_champs_pre_edition
qui permet de récupérer les informations ajoutés dans le pipeline précédent et les stockera dans le champoptions_complements
de la tablespip_diogenes
; -
em_post_upload_medias
(qui est un pipeline propre à emballe médias et non pas Diogene), dans le cas où l’on vient de mettre en ligne un document de type jpg ou autre qui dispose d’informations géographiques dans ses métadonnées, on associes ces informations à l’article en cours ;