Professional Documents
Culture Documents
Ce document et l'illustration en couverture sont publis sous la licence libre Creative Commons-BY-SA http://creativecommons.org/licenses/by-sa/2.0/fr/deed.fr BY : Paternit. Laurent Jarry alias LJ01 pour le texte, FP pour l'illustration
SA : Partage des Conditions Initiales l'identique. Si vous modifiez, transformez ou adaptez cette cration, vous n'avez le droit de distribuer la cration qui en rsulte que sous un contrat identique celui-ci. En outre, chaque rutilisation ou distribution, vous devez faire apparatre clairement aux autres les conditions contractuelles de mise disposition de cette cration. Chacune de ces conditions peut tre leve si vous obtenez l'autorisation du titulaire des droits.
1/22
Sommaire
Avant Propos Installation et mise jour 1. Installation du composant................................................................................................................................5 2. Installation des plug-ins et du module.............................................................................................................5 3. Mises jour......................................................................................................................................................6 4. Installation de langage.....................................................................................................................................6 Utilisation du composant 5. Panneau d'accueil.............................................................................................................................................7 6. Paramtres globaux..........................................................................................................................................7 7. Cration de catgorie.....................................................................................................................................10 8. Gestion de lieux en backend...........................................................................................................................11 9. Cration de lieux.............................................................................................................................................11 10. Les menus pour les cartes............................................................................................................................12 11. Lgende de personnalisation.......................................................................................................................15 12. Cration de marqueur..................................................................................................................................16 13. Modification du CSS .....................................................................................................................................16 lments en frontend 14. La carte (article + carte)................................................................................................................................17 15. La lightbox et l'affichage des lieux................................................................................................................17 16. Le formulaire de contact..............................................................................................................................18 17. Le filtre..........................................................................................................................................................18 18. L'itinraire.....................................................................................................................................................18 19. GeoXml ........................................................................................................................................................19 20. Le formulaire de soumission de lieux...........................................................................................................19 21. La gestion des lieux en Frontend..................................................................................................................19 22. L'impression..................................................................................................................................................20 Utilisation des plug-ins et du module 23. Plug-in GMapFP............................................................................................................................................21 24. Plug-in Recherche.........................................................................................................................................21 25. Module GMapFP...........................................................................................................................................22 Conclusion
Remerciements de l'auteur du composant Aux quipes de dveloppeurs qui ont cres des composants Google Map pour Joomla. Car ils mont donn le principe de base, mais pas de composant suffisamment complet et adapt mes besoins. Donc, ils mont donn le besoin de dvelopper GMapFP. A la communaut des utilisateurs de GMapFP qui post sur le forum, car ils sont convaincus davoir fait le bon choix (et ils ont raison!) mais ne trouvent pas dans GMapFP le petit truc quil leur manque. Ceux sont eux qui permettent GMapFP dvoluer et d'en faire ce quil est, par leurs demandes et leurs remontes de problme (lments auxquels jessaye toujours de rpondre de faon positive). Et bien sr Phildetroy et LJ01 qui sinvestissent dans ce projet.
2/22
Avant propos
Origine du composant Ce composant a t dvelopp pour le site internet de l'office de tourisme de Chteauneuf-sur-Loire . Son but initial est de pouvoir prsenter des lieux touristiques ou autres sur une carte, et d'associer cette go-localisation les lments ncessaires leurs promotions sous forme d'article. Ensuite GMapFP a t mis la disponibilit de la communaut Joomla, et a fortement volu pour s'adapter aux diffrents besoins de chacun. Ce qui en fait maintenant, un outil trs complet et trs performant. Depuis 2011 une version Pro (objet de cette documentation) existe et complte les dj nombreux paramtrages prsents, offrant des possibilits que vous ne souponniez mme pas Elle est livre avec un mois de support technique, l'ensemble des mises jour tant gratuit. La licence d'utilisation est valable pour un domaine. Site officiel http://www.gmapfp.org
Licence du composant
En aucun cas une entreprise commerciale ne peut vendre une licence d'utilisation GMapFP, ou encore tout ou partie du code source. En revanche elle a tout fait le droit de vendre une prestation base sur GMapFP (Installation, configuration, formation, ...) et den modifier le code pour les besoins dun client, ou encore de vendre des extensions (modules, templates...) dveloppes spcifiquement pour GMapFP. Principes de base GMapFP va tout simplement utiliser les diverses fonctionnalits de Google Maps pour intgrer des cartes dans votre site web, comment ? c'est le travail du dveloppeur En plus le composant vous proposera des fonctionnalits supplmentaires pour agrmenter vos cartes de polygones, d'images, de raccourcis vers des articles, de mise en page, etc. L'organisation de base de GMapFP est simple : une carte avec des marqueurs qui identifient des lieux que l'on peut ranger par catgorie et groupe de catgories. Au dessus ou dessous de la carte on la possibilit d'afficher une personnalisation et bien entendu le descriptif des lieux, un listing, un calcul d'itinraire, etc. Ensuite de simples menus appellerons vos diffrentes uvres personnalisables souhait. Un plug-in permettra galement l'intgration de une ou plusieurs cartes dans vos articles. Cl API Google Maps http://code.google.com/intl/fr-FR/apis/maps/signup.html
Toutes les versions de GMapFP compatibles avec Joomla 2.5 utilisent l'API Google Map V3. Pas besoin donc de Cl API Google Map pour votre site. Remerciements de l'auteur du composant Aux quipes de dveloppeurs qui ont cres des composants Google Map pour Joomla, car ils mont donn le principe de base, mais pas de composant suffisamment complet et adapt mes besoins. Donc, ils mont donn le besoin de dvelopper GMapFP. A la communaut des utilisateurs de GMapFP qui poste sur le forum, car ils sont convaincus davoir fait le bon choix (et ils ont raison!) mais ne trouvent pas dans GMapFP le petit truc quil leur manque. Ceux sont eux qui permettent GMapFP dvoluer et d'en faire ce quil est, par leurs demandes et leurs remontes de problme (lments auxquels jessaye toujours de rpondre de faon positive). Et bien sr Phildetroy et LJ01 qui sinvestissent dans ce projet. Tableau des compatibilits
Version GMapFP pour les nuls 9.xx septembre 2012 3/22
Version 7.x Joomla Version SEF UTF-8 et non UTF-8 Language PHP Extensions Plugin article Module Module carte Plugin Search Plugin Xmap Plugin JCE Composant JoomFish / Falang Xmap JComments Josetta >=4 Standard
Version 8.x
Version 10.x
>=4
>=5
>=5
4/22
Cliquez sur "Choisissez un fichier". Choisissez le fichier GMapFP.zip que vous venez de recevoir. Validez votre slection et cliquez sur "Envoyer & Installer". Un message vous indiquant le bon droulement des oprations apparat : Sucess !
Attention toute dsinstallation du composant entranera la perte totale des lments saisis par la base de donnes.
suppression de
Pensez les activer dans la gestion des plug-ins et modules de votre Joomla! Le Plu-gins GmapFp ncessite une version php => 5.1.0
5/22
3. Mises jour
GMapFP est un composant qui volue, il y a donc des mises jour faire, si vous souhaitez exploiter l'ensemble des fonctionnalits dveloppes. La mise jour est une installation par dessus la composant existant, c'est dire sans suppression de la base de donnes. Vos donnes de lieux ne sont donc pas touches par la mise jour ainsi que le fichier CSS qui n'est plus modifi la mise jour. Pour les plug-ins et le module l'installation se fait directement par dessus la version prcdente. On prendra soin aprs chaque mise jour de vrifier rapidement les grandes fonctionnalits de son site pour ne pas avoir de mauvaise surprise La ractivation du plug-in se fait aussi la mise jour.
4. Installation de langage
GMapFP est natif Joomla!2.5 en Franais et en Anglais par dfaut (Joomla reconnatra donc le franais si vos paramtres de configuration Joomla sont en Franais). Il existe des fichiers de traduction du composant que vous retrouverez dans la section Forum et la section de Tlchargement su site officiel. Au mieux un package.zip existe et s'installe de la mme manire que les prcdents. Au pire il faut tlcharger via un FTP. GMapFP fait appel 3 fichiers positionns dans les rpertoires suivants :
/administrator/language/fr-FR/fr-FR.com_gmapfp.ini /administrator/language/fr-FR/fr-FR.com_gmapfp.sys.ini /language/fr-FR/fr-FR.com_gmapfp.ini contenant la traduction du back-end contenant la traduction du menu composant du back-end contenant la traduction du front-end
6/22
Utilisation du composant
5. Panneau d'accueil
Vous avez donc un nouveau composant disponible dans la liste de vos composants Joomla!2.5.
En un coup d'il vous avez la main sur toutes les fonctionnalits de GMapFP, ainsi que les liens utiles et notamment le forum du site officiel trs dynamique o vous trouverez coup sr les rponses vos questions !
6. Paramtres globaux
Tous les paramtrages suivants ont une info-bulle disposition, ceux sont vos paramtres de bases qui seront slectionns ou pas, par dfaut dans toutes vos cartes. Nanmoins chaque carte pourra tre personnalise, c'est dire que certains de ces paramtres seront aussi accessibles sur chaque carte que vous construirez via un menu ou via le plug-in (se reporter aux sections correspondantes). La premire tape est de rgler quelques fonctionnalits, en cliquant sur Paramtres la fentre s'ouvre. En haut droite il y a Enregistrer. Important ! car lorsque vous descendez dans la fentre des paramtres, il disparat de la vue et la tentation est grande de sortir de cette fentre directement sans sauvegarder ! Ces paramtres sont rassembls par fonction et sous forme d'onglet.
Paramtres Carte
Version GMapFP pour les nuls 9.xx septembre 2012 7/22
Les dimensions Dimension en pixel (px) de la carte affiche en Frontend. La largeur peut tre soit en pixel soit en %, (utile pour faire des ajustements 100%).
La carte Le centre de la carte permet ici de pr positionner la carte lors de la cration des lieux en backend et en frontend, mais permet aussi de positionner l'affichage de la carte en frontend, si le mode centrage automatique n'est pas activ. Vous slectionner galement la presentation de la carte pour la partie administrative cette endroit.
Les types de cartes vous pouvez choisir de ne pas donner un accs toutes les vues possibles en frontend.
Les lments de la carte ils sont dcrits dans la section 14 lments du Frontend.
Affichage des informations Panoramino, Trafic, Mto cette fonctionnalit volue dans Google Maps est dpend donc des volutions de ce dernier.
8/22
Paramtres Affichage
MouseOver = info-bulle au passage de la souris sur le marqueur Click = affichage seulement sur clic
Balise HTML = permet de prciser la mise en page. Cible = type d'affichage possible au clic sur le marqueur.
La Lightbox est la fentre qui s'affichera lors du clic sur le marqueur d'un lieu, on retrouve dans cette fentre des icnes pour imprimer et voir la carte plus prcisment selon les rglages de zoom, ainsi que d'autres options que l'on verra dans la section qui lui est consacre (section 15).
Paramtres Image
Les images que vous allez tlcharger seront diriges directement dans ce rpertoire. Si elles sont dj prsentent une liste droulante est disposition dans la cration d'un lieu. Vous pouvez changer le rpertoire de destination ainsi que la hauteur d'affichage de l'image dans la lightbox.
Paramtres Autres/Geoxml
Jcomments activation de composant (voir section 29). News les nouvelles de votre composant favori s'affichent dans le Backend en dessous de la dotation. Fichier kml saisie du ou des URL de vos fichiers .kml (se reporter la section GeoXml).
9/22
Paramtres Droits
Gestion des droits GMapFP intgre la gestion des droits de Joomla. On se rfrera aux documentations de Joomla pour son utilisation. La gestion des droits n'est fonctionnelle que dans la version Pro.
7. Cration de catgorie
Deuxime tape, non ce n'est pas de crer un lieu, c'est de crer les catgories qui organiserons vos lieux. En effet la cration d'un lieu se fait a minima avec un Nom et une Catgorie, vous pourrez crer autant de Souscatgorie que de besoin. Chose pas si anodine car cela influera bien videmment sur la prsentation de vos cartes surtout si ces catgories sont nombreuses. Alors rflchissez bien aux prsentations que vous souhaitez faire ...
Parent pour la dfinition des sous catgories Droits Intgration de la gestion des droits Joomla!2.5
10/22
A ce niveau vous avez la possibilit de Publier / Dpublier un lieu slectionn Copier l'identique le lieu, qui apparatra sous cette forme non publi Suppression / dition Utilisateur, permet de changer l'auteur du lieu, et donc de donner la gestion de ce lieu un utilisateur en Frontend par exemple, le clic sur un auteur permettra un envoi de courriel. Nouveau Paramtres de configuration du composant Pour la gestion des lieux en Frontend voir la section 21.
9. Cration de lieux
Nous voici la cration d'un lieu, section relativement intuitive. Un nom, un alias (qui est automatique si vous ne le saisissez pas sans caractres spciaux accent et espace) plus une catgorie et le tour est jou votre lieu est cre, mais bien entendu vous lui ajouterez ses coordonnes prcises sa golocalisation ...
Alias L'alias sera repris dans les adresses URL de votre site lorsque le
Saisie Ville Dpartement et Pays sont les champs qu'utilise le Filtre (voir la section consacre). Adressage L'adresse lectronique de votre lieu n'apparatra aucun moment dans le Fontend. Localisation Recherche rapide par adresse ou coordonnes gographiques du style : long : 16.554265380 lat : 7.3244476318
11/22
Image Le rpertoire /images/stories/gmapfp est cr automatiquement l'installation du composant. Il est paramtrable dans les paramtres globaux. L'option galerie photo n'est pas active dans GMapFP 9.x.
Espace descriptif Vous disposez ensuite de deux espaces de saisie pour la description de votre lieu et les horaires et tarifs. GMapFP est sympa il reprend ici votre diteur prfr par dfaut, et la description peut quasiment tre un article (attention tout de mme la surcharge !).
Marqueurs Le choix du marqueur indiquera la position de votre lieu sur la carte (voir la section ddie pour l'ajout de nouveau).
C'est ici qu'il faut publier le lieu, vous avez aussi la possibilit de le faire dans le gestionnaire de
Mtadonnes pour les moteur de recherche Lier un article Si vous slectionnez un article ou saisissez une URL sans slectionner une icne, l'article sera visible directement au clic sur le marqueur. Lorsque vous slectionnez en mme temps une icne celle-ci apparaitra dans la lightbox lors du clic sur le marqueur. L'article s'affiche dans le mme type d'affichage que celui du paramtre Cible.
Pour crer un menu il suffit de vous rendre dans la Gestion des Menus de votre Joomla!2.5 et de choisir GMapFP, plusieurs type de menu sont possibles. Les 2 premiers permettent la cration et la gestion des lieux en Frontend. Les paramtres GMapFP qui permettent de personnaliser vos menus sont dans les onglets droulant de droite. Ils sont nots GMapFP en tte. Les autres sont des paramtres Joomla attribus tous les menus Joomla!2.5.
12/22
menu Formulaire de soumission d'un lieu Propose un menu pour accder un formulaire permettant aux utilisateurs enregistrs de proposer un lieu en Frontend.
Mise en page vous choisissez le modrateur et l'envoi de courriel ce dernier, ainsi que la possibilit de publier automatiquement le lieux sans autorisation.
Listes option d'affichage dans le formulaire en Frontend, restreindre la soumission une catgorie, un marqueur, tlcharger une image, etc.
13/22
menu Affichage complet (tout ou catgories) Permet l'affichage d'une carte avec tous les lieux ou seulement ceux d'une catgorie, toujours se poser la question de ce que l'on veut afficher avant de crer des catgories
Options d'affichage
Choix de la catgorie
Condition WHERE elle permet de prciser les lieux affichs en slectionnant une saisie d'un champ spcifique du lieux. Son criture est la suivante : a.ville = yy avec yy = nom de la ville slectionne
14/22
menu Affichage d'un formulaire contact Permet l'affichage d'un formulaire de contact, seulement si son courriel est renseign lors de la cration.
Choix de la catgorie
cet
15/22
Positionnement La personnalisation se place selon votre choix au dessus ou au dessous de la carte ou de la liste des lieux ou les deux.
Vous avez aussi la possibilit d'avoir une gestion des plug-ins Joomla!2.5 dans les textes de la personnalisation. Par exemple vous pouvez charger dans votre personnalisation un module en position user9 avec la commande {loadposition user9}.
Lorsque vous allez dans la cration de vos lieux, le nouveau marqueur est disponible.
Alors afin d'viter quelques dsagrment on fera une sauvegarde de ce fichier avant toutes modifications, histoire de
16/22
Description
Carte Modes d'affichage et barre de zoom PLUS... de Wikipedia, Trafic Barre de zoom en haut gauche
Si vous ne modifier pas les paramtres, le zoom et le centrage de la carte sont ajusts au mieux selon les marqueurs.
Itinraire
17/22
d'adresse lectronique, ce
message
17. Le filtre
Comme son nom l'indique il permet de filtrer les lments qui apparaissent sur la carte.
Le filtre permet en outre de rechercher un mot ou une donnes saisies dans GMapFP. portion de mot, sur toutes les
18. L'itinraire
GMapFP vous propose aussi la ralisation d'itinraire entre vos lieux. La fonction s'affiche en dessous de votre carte.
S'il n'y a pas de route qui mne votre lieu alors un message vous prviendra qu'une erreur inconnue s'est produite ...
Des listes droulantes vous proposent les lieux que vous avez crs, il n'y a qu' tracer et vous aurez l'itinraire qui s'affiche sur votre carte mais aussi en mode texte.
Vous avez aussi la possibilit de choisir n'importe quelle ville ou lieu cot des listes droulantes ou de croiser les deux.
18/22
19. GeoXml
L'option GeoXml vous permet de faire apparatre sur votre carte des polygones, des images et autres objets cartographiques. Pour cela il faudra disposer d'un fichier .kml. Dans le forum/documentation vous trouverez une mthode trs simple permettant de rapidement construire vos cartes, ainsi que d'insrer des images et des .kml. Depuis la version 7.0 il est possible d'intgrer plusieurs fichiers .kml spars un ;.
Le nom et la description de la zone dlimite apparatront dans une lightbox, ils sont saisir dans Google Maps.
Bien entendu si des champs obligatoires ne sont pas saisis, une fentre apparatra ! Ces derniers deviendront tout rouge !
19/22
22. L'impression
L'icne de la lightbox permet l'impression d'un lieu et de sa description. Les paramtrages d'impression de votre page sont modifiables par le CSS. Cliquer sur imprimer apparat en bas gauche de la fentre qui s'ouvre.
Adressage Ville Dpartement Pays (si les champs sont saisis) Reprise de la description
A cette tape vous avez encore la possibilit de rgler vos zoom et centrage de carte, a c'est agrable !
Itinraire Si l'option Itinraire est active, alors elle sera affiche dans vos pages d'impression, par contre il faudra penser retracer l'itinraire la suite de la carte.
20/22
Vous pouvez mettre autant de paramtre que vous le souhaitez. Chaque paramtre est spar par un espace. Les valeurs de paramtre sont saisies entre guillemets. Voici la liste de l'ensemble des paramtres utilisables.
Paramtre Lieux Catgorie Largeur de la carte Hauteur de la carte Zoom de la carte Itinraire Affichage des types de carte Affichage de la barre de navigation de carte Affichage de l'chelle de carte Affichage du type de slection du marqueur Affichage du menu plus dinfos Affichage de la slection du mode ''Terre'' Affichage de la slection du mode "Mixte'' Affichage de la slection du mode "Relief" Affichage de la slection du mode "Carte" Affichage de la slection du mode "Satellite" Choix du mode d'affichage de la carte par dfaut Affichage d'un fichier GeoXml Affichage de la zone de contrle Activation du zoom par la molette de la souris Indication de la position de centrage manuelle de la carte (longitude et latitude) Cette fonction permet de centrer une carte avec les informations contenus dans l'id slectionn, Lat., Long. et Zoom Syntaxe du paramtre id=''xx'' catid=''xx'' lmap="xxx" hmap="xxx" zmap="xx" itin="1" ou itin="2" bar_psm="1" ou bar_psm="2" bar_z_nav="1" ou bar_z_nav="2" ech="1" ou ech="2" click_over="1" ou click_over="2" more="1" ou more="2" map_earth="1" ou map_earth="2" map_hyb="1" ou map_hyb="2" map_phy="1" ou map_phy="2" : map_nor="1" ou map_nor="2" map_sat="1" ou map_sat="2" map_choix="x" kml_files=''URL'' zzoom="1" ou zzoom="2" mzoom="1" ou mzoom="2" map_centre_lng=''xx,xxxxxxxxx'' map_centre_lat=''xx,xxxxxxxxx'' map_centre_id="id" N de l'id du lieux N de l'id de la catgorie Une valeur en pixel une valeur en pixel la valeur du zoom : 1 18 Prsence absence de l'option Prsence absence de l'option Prsence absence de l'option Prsence absence de l'option Prsence absence de l'option Prsence absence de l'option Prsence absence de l'option Prsence absence de l'option Prsence absence de l'option Prsence absence de l'option Prsence absence de l'option 1=>Carte, 2=>Satellite, 3=>Hybride, 4=Relief Voir la section GeoXml ci dessus Prsence absence de l'option Prsence absence de l'option Longitude et latitude, les deux doivent tre saisis pour fonctionner. Si la fonction "mzoom" est utilise, elle prvaut la fonction zoom de "map_centre_id". Valeur
Un plug-in Search, est un plug-in qui s'installe dans le rpertoire /plugins/search. Il est propre un composant. Si ce plug-in n'existe pas, le module Search de Joomla ne pourra pas trouver de rsultat sur des mots contenus dans le composant. Le plug-in de recherche GMapFP ajoute la case "Lieux" dans la recherche.
Le module de recherche de Joomla donnera tous les rsultats qu'il trouvera dans votre site avec la recherche slectionne. Pour n'avoir que les rsultats contenus dans les saisies de GMapFP (lieux, description, etc.), il faudra cocher la case "Lieux".
Dans les paramtre avancs vous grez le cache. En Frontend le module se prsente sous cette forme, Image droite et Nom du lieu gauche. Un clic sur l'un ou l'autre ouvrira la lightbox.
Dans la documentation Pour les Moins nuls vous avez une solution pur crer un module carte.
En guise de conclusion
Ce manuel ne saurait rpondre toutes les questions que vous vous posez. Cest votre tour de prendre en main GMapFP et de faire votre exprience. Nous souhaitons seulement que ce manuel vous ai guid dans vos premiers pas, et nhsitez pas faire part de vos expriences, de vos remarques et de vos suggestions dans le forum du site http://www.gmapfp.org, la rubrique consacre !
22/22