Module Google

 = Informations =

= Fonctionnalités = Intègre des fonctions Google dans Dolibarr:
 * Synchronise les tiers, contacts ou adhérents saisi dans Dolibarr vers Google Contacts.
 * Ajoute un menu avec une vue d'agenda Google dans un onglet à côté de l'onglet vue agenda standard.
 * Synchronise tout événement saisi dans Dolibarr vers l'agenda Google.
 * Ajoute un pictogramme à coté des adresses. Un clic fait apparaître l'adresse au sein d'une carte Google Maps.
 * Offre une vue sur Google Maps de la position de tous ses clients ou adhérents.
 * Permet d'ajouter une pub AdSense sur la page de logon.
 * Permet d'ajouter un tag de suivi Analytics sur toutes les pages de Dolibarr.


 * Compatible avec les comptes google Gmail standard et les comptes Gmail Google Apps (à partir de la version 3.4.5 du module).

= Installation =

= Configuration =

Configuration Google Agenda
Le module apporte 2 fonctions distinctes:

Affichage de l'agenda Google
Si vous désirer faire apparaître les agendas Google dans les menus Dolibarr, sur la page de configuration du module, pour l'onglet "View Google Agenda", il vous faut saisir:

"Activer cet outil" à Oui.

Ensuite, pour chaque agenda à faire apparaitre, saisir:
 * Un nom pour l'agenda Google
 * Une couleur pour l'Agenda Google.
 * L'ID de l'Agenda Google. Il peut etre trouvé en allant sur la page de paramétrage des agendas Google de la mnière suivante
 * 1) Se Connecter à http://calendar.google.com
 * 2) Cliquer sur le lien "Parametres"
 * 3) Cliquer sur le nom de l'Agenda voulu pour en afficher les détails.
 * 4) Trouver la ligne "Adresses de l'URL", vous verrez le texte "ID Agenda : theagendaid@gmail.com"

L'ID d'Agenda est la valeur qui ressemble à une adresse email. Si vous n'avez qu'un seul agenda, il peut s'agir simplement de votre compte Google.

La dernière rubrique de configuration (Google Client id et Google Client secret) ne sert que si vous désirez que la demande d'authentification à Google soit intégrée dans les écrans Dolibarr.

Synchronisation des événements Dolibarr vers Google Agenda
L'autre fonction permet de créer/mettre à jour un événement dans Google lors de sa création dans Dolibarr. Le but de cette fonction est de pousser chaque élément de l'agenda Dolibarr sur l'agenda par défaut d'un compte google. La synchronisation est donc monodirectionnel (de Dolibarr vers Google).

Le compte google peut être (1 seul compte X pour tout le monde) ou bien cela peut être le compte de la personne à qui la tache est affectée.

Si vous décidez d'utiliser un compte fixe X
Pour cela, sur la page de configuration du module, pour l'onglet "Sync to Google Agenda", il vous faut saisir: Puis cliquer sur Enregistrer.
 * Votre login Google (exemple: moncompte@gmail.com)
 * Votre mot de passe Google

Le bouton pour réaliser un test de synchro devient alors cliquable. Cliquez dessus pour faire un test.

Remarque: Une erreur possible est que Google refuse l'accès même si votre login/mot de passe est correct, juste parce que votre serveur qui héberge Dolibarr ne se situe pas dans le même pays que vous. Pour vérifier si Google a bien bloqué l'accès pour ce motif, allez sur la page https://security.google.com/settings/security/activity?hl=fr après l'échec.

Si Google affiche qu'il a bloqué des tentatives d'accès depuis un lien inhabituel, accepter cette tentative. Ensuite, il faut attendre 24h pour essayer à nouveau.

