Installation guide¶

Prerequisites¶

Dolibarr ≥ 3.2
PHP ≥ 5.3
PHP extensions
- CURL
- JSON

Installation¶

Recommended: « custom » directory¶

Make sure the custom directory is enabled [1].

Unzip the archive in htdocs/custom directory.

Legacy: « htdocs » directory¶

Unzip archive in htdocs/ directory.

Note

Make sure that your webserver’s user has read and directory traversal permissions on the folder and it’s content.

Footnotes

[1]	Edit the file `htdocs/conf/conf.php` and uncomment the lines `$dolibarr_main_url_root_alt` and `$dolibarr_main_document_root_alt`.

Administrator’s guide¶

Note

This module is designed to authenticate your request against Google services. An Internet access is required.

You can’t use this module if it is not fully configured.

Activation¶

You need to have admin privileges to activate the module.

Navigate to Configuration ‣ Modules ‣ Interfaces ‣ ZenFusion OAuth and switch it to ON

À faire

Add screenshot

Setup¶

You must register Dolibarr in the Google Developers Console to allow it to communicate with Google.

Google Cloud Console¶

Google API Configuration¶

Sign in with your Google account.

À faire

Add screenshot

Create a new project with the button Create project.

Choose a Project Name (for example Dolibarr).

Eventually accept the terms of service.

Click Create »`

Wait until the project opens automatically.

À faire

Add screenshot

Use Enable an API from the dashboard or the API & AUTH ‣ APIs »` menu.

Enable the required APIs for your modules (Status ON).

Module	APIs
ZenFusion Contacts	Contacts API
ZenFusion Drive	Drive API Google Picker API

Client ID¶

Go to APIs & AUTH ‣ Credentials ‣ OAuth.

Click Create new client ID.

À faire

Add screenshot

Use the following parameters:

Application type:
	Web application
Authorized Javascript origins:
	Dolibarr’s adress
Authorized redirect URI:
	Copy and paste URL using the Copy to clipboard button (Configuration tab from Dolibarr’s ZenFusion OAuth module).

À faire

Add screenshot

Configuration file¶

À faire

Add screeshot

Download the file using the Download JSON button from the new Client ID and upload it using the form (Setup tab from Dolibarr’s ZenFusion OAuth module).

Congratulations!

You just enabled Dolibarr communicating with Google.

Avertissement

For security reasons, destroy the downloaded file after use. Or at least make sure it’s stored in a safe way.

Permissions¶

Module provides a user permission. This allows or denies access to all functions.

It is only enabled for admin by default and should be enabled for each desired user or group.

You can find it in the user card User permissions tab or group card Group permissions tab.

User setup¶

See User’s guide

User’s guide¶

Setup¶

À faire

Add screenshot

Avertissement

Your e-mail adress must be same as the Google account’s.

Each user has to enable his Google account to communicate with Dolibarr. Go to Your user card ‣ Google, click on Activate and follow the instructions

Congratulations!

You now have access to the enabled services.

Note

You can also use this page to disable the services.

ZenFusion OAuth¶

This module provides Google APIs OAuth 2 authentication client capabilities to Dolibarr.

It is designed to be used with other ZenFusion modules.

License¶

GPLv3 or (at your option) any later version.

See COPYING for more information.

Composer¶

This project uses composer to manage external dependencies.

Please see https://getcomposer.org for more informations.

First use¶

Please issue the following command at the project root after clone to install required dependencies:

Production: composer install --no-dev
Development: composer install

Updates¶

After pulling, use composer update to update the dependencies.

Bienvenue dans la documentation de ZenFusion OAuth !¶

Danger

La migration vers ce système de documentation est encore en cours.

Merci de consulter la documentation actuelle à modules.gpcsolutions.fr.

Download:	Dolistore
Latest release:	3.0.2
Licence:	GPLv3+ ©2011-2016 GPC.solutions
Informations:	contact@gpcsolutions.fr
Developers:	Raphaël Doursenaud Sébastien Bodrero Cédric Salvador
Contributors:	N.A.
Translators:	N.A.

À faire

Ajouter le logo ZenFusionOAuth

Ajouter le logo GPLv3

Ajouter le logo GFDL dans le pieds de page

Ajouter le guide de contribution (code, documentation, traduction des deux)

Avertissement

Ce module ne fait rien de lui même.

Il est conçu pour fournir des services d’authentification aux autres modules ZenFusion tels que Contacts et Drive.