Module dolibarr : Cocamap

Présentation du module

Cocamap permet d’afficher des cartes ou des listes de tiers ou de contact sur votre site internet wordpress depuis une catégorie de dolibarr. Ce module est très utile pour afficher par exemple, la liste des points de vente, la carte de vos revendeurs, une carte de vos partenaires, les membres de votre réseau, etc…

Comme la donnée vient directement de votre dolibarr, les données sont systématiquement tenues à jour depuis votre outil de gestion, sans nécessiter une ressaisie sur votre site internet

Cocamap vous permet de générer autant de cartes ou de liste que vous le souhaitez.

Cocamap peut afficher des tiers ou des contacts.

Il est possible de personnaliser pour chaque liste ou chaque carte les données que vous souhaitez afficher :
nom / adresse / code postal / ville / tel / mail / site web / lien vers cette adresse.

De façon à ce que la carte reste lisible même lorsque de nombreux points sont à afficher, la carte peut réaliser des clusters, c’est à dire des points qui se groupent ou non selon le niveau de zoom sur la carte.

Configuration

Le pack contient deux modules :
– contactscategories.zip qui est à installer comme un module dolibarr
– cocamap.zip qui est un module à installer côté wordress.

1. Côté dolibarr
   • Une fois le module installé et activé comme n’importe quel module dolibarr, si vous souhaitez afficher des adresses hors de France, vous devez indiquer une clé API google map dans la configuration du module depuis votre compte google cloud console.
   • Vérifiez depuis accueil > configuration > module que le module REST API est bien actif. s’il ne l’est pas, activez-le.
   • Ensuite, rendez-vous sur votre fiche utilisateur et copiez la clé API de votre compte utilisateur, nous aurons besoin d’enregistrer cette clé au niveau de wordpress.
   • Si vous venez d’activer le module API ou si votre clé API d’utilisateur est vide, générer la après avoir cliqué sur « Modifier » sur votre fiche utilisateur puis en cliquant sur la flèche circulaire qui se trouve près du champ clé API. copiez la clé avec ctrl+C et enregistrez vos modifications sur votre fiche utilisateur.
2. Côté wordpress
   • Une fois le module cocamap installé, comme n’importe quel module wp, vous devez vous rendre dans les paramètres du module (menu carte des contacts dolibarr dans le menu du back office wordpress) et indiquez l’adresse de votre dolibarr et votre clé API d’utilisateur dolibarr. Cette clé API permettra la communication entre dolibarr et votre site internet.

La configuration est terminée ! bien joué !

Utilisation

La page de configuration du module cocamap vous indique les shortcodes et les paramètres que peuvent utiliser ces shortcodes.
Indiquez un shortcode dans votre page wordpress et vous devriez obtenir la liste ou la carte de votre choix.

Shortcodes

Dans les lignes ci-dessous, les shortcodes sont placés entre { } pour être désactivés

• {cocamap} affiche une carte avec les éléments sous forme
• {cocamaplist} affiche les éléments sous forme de liste
• {cocamaplistdptfr} affiche les éléments sous forme de liste, triés par département. Uniquement pour la France

Paramètres des Shortcodes

• type → customer / contact selon que vous souhaitiez les tiers (customer), ou les contacts (contact). Paramètre obligatoire.
• height → hauteur en pixel de la carte (uniquement pour {cocamap})
• cid → id de la catégorie dolibarr dont vous souhaitez afficher les éléments. zoom → valeur de 1 à 13 pour le niveau de zoom de la carte (uniquement pour {cocamap}). Paramètre obligatoire
• center → coordonées GPS (WGS84) pour indiquer le centre de la carte (uniquement pour {cocamap})
• zoom → niveau de zoom à utiliser. Plus le nombre est grand, plus le zoom est puissant (uniquement pour {cocamap}
• address → 1/0 afficher ou non l’adresse, le code postal et la ville
• phone → 1/0 afficher ou non le numéro de téléphone
• mail → 1/0 afficher ou non le mail, par défaut à 0
• website → 1/0 afficher ou non le lien vers le site
• goto → 1/0 afficher ou non le lien vers l’itinéraire

Exemples

• {cocamap type= »customer » height= »600″ cid= »8″ zoom= »6″ center= »48.866667,2.333333″ address= »0″}
  • Cet exemple va affiche une carte des tiers de 600px de haut, en utilisant la catégorie de tiers ID8 de notre dolibarr de démonstration et ne montrera pas l’adresse

• {cocamap type= »customer » height= »450″ cid= »8″ zoom= »8″ center= »48.866667,2.333333″ address= »1″ phone= »1″}
  • Cet exemple va affiche une carte des tiers de 450px de haut, en utilisant la catégorie de tiers ID8 de notre dolibarr de démonstration, montrera l’adresse et le téléphone avec un zoom de départ plus important.

• {cocamaplist type= »contact » cid= »8″}
  • Cet exemple va afficher une liste de contact issue de la catégorie de contact ID8 de notre dolibarr de démonstration.