Remarque: Une autre erreur possible est que Google refuse l'accès même si votre login/mot de passe est correct, parceque vous avez activez la validation en 2 étapes. Pour vérifiez si vous avec effectivement activé cette option, aller sur la page: https://security.google.com/settings/security?pli=1 Si dans la rubrique "Validation en deux étapes", vous avez "Activé", le problème est la. Vous n'êtes pas obligé de la désactiver. Vous pouvez résoudre le problème ainsi: Cliquer sur "Modifier" à côté du titre de la rubrique "Validation en 2 étapes". Cliquez sur le lien "Gérer les mots de passe spécifiques à des applications". Saisissez un nom, par exemple "Accès google par Dolibarr" et valider. Un mot de passe vous sera fourni. Retournez sur la page de configuration du module Google dans Dolibarr et enregistrez ce mot de passe dans la page de configuration du module à la place de votre mot de passe habituel, puis '''Enregistrer. Réessayer le test de synchro.

Le fonctionnement sera alors le suivant:

Si une tache 1 est affectée à l'utilisateur 1, elle sera poussé sur l'agenda google du compte X. Si une tache 2 est affectée à l'utilisateur 2, elle sera poussée également ce même agenda google du compte X. X étant un agenda google, il sera visible sur tout smartphone Android qui a ajouté les identifiants du compte X dans les comptes de son smartphone. Inconvénient, tout le monde a le login/pass du compte générique X, et tout le monde verra tous les événements de tout le monde.

Si vous utilisez un compte google différent pour chaque utilisateur
Pour cela, sur la page de configuration du module, pour l'onglet "Sync to Google Agenda", laisser le champ login/mot de passe vide. Chaque utilisateur doit par contre, renseigner son compte google et mot de passe sur sa fiche utilisateur.

Le fonctionnement sera alors le suivant:

Si une tache 1 est affectée à l'utilisateur 1, elle sera poussé sur l'agenda google du compte google de l'utilisateur 1 Si une tache 2 est affectée à l'utilisateur 2, elle sera poussée sur l'agenda google du compte google de l'utilisateur 2 Ce sont des agenda google, donc visible sur smartphones Android. Chacun ayant son agenda, verra ces événements dans son agenda.

Il est ensuite possible de partager les agendas entre personnes 2 à 2 (Le user 1 rend visible son agenda au user 2 et au user 3 mais pas au user 4). Mais cela est une fonctionnalité propre aux agendas google ou chacun peut rendre son agenda visible à d'autres. Ce n'est pas le module google qui apporte cela mais les fonctions de bases de partage d'agenda accessible depuis la configuration dans google agenda.

Les fonctions de partagent d'agenda proposés par google fonctionnant aussi sur smartphone Android, l'utilisateur à qui les autres ont donnés accès à leur agenda verra les agenda de ces autres. La encore y compris sur smartphone.

Configuration Google Contacts
Le module permet de réaliser une synchronisation de Dolibarr avec votre annuaire de contact Google. Dans un premier temps, choisissez les éléments que vous voulez synchroniser. Vous pouvez choisir l'1 d'eux ou tous: Ensuite, renseigner votre login et mot de passe puis cliquer sur Enregistrer.
 * Tiers (si le module Tiers est activé)
 * Contacts/Adresses (si le module Tiers est activé)
 * Adhérents (si le module Adhérents est activé)

Les boutons pour réaliser des test de synchronisation deviennent disponibles. Utilisez les pour faire des tests.

Le bouton pour réaliser un test de synchro devient alors cliquable. Cliquez dessus pour faire un test.

Remarque: Une erreur possible est que Google refuse l'accès même si votre login/mot de passe est correct, juste parce que votre serveur qui héberge Dolibarr ne se situe pas dans le même pays que vous. Pour vérifier si Google a bien bloqué l'accès pour ce motif, allez sur la page https://security.google.com/settings/security/activity?hl=fr après l'échec.

Si Google affiche qu'il a bloqué des tentatives d'accès depuis un lien inhabituel, accepter cette tentative. Ensuite, il faut attendre 24h pour essayer à nouveau.

Remarque: Une autre erreur possible est que Google refuse l'accès même si votre login/mot de passe est correct, parceque vous avez activez la validation en 2 étapes. Pour vérifiez si vous avec effectivement activé cette option, aller sur la page: https://security.google.com/settings/security?pli=1 Si dans la rubrique "Validation en deux étapes", vous avez "Activé", le problème est la. Vous n'êtes pas obligé de la désactiver. Vous pouvez résoudre le problème ainsi: Cliquer sur "Modifier" à côté du titre de la rubrique "Validation en 2 étapes". Cliquez sur le lien "Gérer les mots de passe spécifiques à des applications". Saisissez un nom, par exemple "Accès google par Dolibarr" et valider. Un mot de passe vous sera fourni. Retournez sur la page de configuration du module Google dans Dolibarr et enregistrez ce mot de passe dans la page de configuration du module à la place de votre mot de passe habituel, puis '''Enregistrer. Réessayer le test de synchro.

