[extension by grum] GMaps

Introduction :

Pour installer le plugin, vous il est éncessaire d'installer au préalable :
- installer/mettre à jour Grum Plugin Classes 3.3.2 ([extension by grum] Grum Plugin Classes)
- installer/mettre à jour Advanced Metadata 0.5.2 ([extension by grum] Advanced Metadata) => Il est conseillé de l'installer en mode avancé et d'alimenter le référentiel pour profiter de toutes les fonctionnalités (photos par catégorie, recherche par géolocalisation)

A quoi sert ce plugin ?
A afficher des cartes Google maps sur la galerie


Comment créer/ajouter une carte ?
1/ dans le premier onglet, on créer une ou plusieurs cartes selon les besoins.
Il y a trois types de cartes :
- les cartes qui s'affichent sur une catégorie (lightbox)
- les cartes qui s'affichent sur la page d'une photo (lightbox)
- les cartes qui s'affichent sur la page d'une photo (affichée comme une métadonnée)
A noter que les cartes créées pour être affichées sur une catégorie ne peuvent être affichée sur la page picture, et inversement.

2/ Dans le deuxième onglet, on effectue des associations entre les cartes créées et les catégories
=> la carte A : affichée sur toute la galerie
=> la carte B : affichée sur la catégorie "machin"
=> la carte C : affichée sur la catégorie "truc"

Le plugin fonctionne de cette façon afin de permettre la personnalisation des cartes au niveau des catégories sans pour autant être obligé de refaire toutes les cartes à chaque fois (en gros, la personnalisation s'effectue sur un modèle lui même paramétré).


Quelles différences avec [extension by rvelices] RV Maps & Earth ?

Zaphod a écrit:

En gros quelles sont les différences avec RV Maps & Earth ?
Doit-on aussi systématiquement passer par une étape de synchro quand on ajoute de nouvelles photos ?

Je pense que je testerai, même si je n'utilise pas (encore) AMetaData...

Pour les différences, ben... à la fois plein et peu. Tu peux personnaliser les cartes pour chacune des catégories, uploader des fichiers KML et les afficher, les afficher sous forme de lightbox, faire des recherches sur zone géographique et remplir ton panier avec le résultat, afficher plusieurs cartes à la fois sur la même page (cf. lien que je donne sur le topic précédent : une carte qui permet de situer le lieu + une carte qui zoome sur le le lieu)

pour la synchro, oui et non : pas besoin de devoir synchroniser pour afficher les cartes sur les photos.
par contre c'est nécessaire d'alimenter le référentiel de AMetaData pour profiter du moteur de recherche et pour disposer de cartes au niveau des catégories...

Customiser les icônes
Il est possible de rajouter des icônes dans le répertoire img du plugin en respectant les principes suivants :
- le nom du fichier est de la forme iXxY_n avec
      X : la largeur de l'icône en pixels
      Y : la hauteur de l'icône en pixels
      n : un numéro incrémentiel => il est conseillé de commencer large, genre dans les 80~90, histoire que si le plugin en rajoute, les icones personnelles ne soient pas écrasées

Avec cette méthode, l'icône sélectionnée sera la même quelque soit le thème de l'utilisateur..
Il est toutefois possible de disposer d'icône dédiées pour un thème donné.
1/ dans le répertoire icons du thème, créer un sous répertoire gmaps
2/ y mettre les fichiers, le nom doit respecter la forme iXxY
      X : la largeur de l'icône en pixels
      Y : la hauteur de l'icône en pixels
Ici on ne gère pas de numéro incrémental => si on choisit une icone 42x28 pour ta carte, et qu'il existe un fichier 42x28 dans ton thème, il sera utilisé.
3/ dans le fichier theme.css il faut déclarer l'icône de la façon suivante :

#icon_gmaps.size42x28 {
  background:url(./../icon/gmaps/i42x28.png);
  width:42px;
  height:28px;
  display:inline-block;
}

(adapter le 42x28 aux dimensions de l'icone, ainsi que l'url relative de celle-ci)


Insérer des cartes dans la description d'une catégorie
Depuis la version 1.2.0 il est possible d'insérer des cartes dans la description d'une catégorie.

Celà s'effectue en insérant une balise [gmaps] avec les paramètres suivants :
id:nnn; - obligatoire - nnn est l'identifiant de la carte
width:nnn; - facultative - nnn est la largeur de la carte exprimée en pixels ; si non renseignée, la largeur par défaut de la carte sera appliquée
height:nnn; - facultative - nnn est la hauteur de la carte exprimée en pixels ; si non renseignée, la hauteur par défaut de la carte sera appliquée
kmlId:nnn; - facultative - nnn est l'identifiant du fichier KML/KMZ
kmlUrl:"xxx"; - facultative - xxx est l'url du fichier KML/KMZ ; à noter que si le paramètre kmlId est renseigné, le paramètre kmlUrl sera ignoré
kmlZoom:x; - facultative - x peut prendre la valeur y ou n ; si la valeur est à y, la carte sera zoomée automatiquement pour afficher le fichier KML ; si non renseigné, la valeur par défaut est n
markerImg:xxx - facultative - xxx est le nom d'un fichier png localisé dans le répertoire img du plugin et permet d'indiquer quel marqueur doit être utilisé ; si non renseigné, la valeur par défaut est mS01_11.png
markerVisible:x; - facultative - x peut prendre la valeur y ou n ; si la valeur est à y, les marqueurs seront affichés sur la carte, si la valeur est à n il ne seront pas affichés ; si non renseigné, la valeur par défaut est y
allowBubble:x; - facultative - x peut prendre la valeur y ou n ; si la valeur est à y cliquer sur un marqueur affiche une bulle avec les miniatures des photos géolocalisées à cet emplacement, si la valeur est à n cliquer sur le marqueur ne fera rien ; si non renseigné, la valeur par défaut est y

Exemples :

[gmaps=id:1;width:320;height:200;kmlUrl:"http://mon.url/mon_fichier.kml";markerVisible:n;]
[gmaps=id:3;kmlId:4;allowBubble:n;markerImg:mS03_03.png;]

Il est possible de mettre plusieurs cartes, mais une même carte avec le même ID ne peut être incluse qu'une seule fois.

Pour connaitre un id, au niveau de la liste des cartes et des fichiers KML, une infobulle est affichée sur l'élément survolé par la souris.


Il est possible via du CSS, d'embellir l'intégration des cartes.
Il faut pour celà définir les propriétés de la classe gmapsMarkup
Exemple :
ajouter une bordure grise de 2px, et insérer les cartes 'dans le texte' :

.gmapsMarkup {
 border:2px solid #dddddd;
 display:inline-block;
}

Dernière modification par grum (2010-11-01 21:18:50)