CardDAV / CalDAV / ICS synchronization

This module for Dolibarr 16.0/22.0 adds CardDAV / CalDAV and ICS synchronization. It uses Dolibarr [Sabre/DAV](http://sabre.io/dav/) server library.

You can :

•  Read and edit calendars through CalDAV
•  Read and edit project tasks through CalDAV
•  Read and edit intervention cards through CalDAV
•  Read and edit address books through CardDAV
•  Read calendars through ICS Full version or only Free/Busy (hide details)
•  Access Dolibarr documents through WebDAV (if admin)
•  Generate project tasks from documents like proposals and/or orders

Each user can access his/her contacts and thirdparties address books (public and own private contacts), his/her own calendar and other users calendars according to his/her rights.

Dolibarr contact information fill personal information in client software cards (including contact photo).

Society (thirdparty) information (to which contact is attached) fill professional information in client software cards.

Three address books are proposed to sync : Contacts, Thirdparties and Members. If you want to modify a thirdparty information, do it in thirdparties address book.

It is possible to select which contacts to sync with CDAV_CONTACT_TAG configuration value in Home / Setup / Other setup. Enter a contact tag value and then only contacts with this tag will be synced (empty value for all).

Calendar records with "Status / Percentage" set to "Not applicable" are converted to events in CalDAV (VEVENT), others are converted to tasks (VTODO).

Recurring events are partially handled (Dolibarr does not handle them fully), when a recurring event is created, it is duplicated automatically until the date specified (exculded) or the max synchronisation time range.

Automatic tasks generation in projects with services from linked Propositions and/or Orders
Module setup offer you to :

•  generate tasks from linked document(s) OR not
•  synchronize project tasks as calendar events AND/OR todo tasks
•  set up 3 initial tasks that will appear before services coming from document(s)
•  set up 3 final tasks that will appear after services coming from document(s)
•  define user role in project to select user to attribute on generated tasks from document(s)
•  define user role on new project task creation
•  define start and end time of a working day
•  restrict services to be converted as task by specifying a tag
•  force generation of tasks for each service lines from attached documents with cdav duration if tag is missing

Durations are retrieved from service's card if defined (minutes, hours, days or weeks only), otherwise from extrafield filled in documents
All tasks are beginning at the starting date of the project, at the beginning of the working day
Multi-day durations tasks are maintained as a single task, eg from 31/07/2018 at 8am to 02/08/2018 at 7pm
 
Usage :
 

•  Manually create a project, link it to a third party, and set up the date ; leave it in draft status
•  Attach document(s) : proposals or orders including at least 1 concerned service.
•  Affect contact(s) with correct role
•  Validate project : all tasks are created ; use your ics client software to retrieve and drag-drop events if necessary

 Notes :

•  Description of services are useful to create subtasks if '- ' are detected at the beginning of a line ; then, with DAVx⁵ (CalDAV/CardDAV Synchronization and Client) and Tasks (Keep track of your list of goals) you will be able to use checkboxes for these tasks
•  If you chose to synchronize project tasks as calendar events AND todo tasks, modifying a task will automatically modify the corresponding event and reciprocally.
•  Tasks can be modified from client application but not cancelled : Dolibarr keep trace of last affectation
•  After generating tasks, you can modify/complete each of them or create more tasks manually (here too you can fill description zone with '- ' at the beginning of lines to create subtasks)

Module version: auto
Publisher/Licence: Befox SARL / GPLv3
User interface language: English/French
Help/Support: http://www.befox.fr/contact
Prerequisites:

• Dolibarr min version: auto
• Dolibarr max version: auto

Install:

• Download the archive file of module (.zip file) from website DoliStore.com
• Put the file into the root directory of Dolibarr.
• Uncompress the zip file, for example with command

unzip modulefile.zip

• Module is then available and can be activated.