Lien de localisation d'une adresse particulière
Choisissez les éléments sur lesquels faire apparaître le picto GMaps après les adresses parmi les suivants:
 * Tiers (si le module Tiers est activé)
 * Contacts/Adresses (si le module est activé)
 * Adhérents (si le module Adhérents est activé)

Choisissez le niveau de zoom de Google pour définir l'échelle par défaut de la carte qui sera affichée (valeur de 1 à 10, 10 étant un zoom plus fort). En général, 7 est une bonne valeur.

Liens de cartes globales
L'autre fonctionnalité de carte GMaps, est d'offrir une carte globale situant tous vos tiers ou contacts/adresses. Pour voir apparaître les liens vers ces cartes, allez dans le menu Accueil - Configuration - Boites. Assurez vous que la boite "Liens de cartes GMaps" est active. Retourner sur la page d'accueil de Dolibarr. Si la boite n’apparaît pas, choisissez la dans la liste déroulante des boites que vous pouvez ajouter sur votre espace.

Configuration Adsense
Sur la page de configuration du module, pour l'onglet Agenda, vous devez saisir: Une publicité sera alors affichés sur la page de demo et la logon.
 * Votre id cient adsense (ca-pub-xxxxxx)
 * L'id de slot propre au format de pub à afficher (à retrouver sur la page de configuration adsense.google.com)

Configuration Google Analytics
Sur la page de configuration du module, pour l'onglet Analytics, vous devez saisir: Le tag Google Analytics sera alors affiché sur toutes les pages de Dolibarr.
 * Votre ID Google analytics (Du genre UA-xxxxxxx-y). Cet id s'obtient depuis la console d'administration de Google analytics.

= Utilisation =

Si vous avez activé la fonction affichage de Google calendar
Aller dans le menu Agenda. Choisissez l'onglet Agenda Google, le ou les agendas Google configurés s'afficheront alors. Si vous avez définis plusieurs agenda, vous pouvez restreindre la vue sur l'un à l'autre uniquement via le menu gauche. Il s'agit ici d'un affichage en lecture seule. Pour faire des ajouts d'évênements dans cet agenda, il faut cliquer sur le lien "+ Google calendar" en bas à droite de l'agenda.

.

Pour des raisons de sécurité imposées par Google, la vue agenda de Google ne s'affichera correctement que si vous êtes logué sous Google. Afin de faciliter cela, il est possible de configurer une clé pour permettre à l'application de proposer la Logon Google si vous n'êtes pas déjà connecté (Voir pour cela la dernière rubrique de paramètres de l'onglet Agenda de la page de configuration du module Google).

Si vous avez activé la synchro Dolibarr vers Google calendar
Créer un événement dans Dolibarr et allez voir dans google Calendar. L’événement doit apparaître.

Utilisation fonctions GMaps
Selon le choix fait à la configuration, un petit picto apparaît sur la fiche Tiers, Contacts/Adresses ou adhérents au bout de l'adresse. En cliquant dessus, vous voyez apparaître une carte avec l'adresse positionnée dessus. Il vous ait possible de naviguer dans la carte sans quitter Dolibarr.

Voici un exemple obtenu en cliquant sur le picto qui apparait au bout de l'adresse de la fiche d'un tiers.



De plus, à partir de la version 3.4, vous avez aussi accès à une boite sur la page d'accueil présentant un lien pour voir l'ensemble de vos Tiers, ou Adhérents sur une même carte.

Voici un exemple obtenu en cliquant sur le lien "Carte des adhérents" qui sera sur la page d'accueil.



Utilisation fonctions Adsense
Il n'y a rien à faire à l'utilisation. Une fois la configuration faite (voir précédemment), une publicité adsense apparait sur la page de logon.

Note: Lorsque Dolibarr est accéder via l'Application Android - DoliDroid FR, la publicité ne sera toutefois pas active.

Utilisation fonctions Google Analytics
La aussi, il n'y a rien de particulier à faire. Une fois configuré (voir précédemment), un tag Google Analytics invisible est inséré dans chaque page de Dolibarr. En utilisant l'interface Google de Google Analytics, vous pouvez avoir des statistiques de consultation des pages de Dolibarr, comme si il s'agissait d'une application Web publique.

Note: Lorsque Dolibarr est accédé via l'Application Android - DoliDroid FR, le tags ne seront toutefois pas actif.

= Développement =