Présentation
- Insérer des cartes dans votre blog
- Ce plugin permet de créer et éditer un type particulier de billet : les éléments de carte. Ces
éléments peuvent ensuite être inclus dans les cartes attachées à vos billets ou à vos pages.
- Attacher une carte à un billet
- Pour attacher une carte à une publication, vous devez auparavant créer les éléments qui y seront affichés.
- Une fois vos éléments créés, rendez-vous sur la page d'édition de cette publication. Sous le champ
Notes personnelles, dépliez la zone Carte Google :, puis cliquez sur Ajouter une
carte.
La carte est ajoutée à la publication. Cliquez ensuite sur Ajouter des éléments pour composer votre
carte.
Configuration
- Activation
- Le plugin doit être activé pour fonctionner sur le blog. La désactivation ne supprime pas les éléments ni
les cartes mais empêche seulement leur affichage.
- Clé d'API
- Le plugin utilise par défaut une clé d'API Google Maps partagée. Il est recommandé de remplacer cette clé
par une clé propre à votre domaine. Vous devrez pour cela créer une clé sur cette page : Google Developers Console > Google
Maps JavaScript API. Une fois votre clé générée, entrez-la dans le champ et enregistrez.
- Options des cartes par défaut
- Déplacer le pointeur sur la carte ou rechercher une adresse pour choisir le centre des cartes par défaut. Le
niveau de zoom ainsi que le style de la carte seront aussi mémorisés.
Ces options seront utilisées lors de la création d'une nouvelle carte.
Style des cartes
Les cartes peuvent être stylées au moyen de fichiers de style. À titre d'exemple, un fichier de style
est inclus dans le plugin, il se nomme Neutral Blue et apparaît à côté des boutons habituels
Plan et Satellite.
Vous pouvez ajouter des styles personnels provenant de votre médiathèque, qui apparaîtront alors sur cette ligne
de boutons. Voici comment procéder :
- Emplacement des fichiers de style
-
- pour ajouter des styles, créez un dossier nommé myGmaps dans votre médiathèque
- dans ce dossier, créez un autre dossier nommé styles
- ranger dans ce dossier vos styles personnels
- Nom et contenu des fichiers de style
-
- le nom d'un fichier de style doit correspondre au masque suivant : mon_style_styles.js où
mon_style est le nom que vous pouvez modifier (ce nom n'est qu'un simple identifiant et
n'apparaîtra pas en partie publique).
-
le contenu du fichier doit contenir un tableau JSON de type :
[{featureType: '',elementType: '',stylers: [{hue: ''},{saturation: ''},{lightness: ''},// etc...]},{featureType: '',// etc...}]
Vous pouvez obtenir de nombreux styles pour vos cartes sur le site Snazzy Maps.
Icônes et fichiers kml personnels
- Icônes personnelles
-
Par défaut, seules quelques icônes sont fournies, mais il est très simple d'ajouter les vôtres :
- dans votre médiathèque, créez un dossier nommé myGmaps
- dans le dossier myGmaps créez un autre dossier nommé icons
- ranger dans ce dossier vos icônes personnelles.
- Fichiers Kml personnels
-
Vous pouvez inclure un fichier Kml en fournissant son URL, ou utiliser un fichier de votre médiathèque. Il
est très simple d'ajouter les vôtres :
- dans votre médiathèque, créez un dossier nommé myGmaps
- dans le dossier myGmaps créez un autre dossier nommé kml_files
- ranger dans ce dossier vos fichiers kml personnels.
Types d'élements de cartes
Tous les éléments sont éditables, voir l'aide dans la page d'édition d'un élément.
- Point d'intérêt
- Une icône est affichée sur la carte.
- Ligne brisée
- Plusieurs points sont présents sur la carte, reliés par une ligne polygonale.
- Polygone
- Plusieurs points sont présents sur la carte, reliés par une ligne fermée matérialisant un polygone.
- Rectangle
- Un rectangle est affiché sur la carte.
- Cercle
- Un cercle est affiché sur la carte.
- Fichier kml inclus
- La carte affiche des objets issus d'un fichier kml. Ils ne sont toutefois pas modifiables. Ce type
d'élément ne peut avoir de description..
- Flux GeoRSS
- La carte affiche des objets issus d'un flux GeoRSS. Ils ne sont toutefois pas modifiables. Ce type
d'élément ne peut avoir de description.
- Itinéraire
- La carte affiche un itinéraire routier entre deux points et un panneau latéral comportant des indications de
conduite. Vous ne pouvez utiliser qu'un seul itinéraire sur une même carte.
Filtres de la liste des éléments
- Auteur
- Permet de filtrer les éléments de cartes par auteur.
- Catégorie
- Filtrer les éléments de cartes par catégorie.
- État de l'élément de carte
-
- En attente : l'élément de carte est en attente de publication. Il ne peut pas
être inséré dans un billet
- Programmé : l'élément de carte sera mis en ligne aux date et heure
indiquées dans le champ Publié le.
- Non publié : élément de carte hors ligne.
- Publié : l'élément de carte est disponible pour l'ajout dans une carte.
- Mois
- Filtre les éléments de cartes d'un mois d'une année donné.
- Type d'élément de carte
- Filtre les éléments de cartes selon le type indiqué.
- Trier par
- Permet de trier les résultats de filtrage selon la date, le titre,
la catégorie, l'auteur ou l'état de publication.
- Trier
- Indique l'ordre dans lequel on souhaite effectuer le tri.
- Éléments de cartes par page
- Nombre d'éléments de cartes à afficher par page de résultat.
Actions par lot sur les éléments
Il est possible d'effectuer un ensemble d'actions sur plusieurs éléments de cartes, d'un
seul coup. Les actions possibles, comme pour les billets, dépendent des permissions de l'utilisateur.
Afficher une carte dans un template
Il est possible d'afficher une carte au sein de vos templates. Utilisez le code :
{{tpl:myGmaps id="home" center="47.389982,0.688877" zoom="12" style="roadmap" width="80%" height="200px" elements="2,4" category="4"}}
- id
- Spécifier un identifiant unique. Si aucun indiqué, un identifiant sera généré à chaque affichage.
- center
- Indiquer le centre géographique de votre carte (Ex: la ville de Tours - Latitude : 47.389982, Longitude :
0.688877)
- zoom
- Entre 0 et 19 (à 0 on voit le monde entier)
- style
- Choix entre roadmap, satellite, hybrid, terrain, OpenStreetMap et neutral_blue. Vous pouvez aussi appeler
votre propre style (Voir plus haut)
- width, height
- largeur ou hauteur spécifiques, en unité CSS (px, em, %, etc.)
- elements
- Les identifiants des éléments de cartes particuliers, séparés par des virgules
- category
- Les identifiants des catégories à afficher, séparés par des virgules