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
Nom et contenu des fichiers de style

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 :
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 :

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
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