Plugin image-map des départements

Un plugin pour afficher la carte de France des départements en image-map (image réactive)

Ce plugin propose un modèle pour afficher une carte de France des départements en image réactive: cf cet exemple http://galactron.org/Utilisation-du...

Installation

Pour récupérer les fichiers de ce plugin vous pouvez:

  • soit utiliser les listes d’installation de /plugins/auto dans la page de gestion des plugins de votre SPIP
  • soit récupérer la version svn ( version de développement ) sur la zone spip :
    svn co svn://zone.spip.org/spip-zone/_plugins_/imagemap_departements
  • soit télécharger le zip de la dernière version sur https://files.spip.net/spip-zone/

Pour l’installation et l’activation, suivez la procédure standard: cf la documentation officielle

Lors de l’installation il sera créé dans votre base de données une table supplémentaire spip_imap_departements dans laquelle les données des 95 départements métropolitains seront intégrées.

Utilisation

L’ajout de la carte réactive dans un article ou un squelette se fait en utilisant un modèle SPIP: pour plus de précision sur leur fonctionnement, voir la page de documentation des modèles.

Le modèle departements.html mis à disposition dans ce plugin peut donc être appelé:

  • soit dans un article: <departements|parametre1=X|parametre2=Y...>
  • soit dans un squelette: [(#MODELE{departements}{parametre1=X, parametre2=Y, ...})]

Ce modèle propose les paramètres suivants:

  • |redim=... : le facteur de redimensionnement de la carte (par defaut = 1, ce qui correspond a une carte de 479x434 pixels). Pour une carte plus grande donner une valeur supérieure à 1, pour réduire la taille de la carte donner une valeur inférieure. (NB: les valeurs non-entière peuvent êtres passées indifféremment avec une virgule ou un point comme séparateur)
    Exemples: |redim=0.8 pour une carte réduite à 80% de sa taille par défaut, ou |redim=2 pour doubler la taille de la carte
  • |lien_base=... : l’url des liens sur les départements. Par défaut cette url sera celle de la page en cours (appel de la balise #SELF).
    Exemples: |lien_base=toto.html enverra vers la page toto.html lorsque l’on cliquera sur un département, |lien_base=spip.php?page=contact permet d’envoyer vers la page contact.html de votre SPIP
  • |lien_param=... : le paramètre de l’url qui passe le numéro de département. Par défaut ce paramètre est depart=..., ce qui donne comme url du lien sur les Bouches du Rhône (si on place ce modèle dans l’article n°123): .../spip.php?article123&depart=13.
    Exemple: |lien_param=num donnera des url de liens du style .../spip.php?article123&num=13
  • |param=nom : permet de passer le nom du département à la place du numéro comme valeur du paramètre |lien_param. On obtient donc par exemple: spip.php?article123&depart=seine-et-marne à la place de spip.php?article123&depart=77 (c’est la balise #NOM_WEB qui est utilisée, cf partie “Personnalisations”)
  • |mono=1 : par défaut la carte utilisée est en couleurs, ce paramètre permet d’utiliser une version de la carte en mono-teinte.
  • |aff_region=1 si on souhaite afficher la région en plus du nom du département dans l’info-bulle qui apparait au survol d’un département
  • |bullehtml=1 : par défaut l’info-bulle utilisée est générée par un script JavaScript (Cluetip de jQuery) qui ne permet pas son affichage lors de la navigation au clavier (= pas accessible pour les navigateurs vocaux par exemples). Cette option permet d’utiliser l’info-bulle native HTML qui elle apparait lors de la navigation au clavier.

Personnalisations

Ce plugin est essentiellement fait pour fournir un “fond de carte” à partir duquel on va pouvoir ajouter des données concernant les différents départements.

Les données intégrées lors de l’installation du plugin permettent de disposer des balises suivantes:

  • #NUM_DEPARTEMENT : le numéro du département
  • #NOM : son nom
  • #REGION : sa région de rattachement
  • #NOM_WEB : son nom modifié pour pouvoir être utilisé dans une URL (suppression des accents et des guillemets, remplacement des espaces par un tiret)
  • #COORDONNEES : les coordonnées de l'<area> HTML du département pour la carte à sa taille "par défaut"

Pour personnaliser ce modèle procédez comme pour n’importe quel fichier de squelette: une copie dans le répertoire /squelettes/modeles du fichier imagemap_departements/modeles/departements.html vous permettra de réaliser toutes les bidouilles que vous souhaitez en matière de données à afficher.

Pour ce qui est des infos-bulles, de nombreux paramètres d’affichages sont disponibles: voir la documentation du plugin jQuery Cluetip

Chaleureux remerciements à Lionel Delvarre (http://www.lion1906.com/) pour avoir bien voulu diffuser sa carte de France avec son image-map sous licence GPL.

updated on 2 October 2019

Discussion

Aucune discussion

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom