feat: New google documentation

.vuepress/sidebar/settingUp.js

@@ -30,6 +30,7 @@ module.exports = function getSidebar (lang) {
 				title: 'Intégrations',
 				collapsable: false,
 				children: [
+					'integrations/google',
 					'integrations/zapier'
 				]
 			}
@@ -65,6 +66,7 @@ module.exports = function getSidebar (lang) {
 			title: 'Integrations',
 			collapsable: false,
 			children: [
+				'integrations/google',
 				'integrations/zapier'
 			]
 		}

dokos/selling/lead.md

+# Lead 
+
+::construction:: Writing in progress ::construction::
\ No newline at end of file

dokos/selling/shipping-rule.md

+# Shipping Rule
+
+::construction:: Writing in progress ::construction::
\ No newline at end of file

dokos/selling/tax-template.md

+# Tax Template
+
+::construction:: Writing in progress ::construction::
\ No newline at end of file

dokos/setting-up/integrations/google.md

+# Google integration
+
+__dokos__ can be integrated with several tools from the Google application suite: Google Calendar, Google Drive, Google Contacts and Google Maps
+
+# 1. Setup Google Settings
+
+> Integrations > Google Settings
+
+In order to integrate any of the Google tools with __dokos__, you need to activate and setup an OAUTH integration with the Google Cloud Platform.
+This will then make it possible to obtain an access token (authorization to access the service) from Google for the service you wish to use.
+
+### 1.1. Setup for Calendar, Drive and Contacts
+
+1. Go to [https://console.cloud.google.com/](https://console.cloud.google.com/)
+1. Use an existing project or create a new project
+1. In **API and Services** select **Credentials**
+1. Click on **Create credentials** and select **OAuth Client ID**
+![OAuth Client Creation](/images/setup/google_setup/oauth_client_creation.png)
+1. Select **Web Application**
+1. In **Authorized Javascript origins** add your website URL: `https://{yoursite}` (e.g. __https://dokos.io__)
+1. In **Authorized redirect URIs** add the following URLs depending on your integration needs:
+    - Google Calendar: `https://{yoursite}?cmd=frappe.integrations.doctype.google_calendar.google_calendar.google_callback`
+    - Google Contacts: `https://{yoursite}?cmd=frappe.integrations.doctype.google_contacts.google_contacts.google_callback`
+    - Google Drive: `https://{yoursite}?cmd=frappe.integrations.doctype.google_drive.google_drive.google_callback`
+1. Save and copy/paste the generated **Client ID** and **Client Secret** into the corresponding fields in the **Google Settings** document in __dokos__
+1. Go to **OAuth consent screen** and add your domain to the **Authorized domains**
+![OAuth Consent Setup](/images/setup/google_setup/oauth_consent_setup.png)
+1. Go to **Library** and enable the relevant APIS: **Contacts API**, **Google Calendar API** and/or **Google Drive API**
+
+### 1.2. Setup for Maps
+
+Google Maps access doesn't require an OAuth connection, only a specific API key.
+
+1. Go to [https://console.cloud.google.com/](https://console.cloud.google.com/)
+1. Use an existing project or create a new project
+1. In **API and Services** select **Credentials**
+1. Click on **Create credentials** and select **API key**
+1. Copy and paste this key into the **API key** field of the **Google Settings** document in __dokos__
+
+# 2. Google Calendar
+
+> Integrations > Google Calendar
+
+You can create as many Google Calendar as you wish.
+Each calendar will be linked to only one reference document and optionally to a user.
+
+Currently, the Google Calendar integration works with the following document types:
+- Event
+- Item Booking
+
+### 2.1. Create a new calendar
+
+1. Give your calendar a meaningful name
+1. Select a reference document: This calendar will only be selectable in the reference document.
+1. Add a user if the option is provided. If a user is set, the calendar will only be accessible to this user.
+1. Check your synchronization options
+1. You can then **Authorize access to Google Calendar**
+1. Once the access granted, you can add the Google Calendar ID of one of your existing calendars or leave this field empty.
+  If empty, a new calendar will be automatically created.
\ No newline at end of file

dokos/stocks/item-booking.md

@@ -24,9 +24,9 @@ All slots being multiples of 1 minute, it is necessary to define it for dokos.
 Option to autorize simultaneous item bookings (several bookings of the same item during the same timeslot).
 It activates the possibility to set a number of allowed simultaneous bookings for each item in the item master data.
 
-##### Clear drafts after x minutes
+##### Clear bookings in shopping cart after x minutes
 
-Setup to define the time interval between the last modification of an item booking draft and its automatic deletion by the software. Set 0 to deactivate this functionality.
+Setup to define the time interval between the last modification of an item booking with status "In Cart" and its automatic deletion by the software. Set 0 to deactivate this functionality.
 
 #### 2.2. Unit of measure
 
@@ -95,5 +95,30 @@ Draft bookings are automatically deleted every x minutes (defined in stock setti
 You can activate the portal "Bookings" to give an access to your clients to the list of timeslots they have booked.
 The different bookings will appear with the following statuses: "Confirmed", "Cancelled", "Past".
 
-If you give your clients the permission to cancel an item booking, they will also see a button `Cancel` allowing them to cancel their bookings.
-This permission can be given by checking the `Cancel` permission for the `Customer` role (default role) in the the Roles and Permissions Manager.
\ No newline at end of file
+If you give your clients the permission to write to an item booking, they will also see a button `Cancel` allowing them to cancel their bookings.
+This permission can be given by checking the `Write` permission for the `Customer` role (default role) in the the Roles and Permissions Manager.
+
+#### 5. Google Calendar Integration
+
+It is possible to synchronize your item bookings with Google Calendar.
+To setup the connection and create calendars, read this [section](/dokos/setting-up/integrations/google).
+
+##### 5.1. Setup
+
+You can link it each item with a calendar with **Item Booking** as reference document in the **Google Calendar** section of each item.
+If an item is not linked to a calendar, you must select it manually in your booking document.
+
+:::warning Warning
+Each item must be linked with a different calendar.
+:::
+
+##### 5.2. Synchronization
+
+To synchronize your bookings, check the box **Synchronize with Google Calendar**.
+Check that a calendar is selected in the **Google Calendar** field.
+
+:::warning Warning
+__dokos__ doesn't handle exceptions linked to recurring events yet.
+If you want to delete a recurring event in Google Calendar, make sure to select **All events**.
+If you delete only one occurence of this event, it will not be reflected in __dokos__.
+:::
\ No newline at end of file

dokos/stocks/item.md

+# Item
+
+::construction:: Writing in progress ::construction::
\ No newline at end of file

dokos/versions/v1_2_0.md

+# V1.2.0
+
+## dokos
+
+#### Features
+- Possibility make half day leave applications
+
+#### Bug corrections
+- Website portal addresses correction
+
+
+## dodock [Framework]
+
+#### Features
+- [Server scripts](/dokos/setting-up/customization/server-scripts)
+
+#### Bug corrections
\ No newline at end of file

dokos/versions/v1_3_0.md

+# V1.3.0
+
+## dokos
+
+#### Features
+- Asset flow refactor
+
+#### Bug corrections
+- Invoice submission performance issue improvement
+- Suppress Quill warnings in console
+
+## dodock [Framework]
+
+#### Features
+- - New Razorpay order API
+
+#### Bug corrections

fr/dokos/installation/integrations/google.md

+# Intégration Google
+
+__dokos__ peut être connecté avec plusieurs outils de la suite d'applications Google: Google Agenda, Google Drive, Google Contacts et Google Maps
+
+# 1. Paramètres Google
+
+> Intégrations > Paramètres Google
+
+Afin de connecter les outils Google avec __dokos__, vous devez activer et paramétrer une intégration Oauth avec la plateforme Google Cloud.
+Cela permet d'obtenir un jeton d'accès (autorisation d'accéder au service) de la part de Google pour le service que vous souhaitez utiliser.
+
+### 1.1. Paramétrage pour Agenda, Drive and Contacts
+
+1. Allez sur [https://console.cloud.google.com/](https://console.cloud.google.com/)
+1. Utilisez un projet existant ou créez un nouveau projet
+1. Dans **API and Services** sélectionnez **Credentials**
+1. Cliquez sur **Create credentials** et sélectionnez **OAuth Client ID**
+![OAuth Client Creation](/images/setup/google_setup/oauth_client_creation.png)
+1. Sélectionnez **Web Application**
+1. Dans **Authorized Javascript origins** ajoutez l'URL de votre site: `https://{votresite}` (Ex. __https://dokos.io__)
+1. Dans **Authorized redirect URIs** ajoutez les URLs suivantes en fonction de vos besoins d'intégration:
+    - Google Agenda: `https://{votresite}?cmd=frappe.integrations.doctype.google_calendar.google_calendar.google_callback`
+    - Google Contacts: `https://{votresite}?cmd=frappe.integrations.doctype.google_contacts.google_contacts.google_callback`
+    - Google Drive: `https://{votresite}?cmd=frappe.integrations.doctype.google_drive.google_drive.google_callback`
+1. Enregistrez et copiez/collez le **Client ID** et **Client Secret** générés dans les champs correspondants du document **Google Settings** de __dokos__
+1. Allez dans **OAuth consent screen** et ajoutez votre domaine aux **Authorized domains**
+![OAuth Consent Setup](/images/setup/google_setup/oauth_consent_setup.png)
+1. Allez dans **Library** et activez les APIs nécessaires: **Contacts API**, **Google Calendar API** et/ou **Google Drive API**
+
+### 1.2. Paramétrage pour Maps
+
+L'accès à Google Maps ne nécessite pas de connexion OAuth, seulement une clé API spécifique.
+
+1. Allez sur [https://console.cloud.google.com/](https://console.cloud.google.com/)
+1. Utilisez un projet existant ou créez un nouveau projet
+1. Dans **API and Services** sélectionnez **Credentials**
+1. Cliquez sur **Create credentials** et sélectionnez **API key**
+1. Copiez et collez cette clé dans le champs **API key** du document **Google Settings** de __dokos__
+
+# 2. Google Agenda
+
+> Intégrations > Google Agenda
+
+Vous pouvez créer autant de Calendrier Google que vous le souhaitez.
+Chaque calendrier est lié à un seul document de référence et, optionnellement, à un utilisateur.
+
+Actuellement, l'intégration Google Agenda fonctionne avec les types de documents suivants:
+- Evénement
+- Réservation d'articles
+
+### 2.1. Créer un nouveau calendrier
+
+1. Donnez un nom reconnaissable à votre calendrier
+1. Sélectionnez un document de référence: Ce calendrier sera seulement sélectionnable dans le document de référence.
+1. Ajouter un utilisateur si l'option est proposée. Si un utilisateur est défini, le calendrier sera accessible seulement à cet utilisateur.
+1. Vérifiez vos options de synchronisation.
+1. Vous pouvez ensuite **Autoriser l'accès à Google Agenda**
+1. Une fois l'accès accordé, vous pouvez ajouter l'identifiant Google Agenda de l'un de vos calendriers existants ou laisser ce champ vide.
+   Si le champ est vide, un nouveau calendrier sera automatiquement créé.
\ No newline at end of file

fr/dokos/stocks/article.md

+# Article
+
+::construction:: Page en cours de rédaction ::construction::
\ No newline at end of file

fr/dokos/stocks/reservation-articles.md

@@ -23,9 +23,9 @@ Tous les créneaux étant des multiples d'une minutes, il faut indiquer cette un
 Option permettant d'autoriser les réservations simultanées d'articles (plusieurs réservation d'un même article pendant le même créneau).
 Cela active la possibilité d'indiquer un nombre de réservations simultanées autorisées pour chaque article dans les fiche d'articles.
 
-##### Supprimer les brouillons après x minutes
+##### Supprimer les réservations dans le panier après x minutes
 
-Paramétrage permettant de définir l'intervale de temps entre la dernière modification d'un brouillon de réservation d'articles et sa suppression automatique par le logiciel. Mettez 0 pour désactiver cette fonctionnalité.
+Paramétrage permettant de définir l'intervale de temps entre la dernière modification d'une réservation d'articles en statut "Dans le panier" et sa suppression automatique par le logiciel. Mettez 0 pour désactiver cette fonctionnalité.
 
 #### 2.2. Unité de mesure
 
@@ -69,7 +69,7 @@ Il est donc utile de configurer au moins un calendrier qui ne soit lié ni à un
 Pour pouvoir autoriser la réservation de créneaux horaires sur votre site web, vous devez d'abord afficher l'article sur votre site web: dans la section __Site web__, sélectionnez __Afficher sur le site web__.  
 Activer cette option vous permettra aussi d'__Autoriser la réservation d'articles__.
 
-Une fois activée, vos utilisateurs de site web auront le choix entre acheter des unités ou sélectionner un créneau:
+Une fois activée, vos utilisateurs de site web auront le choix entre acheter des unités ou sélectionner un créneau:  
 ![Options de réservation d'article sur le site web](/images/stocks/item_booking/item_website_options.png)
 
 Vous pouvez cocher la case __Désactiver l'achat d'unités__ pour ne permettre que la réservation de créneaux.
@@ -96,5 +96,30 @@ Les réservations en brouillon (non validées) sont automatiquement supprimées
 Vous pouvez activer le portail "Bookings" pour donner un accès à vos clients à la liste des créneaux qu'ils ont réservés.  
 Les différentes réservations apparaîtront avec les statuts "Confirmé", "Annulé" ou "Passé".
 
-Si vous donnez l'autorisation d'annuler une réservation d'articles à vos clients, ceux-ci pourront également voir un bouton `Annuler` leur permettant d'annuler leur réservation.
-Cette autorisation peut être donnée en cochant la case `Annuler` pour le rôle `Client` (par défaut) dans les gestionnaire des rôles et autorisation.
\ No newline at end of file
+Si vous donnez l'autorisation d'écrire dans une réservation d'articles à vos clients, ceux-ci pourront également voir un bouton `Annuler` leur permettant d'annuler leur réservation.
+Cette autorisation peut être donnée en cochant la case `Ecrire` pour le rôle `Client` (par défaut) dans le gestionnaire des rôles et autorisation.
+
+#### 5. Intégration Google Agenda
+
+Il est possible de synchroniser vos réservations d'article avec Google Agenda.
+Pour paramétrer la connexion et créer des agendas, lire cette [section](/fr/dokos/installation/integrations/google).
+
+##### 5.1. Configuration
+
+Vous pouvez le lier chaque article avec un agenda ayant comme document de référence **Réservation d'articles** dans la section **Google Agenda**
+Si un article n'est pas lié avec un agenda, il faudra sélectionner celui-ci manuellement dans chaque réservation.
+
+:::warning Attention
+Chaque article doit être lié avec un agenda différent.
+:::
+
+##### 5.2. Synchronisation
+
+Pour synchroniser vos réservations, cochez la case **Synchroniser avec Google Agenda**.
+Vérifiez qu'un agenda est bien sélectionné dans le champs **Google Agenda**.
+
+:::warning Attention
+__dokos__ ne gère pas encore les exceptions liées aux récurrences d'événement.
+Si vous souhaitez supprimer un événement récurrent dans Google Agenda, sélectionnez bien l'option **Tous les événements**.
+Si vous supprimez seulement une occurence de cet événement, cela n'apparaîtra pas dans __dokos__.
+:::

fr/dokos/vente/client.md

+# Client
+
+::construction:: Page en cours de rédaction ::construction::
\ No newline at end of file

fr/dokos/vente/devis.md

@@ -16,7 +16,7 @@ Un devis contient des détails sur:
   * Le moment de la livraison.
   * Toutes autres conditions.
 
-:::tip
+:::tip Astuce
 Les images sont souvent appréciées sur un devis. Faites en sorte que vos articles aient une image associée.
 :::
 
@@ -41,7 +41,7 @@ Vous pouvez aussi créer un devis depuis une opportunité en cliquant sur le bou
 
 ## 3. Fonctionnalités
 
-### 3.1 Adresse et contact
+### 3.1. Adresse et contact
 Dans cette section vous trouverez quatre champs importants:
 
 * **Adresse du client:** C'est l'adresse de facturation du client.
@@ -49,7 +49,7 @@ Dans cette section vous trouverez quatre champs importants:
 * **Personne de contact:** Si votre client est un organisation, vous pouvez ajouter la personne à contacter dans ce champ.
 * **Territoire:** Région à laquelle le client appartient. Par défaut c'est "Tous les secteurs". 
 
-### 3.2 Devise et liste de prix
+### 3.2. Devise et liste de prix
 
 Vous pouvez définir la devise dans laquelle sera envoyée le devis.
 
@@ -57,7 +57,7 @@ Les prix des articles seront récupérés à partir de la liste de prix sélecti
 La liste de prix est récupérée automatiquement à partir des données de base du client, puis du groupe de client et enfin de la société si elle n'est pas défini avant.
 En cochant "Ignorer les règles de tarification", le système n'appliquera aucune des règles de tarification qui auraient pu s'appliquer sur ce devis.
 
-### 3.3 Le tableau d'articles
+### 3.3. Le tableau d'articles
 Ce tableau peut être ouvert en cliquant sur le triangle inversé au bout de chaque ligne du tableau.
 
 * Lors de la sélection d'un code d'article, les champs suivants sont récupérés automatiquement: nom de l'article, description, une image si attachée, une quantité par défaut de 1 et le prix unitaire. Vous pouvez ajouter des remises et calculer une marge dans la section correspondante.
@@ -70,33 +70,33 @@ Ce tableau peut être ouvert en cliquant sur le triangle inversé au bout de cha
 
 * Vous pouvez insérer des lignes au-dessus/en-dessous, dupliquer, déplacer ou supprimer des lignes dans ce tableau.
 
-:::tip
+:::tip Astuce
 Vous pouvez télécharger vos articles au format CSV et les télécharger dans une autre transaction.
 :::
 
 La quantité totale, le prix unitaire et le poids net de tous les articles sont affichés sous le tableau des articles.
 
-### 3.4 Taxes et frais
+### 3.4. Taxes et frais
 Pour ajouter des taxes à votre devis, vous devez sélectionner un [Modèle de frais et taxes de vente](/fr/dokos/vente/modele-taxes) ou ajouter des taxes manuellement dans le tableau des taxes et frais de vente.
 
 Le total des taxes et frais est affiché sous le tableau. En cliquant sur __Répartition des taxes__ vous afficherez toutes les composantes de taxes et leurs montants.
 
-Vous pouvez également ajouter une [Règle de livraison](/fr/dokos/selling/shipping-rule) pour les articles dans votre devis.
+Vous pouvez également ajouter une [Règle de livraison](/fr/dokos/vente/regle-livraison) pour les articles dans votre devis.
 
-### 3.5 Remise additionnelle
+### 3.5. Remise additionnelle
 En plus d'offrir des remises par article, vous pouvez ajouter une remise à la totalité du devis dans cette section.  
 Cette remise peut être basée sur le total TTC ou sur le total HT.  
 La remise additionnelle peut être définie en pourcentage ou en montant.  
 
-### 3.6 Termes de paiement
+### 3.6. Termes de paiement
 Parfois le paiement de la prestation n'est pas réalisé en une fois.  
 Par exemple, 30% peut être payé avant l'envoi de la marchandise et le solde à la réception.  
 Pour indiquer cela sur le devis, vous pouvez ajouter un modèle de termes de paiement ou ajouter des termes de paiement manuellement dans cette section.  
 
-### 3.7 Termes et conditions
+### 3.7. Termes et conditions
 Vous pouvez sélectionner un modèle de termes et conditions et le modifier en fonction des spécificités de la transaction.
 
-### 3.8 Paramètres d'impression
+### 3.8. Paramètres d'impression
 #### En-tête
 Vous pouvez imprimer vos devis/commandes client avec l'en-tête de votre société.
 
@@ -109,12 +109,12 @@ Vous pouvez sélectionner le "Titre de l'impression" correspondant avant l'impre
 Pour créer un nouveau __Titre d'impression__, allez dans:
 > Paramètres > Impression > Titre d'impression
 
-### 3.9 Informations additionnelles
+### 3.9. Informations additionnelles
 * **Campagne:** Une campagne de vente peut être associée à un devis. Plusieurs devis peuvent être associés à une campagne de vente.
 * **Source:** La source de prospection peut être liée si le devis est fait à un prospect provenant de différents canaux (Campagne, Exposition,... ) ou bien être __Clien existant__ si le devis est pour un client.  
 * **Devis fournisseur:** Un devis fournisseur peut être lié à un devis afin de comparer les prix et avoir une idée du bénéfice/perte potentiel.
 
-### 3.10 Valider le devis
+### 3.10. Valider le devis
 Le devis est une transaction à "valider". Lorsque vous cliquez sur enregistrer, un brouillon est enregistré, qui est validé définitivement lorsque vous le validez.  
 Puisque vous envoyez ce devis à votre client ou prospect, vous devez veillez à ce qu'aucun changement ne puisse lui être apporté après l'envoi du devis.  
 

fr/dokos/vente/modele-taxes.md

+# Modèles de taxes
+
+::construction:: Page en cours de rédaction ::construction::
\ No newline at end of file

fr/dokos/vente/prospect.md

+# Prospect
+
+::construction:: Page en cours de rédaction ::construction::
\ No newline at end of file

fr/dokos/vente/regle-livraison.md

+# Règle de livraison
+
+::construction:: Page en cours de rédaction ::construction::
\ No newline at end of file