diff --git a/blog/2024-03-18-sortie-du-module-proxmox copy.md b/blog/2024-03-18-sortie-du-module-proxmox.md similarity index 100% rename from blog/2024-03-18-sortie-du-module-proxmox copy.md rename to blog/2024-03-18-sortie-du-module-proxmox.md diff --git a/blog/2024-03-24-sortie-outil-migration.md b/blog/2024-03-24-sortie-outil-migration.md index aca4da9..80ff9fe 100644 --- a/blog/2024-03-24-sortie-outil-migration.md +++ b/blog/2024-03-24-sortie-outil-migration.md @@ -29,4 +29,4 @@ La migration depuis d’autres services sera bientôt disponible pour pouvoir ch ![img](/img/next_gen/extensions/addons/importation/importation.png) ## Réalisation de la migration -Pour réaliser la migration, rendez vous sur la page de migration après avoir installé l'addon de migration. Vous y trouverez un guide détaillé pour vous accompagner tout au long du processus sur [notre page de documentation](/docs/extensions/addons/importation). +Pour réaliser la migration, rendez vous sur la page de migration après avoir installé l'addon de migration. Vous y trouverez un guide détaillé pour vous accompagner tout au long du processus sur [notre page de documentation](/extensions/addons/importation). diff --git a/blog/2024-10-31-retour-de-virtualizorcloud.md b/blog/2024-10-31-retour-de-virtualizorcloud.md index 59afa83..9fb76de 100644 --- a/blog/2024-10-31-retour-de-virtualizorcloud.md +++ b/blog/2024-10-31-retour-de-virtualizorcloud.md @@ -20,4 +20,4 @@ VirtualizorCloud est un module implémentant la solution VirtualizorCloud, perme - `➕` **Importation de serveurs** : Importez facilement des serveurs existants dans le module VirtualizorCloud. ## Comment l'utiliser ? -Vous pouvez retrouver l'ensemble de la documentation du module VirtualizorCloud sur notre [documentation officielle](/extensions/modules/virtualizor_cloud). Cette documentation vous guidera à travers les étapes d'installation, de configuration et d'utilisation du module. \ No newline at end of file +Vous pouvez retrouver l'ensemble de la documentation du module VirtualizorCloud sur notre [documentation officielle](/extensions/modules/VirtualizorCloud). Cette documentation vous guidera à travers les étapes d'installation, de configuration et d'utilisation du module. \ No newline at end of file diff --git a/blog/2025-05-31-mise-en-opensource.md b/blog/2025-05-31-mise-en-opensource.md index efd491f..b5431b6 100644 --- a/blog/2025-05-31-mise-en-opensource.md +++ b/blog/2025-05-31-mise-en-opensource.md @@ -7,6 +7,7 @@ tags: [clientxcms, opensource, community] # ClientXCMS devient open source : une nouvelle ère s'ouvre Nous avons aujourd’hui le plaisir de vous annoncer un changement significatif dans le monde de l'hébergement : **le projet prend une nouvelle direction**. Une évolution pensée, mesurée, et portée par un objectif clair : rendre un CMS plus ouvert, plus accessible et résolument tourné vers une dynamique collective. +{/* truncate */} ![image](/img/blog/mise-en-opensource/image.png) ======= diff --git a/blog/2025-07-09-retour-ctxreselling.md b/blog/2025-07-09-retour-ctxreselling.md index abbf4c9..0dc4718 100644 --- a/blog/2025-07-09-retour-ctxreselling.md +++ b/blog/2025-07-09-retour-ctxreselling.md @@ -33,11 +33,11 @@ Ce programme vient en complément du programme partenaire pour les licences, afi 3. Vos clients commandent, vous payez uniquement ce qu’ils consomment. 4. Notre équipe vous accompagne si besoin. -Pour tout savoir sur la configuration, consultez la documentation officielle : [Documentation CTX Reselling](/docs/extensions/addons/ctxreselling) +Pour tout savoir sur la configuration, consultez la documentation officielle : [Documentation CTX Reselling](/extensions/addons/reselling_client) ## Questions fréquentes - **Qui peut devenir revendeur ?** Tout utilisateur CLIENTXCMS. - **Quels services puis-je revendre ?** VPS (LXC, KVM, HDD). - **Y a-t-il des prérequis ?** Aucun, tout est clé en main. -- **Où trouver la documentation ?** [Voir la documentation](/docs/extensions/addons/ctxreselling) +- **Où trouver la documentation ?** [Voir la documentation](/extensions/addons/reselling_client) diff --git a/docs/developpers/software/migrate_cloud_to_v2.md b/docs/developpers/software/migrate_cloud_to_v2.md index 0b53f97..db9f547 100644 --- a/docs/developpers/software/migrate_cloud_to_v2.md +++ b/docs/developpers/software/migrate_cloud_to_v2.md @@ -1,6 +1,6 @@ # Migrer cloud vers self-hosted :::info -CLIENTXCMS devient un logiciel open source, auto-hébergé et gratuit à partir du 1er septembre 2025. Pour les clients actuels, nous offrons une période de transition pour migrer vers la version auto-hébergée. Cette page vous guide à travers le processus de migration depuis CLIENTXCMS Cloud vers une instance auto-hébergée. Plus d'informations sur la transition [ici](/blog/2025-05-31-mise-en-opensource.md). +CLIENTXCMS devient un logiciel open source, auto-hébergé et gratuit à partir du 1er septembre 2025. Pour les clients actuels, nous offrons une période de transition pour migrer vers la version auto-hébergée. Cette page vous guide à travers le processus de migration depuis CLIENTXCMS Cloud vers une instance auto-hébergée. Plus d'informations sur la transition [ici](/blog/mise-en-opensource). ::: 1. **Récupérer une sauvegarde de l’instance CLIENTXCMS Cloud** @@ -34,17 +34,17 @@ CLIENTXCMS devient un logiciel open source, auto-hébergé et gratuit à partir 1. Connectez-vous à phpMyAdmin de votre serveur local (par exemple `https://votre-serveur/phpmyadmin`). 2. Sélectionnez la base `clientxcms_local`. 3. Cliquez sur **Importer** → **Choisir un fichier** → sélectionnez `sauvegarde_clientxcms_12345.sql` → cliquez sur **Exécuter**. - 4. Attendez que l’importation soit terminée (cela peut prendre quelques minutes selon la taille de la base). - 5. Vérifiez que toutes les tables sont présentes (ex. `customers`, etc.). + 1. Attendez que l’importation soit terminée (cela peut prendre quelques minutes selon la taille de la base). + 2. Vérifiez que toutes les tables sont présentes (ex. `customers`, etc.). __Via la ligne de commande__ : - 1. Connectez-vous à votre serveur via SSH. - 2. Exécutez les commandes suivantes pour créer la base de données et importer la sauvegarde : + 3. Connectez-vous à votre serveur via SSH. + 4. Exécutez les commandes suivantes pour créer la base de données et importer la sauvegarde : ```bash mysql -u root -p clientxcms_local < /chemin/vers/sauvegarde_clientxcms_12345.sql # Saisissez MotDePasseLocal quand demandé ``` - 3. Vérifiez que l’importation s’est bien déroulée en listant les tables : + 5. Vérifiez que l’importation s’est bien déroulée en listant les tables : ```bash mysql -u root -p -e "USE clientxcms_local; SHOW TABLES;" # Vous devriez voir toutes les tables de CLIENTXCMS Cloud (ex. customers, settings.) diff --git a/docs/extensions/addons/free_trial.md b/docs/extensions/addons/free_trial.md index b193635..ce40d88 100644 --- a/docs/extensions/addons/free_trial.md +++ b/docs/extensions/addons/free_trial.md @@ -1,4 +1,4 @@ -# Addon Essai +# Essai Gratuit L'add-on **Essai Gratuit** permet de proposer des périodes d’essai gratuites pour vos services ou produits. Vous pouvez l’activer depuis la section **Extensions**, puis le configurer via les **paramètres d’extension**. @@ -64,4 +64,4 @@ Une table affiche les services actuellement configurés pour l’essai avec les Cela permet de visualiser et d'avoir des informations sur vos services d'essai. -![img](/img/next_gen/extensions/addons/free_trial/image1.png) \ No newline at end of file +![img](/img/next_gen/extensions/addons/free_trial/image1.png) diff --git a/docs/extensions/addons/giftcard.md b/docs/extensions/addons/giftcard.md index 2d1326e..da45416 100644 --- a/docs/extensions/addons/giftcard.md +++ b/docs/extensions/addons/giftcard.md @@ -56,6 +56,7 @@ Une fois L'addon activé : ## 4. Interface d’administration ### 4.1 Tableau de bord +![img](/img/next_gen/extensions/addons/giftcards/giftcards_admin_view.png) * **Cartes-cadeaux créées** : compteur total. * **Montant total reversé** : somme créditée aux clients. @@ -84,6 +85,8 @@ Une fois L'addon activé : ## 5. Création manuelle +![img](/img/next_gen/extensions/addons/giftcards/giftcards_creer_admin.png) + **Administration → Cartes-cadeaux → Créer** | Champ | Type *Montant fixe* | Type *Montant aléatoire* | @@ -101,6 +104,8 @@ Cliquez **Créer** : la carte apparaît dans la liste et peut être envoyée man ## 6. Expérience côté client +![img](/img/next_gen/extensions/addons/giftcards/giftcards_client_view.png) + > Menu **Mon compte → Moyens de paiement → Cartes-cadeaux** 1. **Ajouter une carte-cadeau** @@ -126,15 +131,3 @@ Cliquez **Créer** : la carte apparaît dans la liste et peut être envoyée man 3. **Expiration raisonnable** : 6 – 12 mois suffisent tout en respectant les obligations légales locales. 4. **Limitez les utilisations** : 1 par défaut ; illimité seulement pour des besoins précis (ex. programme fidélité). 5. **Support** : conservez l’ID interne (#) pour toute demande de traçabilité. - ---- - -## 8. FAQ - -| Question | Réponse courte | -| ------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -| **Le client n’a pas reçu le mail avec le code ?** | Vérifiez le journal des e-mails et l’adresse déclarée ; renvoyez manuellement si besoin. | -| **Montant débité mais carte non créée ?** | Consultez les logs de paiement, régénérez une carte équivalente et créditez le client. | -| **Comment désactiver temporairement la vente ?** | Décochez **Autoriser l’achat de cartes-cadeaux** dans les paramètres globaux puis **Enregistrer**. | -| **Impossible d’utiliser une carte expirée ?** | Prolongez la date dans la fiche carte ou créez une nouvelle carte pour dédommager le client. | -| **Plusieurs devises ?** | Les cartes-cadeaux utilisent la devise principale ; changez la devise boutique avant de générer. | diff --git a/docs/extensions/addons/reselling_client.md b/docs/extensions/addons/reselling_client.md index aa94b1e..ffd0904 100644 --- a/docs/extensions/addons/reselling_client.md +++ b/docs/extensions/addons/reselling_client.md @@ -24,7 +24,7 @@ Pour toute demande ou pour devenir partenaire, veuillez contacter le support. Ce système garantit une gestion simplifiée des licences et des services VPS pour vos clients, tout en offrant flexibilité et automatisation. :::info Modules -Pour utiliser les fonctionnalités suivantes, il faut que le module Revente client soit activé sur votre CLIENTXCMS. [cliquez ici pour l'activer](../) +Pour utiliser les fonctionnalités suivantes, il faut que le module Plesk soit activé sur votre CLIENTXCMS. [cliquez ici pour l'activer](../) ::: ### Fonctionnalité supportées @@ -54,7 +54,7 @@ Ce n'est pas vos identifiants CLIENTXCMS, mais bien la clé d'API. Vous pouvez tester la connexion au serveur et vérifier que le serveur renvoie *"Success"* en réponse. ## Configuration de l'offre -En premier lieu, [créez votre produit](../../../settings/store/products#création) en sélectionnant "Reselling". +En premier lieu, [créez votre produit](../../settings/store/products.md#créer-un-nouveau-produit) en sélectionnant "Reselling". ![img](/img/next_gen/extensions/addons/reselling_client/image_2.png) Après appuyer sur le bouton "Créer" il vous crée votre produit et puis cliquer sur le bouton "Configurer l'offre" qui vous dirigera vers la page de configuration de l'offre. Si les champs est vide, assurez-vous que votre serveur ne soit pas caché, dans ce cas il ne sera pris en compte dans le système pour récupérer les offres de revente. diff --git a/docs/extensions/addons/sitemap.md b/docs/extensions/addons/sitemap.md index 11b151e..3f3a40d 100644 --- a/docs/extensions/addons/sitemap.md +++ b/docs/extensions/addons/sitemap.md @@ -1,4 +1,4 @@ -# Addon Sitemap +# Sitemap L'add-on **Sitemap** permet de générer un plan du site pour améliorer le référencement naturel (SEO) de votre site web. Il est accessible depuis la section **Extensions** et peut être configuré via les **paramètres des personnalisation**. diff --git a/docs/extensions/modules/Plesk.md b/docs/extensions/modules/Plesk.md index 9d867af..9f0e9ce 100644 --- a/docs/extensions/modules/Plesk.md +++ b/docs/extensions/modules/Plesk.md @@ -45,7 +45,7 @@ Le port suivant doit être ouvert pour connecter CLIENTXCMS à votre Plesk : 844 Vous pouvez tester la connexion au serveur et vérifier que le serveur renvoie *"Success"* en réponse. ## Configuration de l'offre -En premier lieu, [créez votre produit](../../../settings/store/products#création) en sélectionnant Plesk. +En premier lieu, [créez votre produit](../../settings/store/products.md#créer-un-nouveau-produit) en sélectionnant Plesk. ![img](/img/next_gen/extensions/modules/plesk/image_2.png) diff --git a/docs/extensions/modules/Proxmox.md b/docs/extensions/modules/Proxmox.md index 82c9f3a..a5fd525 100644 --- a/docs/extensions/modules/Proxmox.md +++ b/docs/extensions/modules/Proxmox.md @@ -166,7 +166,7 @@ N’oubliez pas d’intégrer les systèmes d’exploitation et modèles dans la ::: ## Configuration de l'offre -En premier lieu, [créez votre produit](../../../settings/store/products#création) en sélectionnant Proxmox. +En premier lieu, [créez votre produit](../../settings/store/products.md#créer-un-nouveau-produit) en sélectionnant Proxmox. ![img](/img/next_gen/extensions/modules/proxmox/image.png) diff --git a/docs/extensions/modules/Pterodactyl.md b/docs/extensions/modules/Pterodactyl.md index bce3772..59df9ff 100644 --- a/docs/extensions/modules/Pterodactyl.md +++ b/docs/extensions/modules/Pterodactyl.md @@ -112,7 +112,7 @@ Permettez à vos clients d'accéder à leur panel Pterodactyl en un clic depuis 1. Sur votre VPS, placez-vous dans le dossier du panel : ```bash cd /var/www/pterodactyl - composer require "clientxcms/sso-pterodactyl" + composer require "clientxcms/pterodactyl-sso" ``` 2. Videz le cache : ```bash @@ -129,8 +129,6 @@ Permettez à vos clients d'accéder à leur panel Pterodactyl en un clic depuis - **Clé** : `sso_key` - **Valeur** : le jeton SSO généré -Vérifiez que vous avez bien un SSL ainsi qu'un nom de domaine de définit dans le nom d'hôte de votre configuration serveur. - **Alternative avancée** : Vous pouvez aussi placer le jeton dans le `.env` de CLIENTXCMS avec la variable `SSO_CLIENTXCMS_KEY{SERVER_ID}` (remplacez `{SERVER_ID}` par l'ID du serveur). Dans ce cas, la meta donnée n'est pas nécessaire. diff --git a/docs/extensions/modules/VirtualizorCloud.md b/docs/extensions/modules/VirtualizorCloud.md index ad56906..b0193f4 100644 --- a/docs/extensions/modules/VirtualizorCloud.md +++ b/docs/extensions/modules/VirtualizorCloud.md @@ -44,7 +44,7 @@ Le port suivant doit être ouvert pour connecter CLIENTXCMS à votre Virtualizor Vous pouvez tester la connexion au serveur et vérifier que le serveur renvoie *"Success"* en réponse. ## Configuration de l'offre -En premier lieu, [créez votre produit](../../settings/store/products#création) en sélectionnant Virtualizor Cloud. +En premier lieu, [créez votre produit](../../settings/store/products.md#créer-un-nouveau-produit) en sélectionnant Virtualizor Cloud. ![img](/img/next_gen/extensions/modules/virtualizorcloud/image5.png) diff --git a/docs/extensions/modules/cPanel.md b/docs/extensions/modules/cPanel.md index 9c20d4a..ce1743c 100644 --- a/docs/extensions/modules/cPanel.md +++ b/docs/extensions/modules/cPanel.md @@ -50,7 +50,7 @@ Le port suivant doit être ouvert pour connecter CLIENTXCMS à votre WHM : 2087 Vous pouvez tester la connexion au serveur et vérifier que le serveur renvoie *"Success"* en réponse. ## Configuration de l'offre -En premier lieu, [créez votre produit](../../../settings/store/products#création) en sélectionnant cPanel. +En premier lieu, [créez votre produit](../../settings/store/products.md#créer-un-nouveau-produit) en sélectionnant cPanel. ![img](/img/next_gen/extensions/modules/cpanel/img_3.png) diff --git a/docs/getting_started/service.md b/docs/getting_started/service.md index f57dc73..8de39a0 100644 --- a/docs/getting_started/service.md +++ b/docs/getting_started/service.md @@ -30,7 +30,7 @@ La création ne crée pas de facture, il faudra passer par une commande sur votr Si vous avez un problème de livraison de service, rendez-vous sur `Espace Administation` > `Paramètres` > `Historique` et recherchez le fichier 'services-delivery.log'. Vous pouvez également consulter la page du module d'approvisionnement pour plus d'informations. ![img](/img/next_gen/services/delivery_log.png) -Par exemple, dans ce cas de figure, le service n'a pas pu être livré, car le pterodactyl n'a plus d'allocation disponible. Plus d'informations sur la configuration du module Pterodactyl [ici](/extensions/modules/pterodactyl#erreurs-courantes). +Par exemple, dans ce cas de figure, le service n'a pas pu être livré, car le pterodactyl n'a plus d'allocation disponible. Plus d'informations sur la configuration du module Pterodactyl [ici](../extensions/modules/Pterodactyl.md#erreurs-courantes). ## Aperçu d'un service Voici un aperçu d'un service. diff --git a/docs/settings/billing/billing.md b/docs/settings/billing/billing.md index fe6359d..d7b0359 100644 --- a/docs/settings/billing/billing.md +++ b/docs/settings/billing/billing.md @@ -1,66 +1,263 @@ --- sidebar_position: 3 --- + # Facturation -Vous pouvez configurer les paramètres de facturation de votre boutique en ligne. Pour ce faire, allez dans le menu `Paramètres` puis dans la section `Facturation` et enfin dans `Facturation`. -Vous retrouverez ici tous les paramètres de facturation. -### Configuration des conditions de paiement -Vous pouvez définir des des conditions générales de vente de votre boutique. Il sera demandé à l'utilisateur de les confirmer avant une commande. Elle sera affichée sur la page de paiement comme ceci. -![img](/img/next_gen/settings/store/billing/cgv.png) + +Dans **CLIENTXCMS**, la configuration de la **facturation** est le pilier de votre activité commerciale.
+L'objectif est essentiel : **maîtriser tous les aspects financiers de votre boutique** pour garantir une **conformité légale parfaite** et une **gestion optimale de vos revenus**. Une configuration de facturation bien pensée simplifie la comptabilité, améliore la relation client et vous protège juridiquement. + +La facturation gère automatiquement tous les aspects financiers : génération des factures, calcul des taxes, gestion des devises, et respect des réglementations. + +Vous pouvez gérer la facturation depuis : + +`Paramètres` > `Facturation` > `Facturation` + +:::tip Astuce +Une facturation bien configurée est **la base de la confiance** avec vos clients et de votre conformité légale. +Prenez le temps de bien paramétrer chaque option selon votre contexte juridique et commercial. +::: + +## Pourquoi bien configurer la facturation ? + +La facturation automatisée est cruciale pour : + +* **Respecter les obligations légales** en matière de TVA et de facturation +* **Automatiser la génération** des factures et la gestion comptable +* **Améliorer l'expérience client** avec des factures claires et professionnelles +* **Simplifier votre comptabilité** et faciliter les déclarations fiscales + +:::tip Astuce +C'est comme avoir un comptable intégré qui travaille 24h/24 📊 — précis, fiable et toujours conforme aux réglementations. +::: + +## Configuration de base + +### Devise principale + +**Devise** | (menu déroulant)
+La devise principale de votre boutique, utilisée par défaut pour tous les prix et factures. +Choisissez parmi une liste de devises internationales (EUR, USD, GBP, etc.). + +:::info Note +Vous pourrez définir des devises spécifiques par produit ultérieurement pour une boutique internationale. +::: + +### Adresse commerciale + +**Adresse de l'espace client** | (zone de texte)
+L'adresse légale de votre entreprise qui apparaîtra sur toutes les factures. +Cette information est obligatoire pour la conformité légale. + +![Affichage de l'adresse sur les factures](/img/next_gen/settings/store/billing/address.png) + +Incluez : +- Nom de l'entreprise +- Adresse complète +- Code postal et ville +- Pays +- Numéro SIRET/TVA si applicable + +## Configuration des taxes + ### Mode de taxe -ClientXCMS permet de configurer plusieurs modes de taxe pour votre boutique. Vous pouvez choisir entre les modes suivants : -- **Exclusif** : Les prix affichés dans la boutique n'incluent pas la taxe. La taxe sera ajoutée au prix lors du paiement. -- **Inclusif** : Les prix affichés dans la boutique incluent la taxe. Le prix affiché est le prix final. -### Devise -Vous pouvez configurer la devise de votre boutique. Vous pouvez choisir parmi une liste de devises prédéfinies. Vous pourrez par la suite définir plusieurs devises pour votre boutique sur les produits -### Adresse de l'espace client -Vous pouvez définir l'adresse de l'espace client. Cette adresse sera affichée sur les factures comme ceci -![img](/img/next_gen/settings/store/billing/address.png) -### Termes et conditions de la facture -Vous pouvez définir des termes et conditions de la facture (par exemple TVA non applicable). Ils seront affichés sur la facture comme ceci - -![img](/img/next_gen/settings/store/billing/invoice_terms.png) - -## Mode de facturation -Vous pouvez configurer le mode de facturation de votre boutique. Vous pouvez choisir entre les modes suivants : -- **Facture** : Les clients recevrons une facture classique -- **Proforma** : Les clients recevrons une facture proforma puis une facture classique une fois le paiement effectué -## Taux de TVA -Vous pouvez définir un taux de TVA par défaut pour votre boutique. Ce taux sera utilisé pour les factures si le taux de TVA n'est pas défini pour un client. Vous pouvez choisir entre deux modes suivants : -- **Taux fixe** : Un taux de TVA unique pour tous les clients & produits -- **Taux variable** : Un taux de TVA défini par le pays du client. - -Selon la législation européenne, en cas de vente à un client particulier, vous devez facturer la TVA française jusqu'à 10 000 € de vente totales dans l'UE. Au-delà de ce montant, vous devez facturer la TVA du pays du client. -## Prefixe de facture -Vous pouvez définir un préfixe pour les factures. Par exemple, si vous définissez le préfixe à `INV-`, les factures seront nommées `INV-2024-08-0001`, `INV-2024-08-0001`, etc. - -![img](/img/next_gen/settings/store/billing/invoice_prefix.png) -## Activation de la TVA -Vous pouvez activer la TVA pour votre boutique. Vous pouvez définir un taux de TVA personalisé pour chaque client ou la possiblité de ne pas appliquer la TVA pour certains clients. -Pour ceci, vous devez rajouter une métadonnée `vat_percent` avec le pourcentage allant de 0 à 100% ou la metadonnée `vat_disabled` à `true` pour désactiver simplement pour un client. -## Forcer la confirmation pour commander -Vous pouvez forcer la confirmation pour commander. Les clients devront confirmer leur compte avant de pouvoir payer. -## Actions sur les factures en attente -Vous pouvez définir des actions sur les factures en attente après X jours. Vous pouvez choisir entre les actions suivantes : -- Annuler la facture -- Supprimer la facture -Cela permet de gérer les factures en attente automatiquement. Vous pouvez utiliser 0 pour désactiver cette fonctionnalité. -## Webhook de paiement -Vous pouvez configurer un webhook de paiement pour votre boutique. Vous pouvez définir une URL de webhook qui sera appelée lorsqu'une commande est payée. -Vous pouvez créer un webhook depuis discord ou un autre service. Voici un pour créer un webhook sur discord. -- Allez dans les paramètres de votre serveur -- Allez dans la section `Intégrations` -- Cliquez sur `Créer une intégration` -- Donnez un nom à votre webhook -- Copiez l'URL du webhook -- Collez l'URL dans le champ `URL du webhook` -- Cliquez sur `Enregistrer` - -Voici un aperçu d'un webhook discord : - -![img](https://cdn.clientxcms.com/ressources/docs/order.png) - -## Amélorations des services -**Ajouter des frais de configuration lors d'un amélioration** : Cela permet d'appliquer les frais d'installation lors d'un amélioration de service. - -**Délais minimum en jours pour forcer le renouvellement avec une amélioration** : Cela permet de forcer le renouvellement d'un service avec une amélioration si le nombre de jours restant est inférieur à ce nombre de jours. \ No newline at end of file + +CLIENTXCMS propose deux modes de gestion des prix : + +**Exclusif** | Mode hors taxes
+Les prix affichés dans la boutique **n'incluent pas** la TVA. +La taxe est ajoutée lors du calcul final au panier. + +**Inclusif** | Mode toutes taxes comprises
+Les prix affichés incluent déjà la TVA. +Le prix affiché est le prix final payé par le client. + +:::tip Conseil +Le mode **inclusif** est généralement préféré pour le B2C car il évite les surprises au client, tandis que le mode **exclusif** est courant en B2B. +::: + +### Gestion de la TVA + +**Activation de la TVA** | (interrupteur)
+Active ou désactive la gestion de la TVA sur votre boutique. + +**Taux de TVA par défaut** | (pourcentage)
+Le taux appliqué par défaut si aucun taux spécifique n'est défini. + +#### Modes de calcul de la TVA + +**Taux fixe** | Taux unique
+Un seul taux de TVA appliqué à tous les clients et produits. +Idéal pour une activité locale ou un pays unique. + +**Taux variable** | Selon la localisation
+Le taux de TVA varie selon le pays du client. +Essentiel pour la vente internationale et la conformité européenne. + +:::warning Important - Réglementation européenne +Selon la législation européenne, pour les ventes B2C : +- **Jusqu'à 10 000€** de ventes totales dans l'UE : TVA française +- **Au-delà de 10 000€** : TVA du pays du client +::: + +### TVA personnalisée par client + +Pour des cas spécifiques, vous pouvez personnaliser la TVA : + +| Métadonnée | Valeur | Effet | +|------------|--------|-------| +| `vat_percent` | `0` à `100` | Taux de TVA personnalisé | +| `vat_disabled` | `true` | Désactive la TVA pour ce client | + +## Modes de facturation + +### Types de factures + +**Facture classique** | Mode standard
+Les clients reçoivent directement une facture définitive après paiement. +Adapté à la plupart des cas d'usage. + +**Facture proforma** | Mode pro
+Les clients reçoivent d'abord une facture proforma (devis), puis une facture définitive après paiement. +Idéal pour les commandes importantes ou les processus d'achat complexes. + +### Numérotation des factures + +**Préfixe de facture** | (texte)
+Personnalisez le préfixe de vos numéros de facture. +Par exemple : `INV-` donnera `INV-2024-08-0001` + +![Exemple de préfixe de facture](/img/next_gen/settings/store/billing/invoice_prefix.png) + +:::tip Bonnes pratiques +- Utilisez un préfixe court et reconnaissable +- Incluez l'année pour faciliter l'archivage +- Respectez une logique cohérente dans le temps +::: + +## Conditions commerciales + +### Conditions générales de vente + +**CGV** | (zone de texte ou lien)
+Définissez vos conditions générales de vente qui seront présentées lors du processus de commande. +Les clients devront les accepter avant de pouvoir finaliser leur achat. + +![Affichage des CGV lors du paiement](/img/next_gen/settings/store/billing/cgv.png) + +### Termes et conditions des factures + +**Mentions légales** | (zone de texte)
+Ajoutez des mentions spécifiques qui apparaîtront sur toutes vos factures. +Par exemple : "TVA non applicable", "Auto-entrepreneur", "Dispensé d'immatriculation". + +![Affichage des termes sur les factures](/img/next_gen/settings/store/billing/invoice_terms.png) + +## Sécurité et validation + +### Confirmation de compte + +**Forcer la confirmation pour commander** | (case à cocher)
+Oblige les clients à valider leur adresse e-mail avant de pouvoir effectuer un achat. +Recommandé pour réduire les commandes frauduleuses. + +## Gestion automatisée + +### Actions sur les factures impayées + +**Délai d'action** | (nombre de jours)
+Définit après combien de jours les factures impayées sont traitées automatiquement. + +**Actions disponibles** : +- **Annuler la facture** : Marque la facture comme annulée +- **Supprimer la facture** : Supprime définitivement la facture + +Utiliser `0` désactive cette fonctionnalité. + +:::warning Attention +La suppression automatique des factures peut impacter votre comptabilité. Préférez l'annulation pour conserver l'historique. +::: + +## Notifications et intégrations + +### Webhooks de paiement + +**URL du webhook** | (URL)
+Configurez une URL qui sera appelée automatiquement à chaque paiement réussi. +Idéal pour intégrer avec Discord, Slack ou vos propres systèmes. + +#### Configuration d'un webhook Discord + +1. Accédez aux paramètres de votre serveur Discord +2. Section `Intégrations` → `Créer une intégration` +3. Nommez votre webhook et sélectionnez le canal +4. Copiez l'URL générée +5. Collez-la dans le champ webhook de ClientXCMS + +![Exemple de notification Discord](https://cdn.clientxcms.com/ressources/docs/order.png) + +Les webhooks permettent de : +- Recevoir des notifications en temps réel +- Synchroniser avec des outils externes +- Automatiser des processus post-vente + +## Gestion des upgrades + +### Améliorations de services + +**Frais de configuration sur upgrade** | (case à cocher)
+Applique les frais d'installation configurés lors d'une amélioration de service. +Utile pour facturer les coûts de migration ou de reconfiguration. + +**Délai minimum pour renouvellement forcé** | (nombre de jours)
+Force le renouvellement du service lors d'un upgrade si moins de X jours restent avant expiration. +Évite les calculs de facturation complexes sur de courtes périodes. + +## Exemples de configuration + +### Configuration micro-entreprise (France) + +``` +Mode de taxe : Inclusif +TVA : Désactivée +Termes facture : "TVA non applicable, art. 293 B du CGI" +Préfixe : "ME-" +``` + +### Configuration société soumise à TVA + +``` +Mode de taxe : Exclusif +TVA : Activée (20%) +Mode TVA : Taux variable (UE) +Préfixe : "FACT-" +``` + +### Configuration boutique internationale + +``` +Devise : EUR +Mode de taxe : Inclusif +TVA : Taux variable +Webhook : Configuré pour Slack +``` + +## Bonnes pratiques + +### Conformité légale + +1. **Vérifiez régulièrement** les taux de TVA en vigueur +2. **Documentez vos choix** de configuration pour les audits +3. **Testez les factures** avec différents profils clients +4. **Sauvegardez** vos paramètres avant modifications + +### Optimisation commerciale + +1. **Mode inclusif** pour réduire l'abandon de panier +2. **CGV claires** pour éviter les litiges +3. **Webhooks configurés** pour un suivi temps réel +4. **Préfixes cohérents** pour faciliter la comptabilité + +:::tip À retenir +La facturation est le cœur financier de votre activité. Une configuration rigoureuse vous fait gagner du temps, évite les erreurs et renforce la confiance de vos clients. Investissez le temps nécessaire pour bien la paramétrer dès le début. +::: diff --git a/docs/settings/core/_category_.json b/docs/settings/core/_category_.json index 7006e0b..e1e3120 100644 --- a/docs/settings/core/_category_.json +++ b/docs/settings/core/_category_.json @@ -1,4 +1,4 @@ { - "label": "Général", + "label": "Globaux", "position": 1 } diff --git a/docs/settings/core/app.md b/docs/settings/core/app.md index c322190..f8c941e 100644 --- a/docs/settings/core/app.md +++ b/docs/settings/core/app.md @@ -1,40 +1,240 @@ --- sidebar_position: 1 --- -# Paramètres globaux -Les paramètres globaux sont des paramètres qui affectent l'ensemble de votre espace client. Vous pouvez les retrouver en allant dans `Paramètres` > `Paramètres généraux` > `Paramètres globaux`. -**Nom de l'espace client** : Vous pouvez définir le nom de votre espace client. Par défaut, il est de "ClientXCMS". +import ThemedImage from '@theme/ThemedImage'; -**Environement de l'espace client** : Vous pouvez définir l'environement de votre espace client. Par défaut, il est de "Production". +# Application -**Mode debug** : Vous pouvez activer ou désactiver le mode debug. Par défaut, il est désactivé. +La configuration de l'**application** définit l'identité et le comportement global de votre **CLIENTXCMS**. C'est ici que vous personnalisez l'apparence, définissez les paramètres techniques et adaptez l'interface à votre image de marque.
+L'objectif est clair : **créer une expérience cohérente et professionnelle** qui reflète votre identité tout en optimisant les performances techniques. -**Fuseau horaire** : Vous pouvez définir le fuseau horaire de votre espace client. Par défaut, il est de "Europe/Paris". +Chaque paramètre de l'application influence directement l'expérience utilisateur, de l'affichage du logo à la gestion des erreurs techniques. -**Langue** : Vous pouvez définir la langue de votre espace client. Par défaut, il est en français. +:::tip Astuce +Une application bien configurée inspire confiance. Personnalisez chaque détail pour que vos clients reconnaissent immédiatement votre marque et bénéficient d'une expérience fluide. +::: -**Logo de l'espace client** : Vous pouvez définir le logo de votre espace client. +## Paramètres essentiels -**Favicon de l'espace client** : Vous pouvez définir le favicon de votre espace client. +### Identité de l'application -**Logo texte de l'espace client** : Vous pouvez définir le logo texte de votre espace client. +**Nom de l'espace client** | (texte)
+Le nom qui apparaît dans l'interface et les communications. Ce nom est visible dans : +- Le titre des pages du navigateur +- Les emails envoyés aux clients +- L'interface d'administration +- Les factures et documents -## Différences entre les environnements +**URL de l'application** | (URL)
+L'adresse complète de votre installation ClientXCMS. Assurez-vous d'utiliser : +- HTTPS en production (obligatoire pour la sécurité) +- Un domaine stable et professionnel +- Une URL sans slash final -### Environnement de développement -L'environnement de développement est utilisé pour tester les nouvelles fonctionnalités et les modifications avant de les déployer en production. Il est recommandé de ne pas utiliser l'environnement de développement pour les clients. +**Logo de l'espace client** | (image)
+Le logo principal affiché dans l'interface. Recommandations : +- Format : PNG ou SVG pour la transparence +- Dimensions : 200x200px minimum +- Poids : Moins de 500 Ko +- Fond transparent privilégié -### Environnement de production -L'environnement de production est utilisé pour les clients. Il est recommandé de ne pas utiliser l'environnement de production pour tester les nouvelles fonctionnalités et les modifications. +**Logo texte de l'espace client** | (image)
+Version horizontale du logo avec texte, utilisée dans : +- La barre de navigation principale +- Les emails +- Les documents PDF -## Différente entre le mode debug activé et désactivé -La différence entre le mode debug activé et désactivé est que le mode debug activé affiche les erreurs et les avertissements. Il est recommandé de ne pas activer le mode debug pour les clients. +**Favicon de l'espace client** | (image)
+L'icône affichée dans l'onglet du navigateur. Spécifications : +- Format : ICO, PNG ou SVG +- Dimensions : 32x32px ou 64x64px +- Poids : Moins de 100 Ko + +### Configuration technique + +**Environnement de l'espace client** | (menu déroulant)
+Détermine le mode de fonctionnement : + +| Environnement | Usage | Caractéristiques | +|---------------|-------|------------------| +| **Production** | Clients réels | Cache activé, erreurs masquées, performances optimisées | +| **Développement** | Tests et debug | Cache désactivé, erreurs détaillées, outils de debug | + +**Mode debug** | (case à cocher)
+Active l'affichage détaillé des erreurs. À utiliser uniquement en développement : +- ✅ **Activé** : Affiche les erreurs techniques détaillées +- ❌ **Désactivé** : Affiche des messages d'erreur génériques + +**Fuseau horaire** | (menu déroulant)
+Définit la référence temporelle pour : +- Les timestamps dans les logs +- La génération des factures +- Les horaires affichés aux clients +- Les tâches planifiées (cron) + +**Langue par défaut** | (menu déroulant)
+La langue utilisée quand aucune préférence n'est définie. Impact : +- Interface pour les nouveaux visiteurs +- Emails système +- Messages d'erreur +- Documentation intégrée + +## Différences entre les logos + +### Logo standard +Le logo carré ou vertical, utilisé comme icône : +- Page de connexion +- Emails (en-tête) +- Favicon agrandi +- Applications mobiles + +Exemple de dimensions recommandées : +- 512x512px pour une qualité optimale +- 256x256px pour un usage standard +- 128x128px minimum accepté -## Différence entre logo et logo texte -Le logo est l'image sans texte ou label à coté. Le logo texte un logo plus en longeur avec le nom ou un label à coté. -Si vous avez qu'une seule version de logo, vous pouvez utiliser le logo pour le logo texte. -### Logo -[](https://clientxcms.com/storage/app_favicon2889.png) ### Logo texte -[](https://clientxcms.com/assets/images/logo/LogoBlueText.png) +Version horizontale incluant le nom de votre entreprise : +- Barre de navigation +- Factures PDF +- Signatures email +- Documents officiels + +Exemple de dimensions recommandées : +- 300x100px pour la navigation +- 600x200px pour les documents +- Ratio 3:1 idéal + +:::tip Conseil +Si vous n'avez qu'une version de logo, utilisez-la pour les deux emplacements. Le système adaptera automatiquement l'affichage selon le contexte. +::: + +## Impact des environnements + +### Environnement Production + +Optimisé pour les performances et la sécurité : + +**Avantages :** +- Cache complet activé +- Compression des assets +- Minification du code +- Logs d'erreurs uniquement + +**Configuration automatique :** +- Sessions sécurisées (HTTPS only) +- Headers de sécurité renforcés +- Limitation du rate limiting +- Optimisation des requêtes DB + +### Environnement Développement + +Conçu pour faciliter le debug et les tests : + +**Avantages :** +- Rechargement automatique +- Profiler de performances +- Logs détaillés +- Accès aux routes de debug + +**Attention :** +- Performances réduites +- Informations sensibles visibles +- Cache désactivé +- Consommation mémoire accrue + +:::warning Important +Ne jamais utiliser l'environnement de développement avec de vrais clients. Les informations techniques exposées peuvent compromettre la sécurité de votre installation. +::: + +## Configuration avancée + +### Optimisation des performances + +Pour des performances optimales : + +1. **Images optimisées** + - Compressez les logos avant upload + - Utilisez des formats modernes (WebP, AVIF) + - Respectez les dimensions recommandées + +2. **Cache navigateur** + - Les assets sont cachés automatiquement + - Versioning automatique lors des changements + - Headers de cache optimisés + +3. **CDN et assets** + - Compatible avec les CDN majeurs + - Assets statiques séparables + - Chargement asynchrone + +### Personnalisation poussée + +Au-delà de l'interface, vous pouvez : + +- **Thème personnalisé** : CSS custom via l'interface +- **Templates email** : Personnalisation complète +- **Pages d'erreur** : Design sur mesure +- **Favicon multi-résolution** : Pour tous les devices + +## Bonnes pratiques + +### Checklist de configuration + +- [ ] Nom d'application professionnel et mémorable +- [ ] URL en HTTPS avec certificat valide +- [ ] Logos en haute résolution +- [ ] Favicon distinctif et visible +- [ ] Fuseau horaire correct +- [ ] Mode production activé +- [ ] Debug désactivé + +### Maintenance régulière + +- **Vérifiez** : Les certificats SSL mensuellement +- **Testez** : L'affichage sur différents navigateurs +- **Optimisez** : Les images si les temps de chargement augmentent +- **Mettez à jour** : Les informations selon l'évolution de votre marque + +### Sécurité + +- **HTTPS obligatoire** : Redirigez tout le trafic HTTP +- **Headers sécurisés** : CSP, HSTS, X-Frame-Options +- **Environnement production** : Pour tous les sites publics +- **Logs sécurisés** : Stockage hors de la racine web + +:::info À retenir +La configuration de l'application est votre première impression. Un paramétrage soigné avec des visuels professionnels et des réglages techniques appropriés pose les bases d'une relation de confiance avec vos clients. +::: + +## Dépannage courant + +| Problème | Cause probable | Solution | +|----------|----------------|----------| +| Logo non affiché | Format non supporté ou taille excessive | Vérifier format (PNG/JPG/SVG) et taille (moins de 2MB) | +| Favicon invisible | Cache navigateur | Vider le cache ou ajouter ?v=2 à l'URL | +| Erreurs non visibles | Mode production activé | Consulter les logs serveur | +| Heures incorrectes | Mauvais fuseau horaire | Vérifier config PHP et système | + +## Migration et sauvegarde + +### Export de configuration + +Sauvegardez régulièrement : +- Les logos et favicon +- Le fichier `.env` +- La base de données +- Les personnalisations CSS + +### Import sur nouvelle instance + +1. Restaurer la base de données +2. Copier les fichiers media +3. Mettre à jour le `.env` +4. Vider tous les caches +5. Tester en environnement dev d'abord + +:::tip Astuce finale +Votre configuration d'application est unique. Documentez vos choix et conservez des sauvegardes des assets originaux. Cela facilitera les futures évolutions et migrations. +::: \ No newline at end of file diff --git a/docs/settings/core/core.md b/docs/settings/core/core.md index 5e843b4..339646d 100644 --- a/docs/settings/core/core.md +++ b/docs/settings/core/core.md @@ -1,4 +1,215 @@ +--- +sidebar_position: 0 +--- + +import ThemedImage from '@theme/ThemedImage'; + +# Paramètres généraux + +Les **paramètres généraux** constituent le socle de configuration de votre **CLIENTXCMS**. C'est ici que vous définissez l'identité de votre hébergement, configurez les fonctionnalités essentielles et personnalisez l'expérience utilisateur.
+L'objectif est simple : **adapter le CMS à vos besoins spécifiques** pour offrir une plateforme professionnelle et cohérente à vos clients. + +Les paramètres généraux regroupent plusieurs aspects fondamentaux : les informations de l'application, la licence, les langues, les emails et la maintenance. + +Vous pouvez gérer ces paramètres depuis : + +`Paramètres` > `Paramètres Généraux` > `Paramètres globaux` + + + +:::tip Astuce +Des paramètres bien configurés sont la base d'un hébergement professionnel. Prenez le temps de personnaliser chaque aspect pour refléter votre identité et optimiser l'expérience de vos clients. +::: + +## Vue d'ensemble + +### Architecture des paramètres + +Les paramètres généraux s'organisent autour de plusieurs composants : + +* **[Application](./app)** : Configuration globale du CMS (nom, URL, timezone, etc.) +* **[Licence](./license)** : Gestion de votre licence ClientXCMS +* **[Langues](./locales)** : Configuration multilingue et traductions +* **[Email](./mail)** : Paramètres d'envoi des emails +* **[Maintenance](./maintenance)** : Mode maintenance et messages personnalisés + +### Impact des paramètres + +Les paramètres généraux affectent : +- L'apparence globale de votre plateforme +- Les communications avec vos clients +- La disponibilité des services +- L'expérience utilisateur multilingue +- La conformité légale et technique + +## Configuration initiale + +### Ordre de configuration recommandé + +Pour une mise en place optimale, suivez cet ordre : + +1. **Configuration de l'application** + - Définir le nom et l'URL + - Configurer la timezone + - Paramétrer les options générales + +2. **Activation de la licence** + - Entrer votre clé de licence + - Vérifier l'activation + - Contrôler les limites + +3. **Configuration des emails** + - Paramétrer le serveur SMTP + - Définir les adresses d'envoi + - Tester l'envoi + +4. **Configuration des langues** + - Activer les langues souhaitées + - Définir la langue par défaut + - Personnaliser les traductions + +5. **Préparation de la maintenance** + - Créer des messages personnalisés + - Tester le mode maintenance + - Préparer les procédures + +:::warning Important +Certains paramètres nécessitent un redémarrage des services ou une reconstruction du cache. Planifiez vos modifications importantes en dehors des heures de pointe. +::: + +## Paramètres critiques + +### Sécurité et performance + +Certains paramètres ont un impact direct sur la sécurité et les performances : + +| Paramètre | Impact | Recommandation | +|-----------|--------|----------------| +| **URL de l'application** | Sécurité HTTPS | Toujours utiliser HTTPS en production | +| **Timezone** | Logs et facturation | Définir selon votre zone géographique | +| **Configuration email** | Communications clients | Utiliser un serveur SMTP dédié | +| **Mode debug** | Sécurité | Désactiver en production | + +### Conformité légale + +Assurez-vous de configurer : +- Les mentions légales dans l'application +- Les emails conformes au RGPD +- Les langues selon votre marché +- Les informations de contact + +## Bonnes pratiques + +### Organisation + +- **Documentez vos changements** : Gardez une trace des modifications +- **Testez en préproduction** : Validez avant d'appliquer en production +- **Sauvegardez** : Avant toute modification majeure +- **Planifiez** : Les changements impactants hors heures de pointe + +### Maintenance régulière + +- **Vérifiez la licence** : Renouvellement et limites +- **Testez les emails** : Délivrabilité mensuelle +- **Mettez à jour** : Les traductions selon les retours +- **Contrôlez** : Les logs d'erreurs régulièrement + +### Optimisation + +- **Cache** : Activez le cache pour les performances +- **CDN** : Utilisez un CDN pour les assets statiques +- **Compression** : Activez la compression des réponses +- **Monitoring** : Surveillez les performances + +:::tip Conseil +Les paramètres généraux sont le fondement de votre installation. Une configuration soignée dès le départ vous évitera de nombreux problèmes par la suite et améliorera l'expérience de vos clients. +::: + +## Cas d'usage courants + +### Nouveau déploiement + +1. Configurez d'abord l'application avec les bonnes URLs +2. Activez votre licence +3. Configurez les emails avant d'inviter des utilisateurs +4. Personnalisez les langues selon votre marché +5. Préparez les messages de maintenance + +### Migration depuis un autre système + +1. Planifiez une fenêtre de maintenance +2. Configurez les redirections d'URLs +3. Importez les traductions personnalisées +4. Testez exhaustivement les emails +5. Validez la licence pour le nouveau domaine + +### Expansion internationale + +1. Activez les nouvelles langues nécessaires +2. Traduisez les contenus essentiels +3. Adaptez les fuseaux horaires si nécessaire +4. Configurez des emails multilingues +5. Testez l'expérience dans chaque langue + +## Dépannage fréquent + +### Problèmes courants + +| Problème | Cause probable | Solution | +|----------|----------------|----------| +| Emails non reçus | Configuration SMTP incorrecte | Vérifier les paramètres et logs | +| Erreurs de timezone | Mauvaise configuration | Vérifier PHP et système | +| Licence invalide | Domaine non autorisé | Contacter le support | +| Traductions manquantes | Cache non vidé | Vider le cache des traductions | + +### Logs et diagnostics + +Consultez les logs dans : +- `/storage/logs/` pour les erreurs applicatives +- Logs du serveur mail pour les problèmes SMTP +- Console navigateur pour les erreurs JavaScript +- Logs serveur web pour les erreurs HTTP + +## Intégrations avancées + +### Variables d'environnement + +Certains paramètres peuvent être définis via `.env` : +- Configuration base de données +- Paramètres de cache +- Clés API externes +- Mode debug + +### Hooks et événements + +ClientXCMS permet d'intercepter : +- Les changements de configuration +- Les envois d'emails +- Les changements de langue +- Les activations de maintenance + +### API de configuration + +Utilisez l'API pour : +- Automatiser les déploiements +- Synchroniser les configurations +- Monitorer les paramètres +- Déclencher des actions + +:::info À retenir +Les paramètres généraux sont le cœur de votre installation ClientXCMS. Une configuration réfléchie et une maintenance régulière garantissent une expérience optimale pour vos clients et une gestion sereine pour vous. +::: + +## Ressources complémentaires + +Pour approfondir la configuration de vos paramètres généraux, consultez : + import DocCardList from '@theme/DocCardList'; -# Général \ No newline at end of file diff --git a/docs/settings/core/license.md b/docs/settings/core/license.md index c7ccd43..3f39c0d 100644 --- a/docs/settings/core/license.md +++ b/docs/settings/core/license.md @@ -1,15 +1,288 @@ --- -sidebar_position: 6 +sidebar_position: 2 --- # Licence -La licence permet de synchroniser votre instances à clientxcms. Cela permet d'avoir accès à vos extensions. -Vous pouvez voir les informations de votre licence depuis `Paramètres` puis dans la section `Paramètres généraux` et enfin dans `Licences`. -## Information sur la license -![img](/img/next_gen/settings/core/license/license.png) +La **licence** est l'élément qui authentifie et active votre installation **CLIENTXCMS**. C'est elle qui débloque les fonctionnalités, synchronise vos extensions et garantit l'accès aux mises à jour.
+L'objectif est clair : **valider votre installation et débloquer tout le potentiel** de votre CMS selon l'offre souscrite. -## Améliorer la licence -Vous pouvez augmenter la limitation de votre licence à l'offre supérieure. Il suffit de payer la différence entre les deux offres. -## Réactualiser la licence -En cas d'achat de nouvelle extensions, vous pouvez forcer la réactualisation en appuyant sur le bouton "forcer l'actualisation". \ No newline at end of file +La licence permet la synchronisation avec les serveurs ClientXCMS, l'activation des modules achetés et le respect des limites de votre forfait. + +Vous pouvez gérer votre licence depuis : + +`Paramètres` > `Paramètres généraux` > `Licence` + +![Interface de gestion de la licence](/img/next_gen/settings/core/license/license.png) + +:::tip Astuce +Une licence active et à jour est essentielle pour le bon fonctionnement de votre hébergement. Elle garantit l'accès aux dernières fonctionnalités, aux correctifs de sécurité et au support technique. +::: + +## Comprendre votre licence + +### Informations affichées + +L'interface de licence présente plusieurs informations cruciales : + +**Statut de la licence** | (indicateur)
+État actuel de votre licence : +- 🟢 **Active** : Licence valide et fonctionnelle +- 🟡 **Expirée** : Renouvellement nécessaire +- 🔴 **Invalide** : Problème d'activation ou de validation +- ⚪ **Suspendue** : Compte temporairement désactivé + +**Type de licence** | (texte)
+L'offre souscrite qui détermine : +- Le nombre de clients autorisés +- Les modules disponibles +- Les fonctionnalités débloquées +- Le niveau de support inclus + +**Date d'expiration** | (date)
+Échéance de votre licence actuelle. Important pour : +- Planifier le renouvellement +- Éviter les interruptions de service +- Maintenir l'accès aux mises à jour + +**Limites d'utilisation** | (compteurs)
+Visualisation de votre consommation : +- Nombre de clients actifs / limite +- Services créés / maximum autorisé +- Extensions activées / disponibles + +### Types de licences disponibles + +| Type | Clients max | Fonctionnalités | Support | Usage recommandé | +|------|-------------|-----------------|---------|------------------| +| **Starter** | 50 | Essentielles | Community | Petits hébergeurs, tests | +| **Business** | 500 | Complètes | Standard | Hébergeurs établis | +| **Enterprise** | Illimité | Toutes + API | Prioritaire | Grandes structures | +| **Developer** | 10 | Toutes | Technique | Développement, tests | + +## Activation de la licence + +### Première activation + +Pour activer votre licence sur une nouvelle installation : + +1. **Obtenez votre clé** + - Connectez-vous sur [clientxcms.com](https://clientxcms.com) + - Accédez à votre espace client + - Copiez la clé de licence + +2. **Entrez la clé** + - Collez la clé dans le champ prévu + - Vérifiez l'absence d'espaces + - Validez l'activation + +3. **Vérification automatique** + - Connexion aux serveurs ClientXCMS + - Validation du domaine + - Téléchargement des extensions + +### Validation du domaine + +La licence est liée à votre domaine pour des raisons de sécurité : + +**Domaines autorisés :** +- Domaine principal (exemple.com) +- Sous-domaines (*.exemple.com) +- Domaines de développement déclarés + +**Changement de domaine :** +1. Connectez-vous à votre espace client +2. Modifiez le domaine autorisé +3. Réactivez la licence +4. Attendez la propagation (5-10 minutes) + +:::warning Important +Un changement de domaine nécessite une validation manuelle si effectué plus de 3 fois par mois. Ceci pour éviter les abus et protéger votre licence. +::: + +## Gestion des extensions + +### Synchronisation automatique + +La licence synchronise automatiquement : +- Les modules achetés +- Les thèmes premium +- Les plugins additionnels +- Les mises à jour disponibles + +### Activation manuelle + +Pour activer une nouvelle extension : + +1. **Achat sur la marketplace** + - Sélectionnez l'extension + - Procédez au paiement + - Extension ajoutée à votre compte + +2. **Synchronisation** + - Cliquez sur "Forcer l'actualisation" + - Attendez la synchronisation + - L'extension apparaît dans la liste + +3. **Installation** + - Accédez aux extensions + - Installez le nouveau module + - Configurez selon vos besoins + +## Mise à niveau de licence + +### Pourquoi upgrader ? + +Passez à une licence supérieure pour : +- Augmenter le nombre de clients +- Débloquer des fonctionnalités +- Obtenir un meilleur support +- Supprimer les limitations + +### Processus d'upgrade + +1. **Évaluation des besoins** + - Analysez votre usage actuel + - Anticipez votre croissance + - Identifiez les fonctionnalités manquantes + +2. **Calcul du coût** + - Différence entre les offres + - Prorata temporel appliqué + - Pas de pénalité d'upgrade + +3. **Application immédiate** + - Paiement de la différence + - Activation instantanée + - Conservation des données + +:::tip Économie +L'upgrade est toujours au prorata. Si vous upgradez à mi-parcours de votre période de facturation, vous ne payez que la différence pour la période restante. +::: + +## Renouvellement + +### Notifications automatiques + +Le système vous prévient : +- 30 jours avant expiration (email) +- 15 jours avant (email + dashboard) +- 7 jours avant (alertes quotidiennes) +- Jour J (notifications urgentes) + +### Conséquences de l'expiration + +**Licence expirée depuis :** + +| Durée | Impact | Actions possibles | +|-------|--------|-------------------| +| 0-7 jours | Avertissements uniquement | Fonctionnement normal, renouvellement simple | +| 8-30 jours | Limitations activées | Pas de nouveaux clients, renouvellement requis | +| 31-60 jours | Mode lecture seule | Consultation uniquement, données préservées | +| 60+ jours | Accès administrateur bloqué | Contact support nécessaire | + +### Processus de renouvellement + +1. **Renouvellement automatique** (recommandé) + - Carte bancaire enregistrée + - Prélèvement à l'échéance + - Continuité de service garantie + +2. **Renouvellement manuel** + - Notification de rappel + - Paiement via espace client + - Activation immédiate + +## Résolution des problèmes + +### Erreurs courantes + +| Erreur | Cause | Solution | +|--------|-------|----------| +| "Licence invalide" | Clé incorrecte ou domaine non autorisé | Vérifier la clé et le domaine dans l'espace client | +| "Limite atteinte" | Dépassement du nombre de clients | Upgrader la licence ou archiver des clients | +| "Synchronisation échouée" | Problème de connexion | Vérifier pare-feu et connexion internet | +| "Extension non disponible" | Non incluse dans l'offre | Vérifier compatibilité ou acheter séparément | + +### Forcer l'actualisation + +Utilisez cette fonction quand : +- Une extension achetée n'apparaît pas +- Les limites affichées sont incorrectes +- Après un changement de domaine +- Suite à un upgrade de licence + +**Processus :** +1. Cliquez sur "Forcer l'actualisation" +2. Patientez pendant la synchronisation +3. Vérifiez les changements +4. Videz le cache si nécessaire + +### Logs de licence + +Consultez l'historique : +- Activations et désactivations +- Changements de domaine +- Upgrades et downgrades +- Tentatives de connexion échouées + +## Bonnes pratiques + +### Sécurité de la licence + +- **Ne partagez jamais** votre clé de licence +- **Protégez l'accès** à l'interface d'administration +- **Surveillez** les activations suspectes +- **Documentez** les changements de domaine + +### Optimisation de l'usage + +- **Monitorer** régulièrement vos limites +- **Archiver** les clients inactifs +- **Planifier** les upgrades selon la croissance +- **Profiter** des offres de renouvellement anticipé + +### Continuité de service + +- **Activez** le renouvellement automatique +- **Maintenez** vos informations de paiement à jour +- **Surveillez** les emails de notification +- **Gardez** une marge sur vos limites + +:::info À retenir +Votre licence est le cœur de votre installation ClientXCMS. Une gestion proactive garantit un fonctionnement optimal, l'accès aux dernières innovations et la tranquillité d'esprit pour vous concentrer sur votre activité. +::: + +## Support et assistance + +### Canaux disponibles + +Selon votre licence : + +**Community (Starter)** +- Forum communautaire +- Documentation en ligne +- FAQ et tutoriels + +**Standard (Business)** +- Tickets de support +- Délai de réponse : 24-48h +- Assistance technique + +**Prioritaire (Enterprise)** +- Support téléphonique +- Délai de réponse : 2-4h +- Gestionnaire de compte dédié + +### Informations à fournir + +Pour toute demande : +- Numéro de licence +- Domaine concerné +- Version de ClientXCMS +- Description détaillée du problème +- Captures d'écran si pertinent + +:::tip Conseil final +Une licence bien gérée est transparente au quotidien. Configurez les alertes, le renouvellement automatique et oubliez-la pour vous concentrer sur votre croissance. +::: \ No newline at end of file diff --git a/docs/settings/core/locales.md b/docs/settings/core/locales.md index bc85c15..1d6a7a3 100644 --- a/docs/settings/core/locales.md +++ b/docs/settings/core/locales.md @@ -1,19 +1,194 @@ +--- +sidebar_position: 3 +--- + # Langues -Vous pouvez autoriser plusieurs langues sur votre espace client afin d'aggrandir votre clientèle. Pour ceci rendez vous sur la page `Paramètres` puis dans la section `Paramètres généraux` et enfin dans `Langues` -![Langues](/img/next_gen/settings/core/locales/image.png) -## Télécharger une langue -Pour télécharger une langue, cliquez sur le bouton `Télécharger` de la langue souhaitée. -### Mis à jour -Des mises à jour peuvent être disponibles pour les langues. Pour les télécharger, cliquez sur le bouton `Mettre à jour` de la langue souhaitée. -:::info -Le bouton "Mettre à jour" n'apparait même si vous avez la dernière version de la langue. Cela permet de réinstaller la langue au besoin. +Dans **CLIENTXCMS**, la gestion des **langues** vous permet d'**internationaliser votre plateforme** et de **toucher une clientèle mondiale**.
+L'objectif est simple : **offrir une expérience native à chaque utilisateur** dans sa langue préférée et **élargir votre marché potentiel**. Une plateforme multilingue améliore l'accessibilité, renforce la confiance des clients internationaux et augmente vos opportunités commerciales. + +Le système de langues prend en charge l'interface complète, les e-mails automatiques et même vos contenus personnalisés. + +Vous pouvez gérer les langues depuis : + +`Paramètres` > `Paramètres généraux` > `Langues` + +![Accès à la configuration des langues](/img/next_gen/settings/core/locales/image.png) + +:::tip Astuce +Une plateforme disponible dans la langue native de vos clients **augmente significativement** les taux de conversion. +C'est un investissement minimal pour un impact commercial maximal. ::: -## Changement de langue par défaut -Vous pouvez changer la langue par défaut de votre espace client dans les paramètres généraux. -## Langue supportés -- Français -- Anglais -- Espagnol -- Allemand -- Italien \ No newline at end of file + +## Pourquoi proposer plusieurs langues ? + +Le multilinguisme est essentiel pour : + +* **Élargir votre marché** à l'international sans barrière linguistique +* **Améliorer l'expérience client** en proposant une interface native +* **Augmenter la confiance** des utilisateurs non francophones +* **Optimiser votre référencement** dans différents pays + +:::tip Astuce +C'est comme avoir plusieurs vitrines dans différents pays 🌍 — chaque client se sent chez lui, peu importe sa langue maternelle. +::: + +## Langues disponibles + +CLIENTXCMS propose actuellement les langues suivantes : + +| Langue | Code | Statut | +|--------|------|---------| +| 🇫🇷 **Français** | `fr` | Langue par défaut | +| 🇬🇧 **Anglais** | `en` | Disponible | +| 🇪🇸 **Espagnol** | `es` | Disponible | +| 🇩🇪 **Allemand** | `de` | Disponible | +| 🇮🇹 **Italien** | `it` | Disponible | + +:::info Note +D'autres langues peuvent être ajoutées sur demande de la communauté. Les traductions sont maintenues et améliorées régulièrement. +::: + +## Gestion des langues + +### Télécharger une langue + +Pour ajouter une nouvelle langue à votre plateforme : + +1. Accédez à la page de gestion des langues +2. Localisez la langue souhaitée dans la liste +3. Cliquez sur le bouton **"Télécharger"** +4. La langue sera automatiquement installée et activée + +:::tip Astuce +L'installation est instantanée et ne nécessite aucun redémarrage. Vos utilisateurs peuvent immédiatement changer de langue. +::: + +### Mettre à jour les traductions + +Les fichiers de langue sont régulièrement améliorés pour : +- Corriger d'éventuelles erreurs de traduction +- Ajouter les traductions des nouvelles fonctionnalités +- Améliorer la qualité linguistique + +Pour mettre à jour une langue : + +1. Le bouton **"Mettre à jour"** apparaît pour chaque langue installée +2. Cliquez dessus pour télécharger la dernière version +3. Les traductions sont mises à jour instantanément + +:::info Important +Le bouton "Mettre à jour" reste toujours visible, même si vous avez la dernière version. Cela permet de **réinstaller** la langue en cas de problème ou de personnalisation accidentelle. +::: + +## Configuration de la langue par défaut + +### Définir la langue principale + +La langue par défaut est celle affichée : +- Aux nouveaux visiteurs +- Lorsque la langue du navigateur n'est pas disponible +- Dans les communications système + +Pour la modifier : +1. Allez dans `Paramètres` > `Paramètres généraux` +2. Sélectionnez la nouvelle langue par défaut +3. Enregistrez les modifications + +### Comportement automatique + +CLIENTXCMS détecte automatiquement : +- La langue du navigateur du visiteur +- La préférence enregistrée de l'utilisateur connecté +- La langue par défaut si aucune correspondance + +## Impact sur votre plateforme + +### Éléments traduits + +Lorsqu'une langue est activée, les éléments suivants sont traduits : + +✅ **Interface utilisateur** : Tous les menus, boutons et messages +✅ **E-mails automatiques** : Notifications, factures, confirmations +✅ **Messages système** : Erreurs, confirmations, alertes +✅ **Contenu statique** : Pages légales, conditions générales + +### Éléments à traduire manuellement + +Certains contenus nécessitent une traduction manuelle : + +📝 **Descriptions de produits** : Via l'interface de gestion des produits +📝 **Pages personnalisées** : Contenu créé spécifiquement +📝 **Annonces et actualités** : Communications marketing +📝 **Métadonnées SEO** : Titres et descriptions pour le référencement + +## Personnalisation des traductions + +### Modifier les traductions existantes + +Si vous souhaitez adapter certaines traductions : + +1. Les fichiers de langue sont stockés dans `/resources/lang/` +2. Chaque langue a son propre dossier (ex: `fr/`, `en/`) +3. Modifiez les fichiers PHP avec précaution +4. Testez vos modifications en environnement de développement + +:::warning Attention +Les modifications manuelles seront **écrasées** lors des mises à jour. Documentez vos changements pour pouvoir les réappliquer. +::: + +### Ajouter des traductions personnalisées + +Pour vos contenus spécifiques : + +```php +// Dans vos vues ou contrôleurs +__('custom.my_translation_key') + +// Dans le fichier de langue +'my_translation_key' => 'Ma traduction personnalisée', +``` + +## Bonnes pratiques + +### Pour l'expérience utilisateur + +1. **Sélecteur visible** : Placez le sélecteur de langue dans l'en-tête +2. **Drapeaux clairs** : Utilisez des icônes reconnaissables +3. **Mémorisation** : La préférence doit être sauvegardée +4. **Cohérence** : Traduisez TOUT ou rien + +### Pour le référencement + +1. **URLs localisées** : Utilisez des sous-domaines ou répertoires +2. **Balises hreflang** : Indiquez les alternatives linguistiques +3. **Contenu unique** : Évitez les traductions automatiques de mauvaise qualité +4. **Sitemap multilingue** : Incluez toutes les versions + +### Pour la maintenance + +1. **Documentation** : Notez vos personnalisations +2. **Tests réguliers** : Vérifiez après chaque mise à jour +3. **Feedback utilisateurs** : Collectez les retours sur la qualité +4. **Veille** : Surveillez les nouvelles langues disponibles + +## Cas d'usage avancés + +### Activation conditionnelle + +Vous pouvez activer des langues selon vos besoins : + +- **Phase de test** : Commencez avec 2-3 langues principales +- **Expansion graduelle** : Ajoutez des langues selon la demande +- **Marchés ciblés** : Activez uniquement les langues pertinentes + +### Intégration avec les modules + +Certains modules supportent le multilinguisme : +- Traduction automatique des produits +- Génération de factures multilingues +- Support client dans plusieurs langues + +:::tip À retenir +Le multilinguisme est un **avantage concurrentiel majeur**. Chaque langue ajoutée ouvre votre business à des millions de nouveaux clients potentiels. L'effort d'implementation est minimal comparé au potentiel de croissance. +::: \ No newline at end of file diff --git a/docs/settings/core/mail.md b/docs/settings/core/mail.md index c83e6ac..f3b4366 100644 --- a/docs/settings/core/mail.md +++ b/docs/settings/core/mail.md @@ -1,45 +1,199 @@ --- sidebar_position: 2 --- -# Paramètres de messagerie -Les paramètres de messagerie vous permettent de configurer les paramètres de messagerie de votre **CLIENTXCMS**. Vous pouvez configurer les paramètres de messagerie pour envoyer des e-mails à vos clients. -Ces paramètres sont utilisés pour envoyer des e-mails à vos clients lorsqu'ils s'inscrivent, lorsqu'ils demandent un mot de passe oublié, etc. Pour ce faire, allez dans le menu `Paramètres` puis dans la section `Paramètres généraux` et enfin dans `Paramètres de mail`. -![Paramètres de messagerie](/img/next_gen/settings/core/mail/mail.png) -## Configuration de l'envoi d'e-mails -**Adresse d'envoi** : L'adresse e-mail à partir de laquelle les e-mails seront envoyés. +import ThemedImage from '@theme/ThemedImage'; -**Nom d'envoi** : Le nom à partir duquel les e-mails seront envoyés. +# Messagerie -**Salutation de début** : La salutation de début des e-mails. +Dans **CLIENTXCMS**, la configuration de la **messagerie** est essentielle pour maintenir une **communication fluide avec vos clients**.
+L'objectif est simple : **configurer correctement l'envoi des e-mails pour garantir leur délivrabilité** et offrir une **expérience professionnelle** à vos utilisateurs. Une bonne configuration améliore la fiabilité de vos communications, renforce la confiance et assure que vos messages importants arrivent bien à destination. -**Salutation de fin** : La signature de fin des e-mails. +La messagerie est utilisée pour toutes les communications automatiques : inscriptions, réinitialisations de mot de passe, notifications de commandes, factures, etc. -**Domaine de l'espace client** : Le domaine de l'espace client. +Vous pouvez gérer la messagerie depuis : -**Désactiver les e-mails** : Désactive l'envoi d'e-mails. (utile pour le développement) +`Paramètres` > `Paramètres généraux` > `Paramètres de messagerie` -### SMTP -**Hôte SMTP** : L'hôte SMTP à utiliser pour envoyer des e-mails. + -**Port SMTP** : Le port SMTP à utiliser pour envoyer des e-mails. +:::tip Astuce +Une configuration SMTP correcte est **cruciale** pour éviter que vos e-mails finissent dans les spams. +Prenez le temps de bien paramétrer ces options et de tester régulièrement votre configuration. +::: + +## Pourquoi configurer la messagerie ? + +La messagerie automatique est au cœur de l'expérience client dans CLIENTXCMS. Elle permet de : + +* Confirmer les inscriptions et les commandes de vos clients +* Envoyer les factures et les rappels de paiement +* Notifier les clients des changements sur leurs services +* Gérer les réinitialisations de mot de passe en toute sécurité + +:::tip Astuce +C'est un peu comme avoir un assistant personnel qui envoie automatiquement tous vos courriers importants 📬 — fiable, rapide et professionnel. +::: + +## Configuration de base + +### Paramètres d'identité + +Ces paramètres définissent comment vos e-mails apparaîtront dans la boîte de réception de vos clients : + +**Adresse d'envoi** | (adresse e-mail)
+L'adresse e-mail qui apparaîtra comme expéditeur de tous vos messages automatiques. +Utilisez une adresse professionnelle du type `noreply@votredomaine.com` ou `support@votredomaine.com`. + +**Nom d'envoi** | (texte)
+Le nom qui s'affichera à côté de l'adresse d'envoi dans les clients mail. +Généralement le nom de votre entreprise ou de votre service. + +**Domaine de l'espace client** | (URL)
+L'URL complète de votre installation CLIENTXCMS (ex: `https://demo.clientxcms.com`). +Utilisé pour générer les liens dans les e-mails. + +### Personnalisation des messages + +**Salutation de début** | (texte)
+Le message d'accueil qui apparaîtra au début de chaque e-mail. +Par exemple : "Bonjour" ou "Cher client". + +**Salutation de fin** | (texte)
+La signature qui apparaîtra à la fin de chaque e-mail. +Par exemple : "Cordialement, L'équipe ClientXCMS" ou "Merci de votre confiance". + +### Options avancées + +**Désactiver les e-mails** | (case à cocher)
+Empêche l'envoi de tous les e-mails depuis le système. +⚠️ À utiliser uniquement en développement ou en maintenance. + +## Configuration SMTP + +SMTP (Simple Mail Transfer Protocol) est le protocole standard pour l'envoi d'e-mails. Une configuration SMTP correcte garantit la délivrabilité de vos messages. + +### Paramètres de connexion + +**Hôte SMTP** | (adresse serveur)
+L'adresse du serveur SMTP de votre fournisseur de messagerie. +Exemples courants : +- Gmail : `smtp.gmail.com` +- Office 365 : `smtp.office365.com` +- OVH : `ssl0.ovh.net` + +**Port SMTP** | (numéro)
+Le port utilisé pour la connexion SMTP. Les ports standards sont : +- `587` : Pour TLS/STARTTLS (recommandé) +- `465` : Pour SSL +- `25` : Port standard (souvent bloqué par les FAI) -**Nom d'utilisateur SMTP** : Le nom d'utilisateur SMTP à utiliser pour envoyer des e-mails. +**Chiffrement SMTP** | (menu déroulant)
+Le type de sécurisation de la connexion : +- **TLS** : Recommandé, utilise le port 587 +- **SSL** : Alternative sécurisée, utilise le port 465 +- **Aucun** : Non recommandé sauf en environnement local -**Mot de passe SMTP** : Le mot de passe SMTP à utiliser pour envoyer des e-mails. +### Authentification -**Chiffrement SMTP** : Le chiffrement SMTP à utiliser pour envoyer des e-mails. +**Nom d'utilisateur SMTP** | (texte)
+Généralement votre adresse e-mail complète ou un identifiant fourni par votre hébergeur. -### Test de connexion -Vous pouvez tester la connexion SMTP en cliquant sur le bouton "Tester la connexion SMTP". -Vous devriez voir un message de succès si la connexion a réussi. -Si la connexion a échoué, vérifiez les paramètres SMTP que vous avez entrés. -![Test de connexion SMTP](/img/next_gen/settings/core/mail/mail_success.png) +**Mot de passe SMTP** | (mot de passe)
+Le mot de passe associé à votre compte SMTP. +Pour certains services (Gmail, Office 365), vous devrez utiliser un mot de passe d'application spécifique. -:::info -Vérifiez l'addresse e-mail de l'expéditeur pour éviter que les e-mails soient marqués comme spam. +:::warning Important +Pour des raisons de sécurité, utilisez toujours un **mot de passe d'application** dédié plutôt que le mot de passe principal de votre compte e-mail. ::: -#### Erreurs courantes +## Test et validation + +### Tester la configuration + +Après avoir configuré vos paramètres SMTP, il est **essentiel** de tester la connexion : + +1. Cliquez sur le bouton **"Tester la connexion SMTP"** +2. Un e-mail de test sera envoyé à l'adresse configurée +3. Vérifiez la réception et l'apparence du message + + + +### Indicateurs de succès + +✅ **Connexion réussie** : Message de confirmation affiché +✅ **E-mail reçu** : Vérifiez votre boîte de réception +✅ **Bon formatage** : L'e-mail s'affiche correctement + +## Résolution des problèmes + +### Erreurs fréquentes + +**"scheme is not supported"**
+Le protocole de chiffrement sélectionné n'est pas compatible avec votre serveur. +→ **Solution** : Essayez de basculer entre TLS et SSL. + +**"Authentication failed"**
+Les identifiants fournis sont incorrects. +→ **Solution** : Vérifiez votre nom d'utilisateur et mot de passe. Pour Gmail/Office 365, utilisez un mot de passe d'application. + +**"Connection timeout"**
+Le serveur SMTP ne répond pas. +→ **Solution** : Vérifiez l'hôte et le port. Assurez-vous que votre firewall autorise les connexions sortantes. + +### Bonnes pratiques + +Pour optimiser la délivrabilité de vos e-mails : + +1. **Utilisez un domaine vérifié** : L'adresse d'envoi doit correspondre à votre domaine +2. **Configurez SPF/DKIM/DMARC** : Ces protocoles authentifient vos e-mails +3. **Évitez les mots spam** : Dans vos salutations et contenus +4. **Testez régulièrement** : La configuration peut changer avec le temps + +## Exemples de configuration + +### Configuration avec Gmail + +``` +Hôte SMTP : smtp.gmail.com +Port : 587 +Chiffrement : TLS +Nom d'utilisateur : votre-email@gmail.com +Mot de passe : [Mot de passe d'application] +``` + +### Configuration avec Office 365 + +``` +Hôte SMTP : smtp.office365.com +Port : 587 +Chiffrement : TLS +Nom d'utilisateur : votre-email@votredomaine.com +Mot de passe : [Mot de passe du compte] +``` + +### Configuration avec OVH + +``` +Hôte SMTP : ssl0.ovh.net +Port : 465 +Chiffrement : SSL +Nom d'utilisateur : votre-email@votredomaine.com +Mot de passe : [Mot de passe e-mail] +``` -**scheme is not supported; supported schemes for mailer "smtp" are: "smtp", "smtps"** : Cela signifie que le protocole de chiffrement SMTP que vous avez sélectionné n'est pas pris en charge. Essayez de remplacer TLS par SSL ou vice versa. \ No newline at end of file +:::tip À retenir +Une messagerie bien configurée est la base d'une relation client professionnelle. Prenez le temps de tester et d'optimiser vos paramètres pour garantir que chaque message arrive à destination. +::: \ No newline at end of file diff --git a/docs/settings/core/maintenance.md b/docs/settings/core/maintenance.md index d85b76c..64a2438 100644 --- a/docs/settings/core/maintenance.md +++ b/docs/settings/core/maintenance.md @@ -1,28 +1,183 @@ --- sidebar_position: 4 --- + +import ThemedImage from '@theme/ThemedImage'; + # Maintenance -Le système de maintenance vous permet de mettre votre **ClientXCMS** en mode maintenance. Cela signifie que votre **CLIENTXCMS** sera inaccessible pour les utilisateurs pendant la période de maintenance. -Il permet d'informer les utilisateurs de la raison de la maintenance et de la durée estimée de la maintenance. Pour ce faire, allez dans le menu `Paramètres` puis dans la section `Paramètres généraux` et enfin dans `Maintenance`. -![Maintenance](/img/next_gen/settings/core/maintenance/maintenance.png) -**Activer la maintenance** : Activez ou désactivez la maintenance. -**Message de maintenance** : Le message de maintenance qui sera affiché aux utilisateurs. +Dans **CLIENTXCMS**, le mode **maintenance** est un outil essentiel pour **gérer les périodes d'indisponibilité de votre plateforme**.
+L'objectif est clair : **informer vos clients de manière professionnelle** lors de travaux techniques tout en **gardant le contrôle de votre système**. Une bonne gestion de la maintenance permet de maintenir la confiance de vos clients, même pendant les interruptions de service, et de garantir une communication transparente. + +Le mode maintenance est particulièrement utile lors de mises à jour importantes, de migrations de données ou de résolutions de problèmes techniques. + +Vous pouvez gérer la maintenance depuis : + +`Paramètres` > `Paramètres généraux` > `Maintenance` + + -**URL de maintenance** : L'URL pour passer outre la maintenance. +:::tip Astuce +Le mode maintenance est votre **bouclier de protection** pendant les opérations sensibles. +Il permet de travailler sereinement tout en gardant vos clients informés de la situation. +::: + +## Pourquoi utiliser le mode maintenance ? + +Le mode maintenance est indispensable pour : + +* **Protéger vos données** pendant les mises à jour critiques +* **Éviter les erreurs** causées par des accès pendant des modifications +* **Communiquer professionnellement** sur les interruptions de service +* **Maintenir la confiance** en montrant que les maintenances sont planifiées + +:::tip Astuce +C'est comme mettre un panneau "Fermé pour travaux" sur votre boutique 🚧 — vos clients comprennent et apprécient la transparence. +::: -**Texte du bouton de maintenance** : Le texte du bouton pour passer outre la maintenance. +## Configuration du mode maintenance -**URL de l'image de maintenance** : L'URL de l'image de maintenance. +### Activation et désactivation -**Icone de maintenance** : L'icone de maintenance. +**Activer la maintenance** | (interrupteur)
+Active ou désactive instantanément le mode maintenance sur votre plateforme. +Lorsqu'activé, seuls les administrateurs peuvent accéder au système. -:::info Information -Si vous avez activé la maintenance, vous pouvez accéder à votre espace d'administration. Les utilisateurs ne pourront plus se connecter. +:::warning Important +Une fois la maintenance activée, tous les utilisateurs non-administrateurs seront automatiquement déconnectés et redirigés vers la page de maintenance. ::: -## Personnalisation de la page de maintenance -Vous pouvez personnaliser la page de maintenance en modifiant le fichier `maintenance.blade.php` dans le dossier `resources/themes/default/views/maintenance.blade.php` de votre installation. +### Message d'information + +**Message de maintenance** | (zone de texte)
+Le message principal affiché sur la page de maintenance. +Expliquez brièvement la raison de l'interruption et la durée estimée. + +Exemple de message efficace : +``` +Nous effectuons actuellement une mise à jour importante de nos systèmes. +Notre plateforme sera de nouveau disponible dans environ 2 heures. +Merci de votre compréhension. +``` + +### Personnalisation visuelle + +**URL de l'image de maintenance** | (URL)
+Ajoutez une image personnalisée pour illustrer la page de maintenance. +Peut être votre logo ou une illustration thématique. + +**Icône de maintenance** | (texte)
+Définit l'icône affichée sur la page (utilise les classes d'icônes CSS). +Par exemple : `fas fa-tools` pour une icône d'outils. + +### Options de contournement + +**URL de maintenance** | (URL)
+Lien externe vers lequel rediriger les utilisateurs pendant la maintenance. +Utile pour diriger vers une page de statut ou un site temporaire. + +**Texte du bouton de maintenance** | (texte)
+Le texte affiché sur le bouton de redirection. +Par exemple : "Voir le statut" ou "Plus d'informations". + +## Comportement du système en maintenance + +### Pour les administrateurs + +✅ **Accès complet maintenu** : Les administrateurs peuvent toujours se connecter +✅ **Travail sans interruption** : Toutes les fonctionnalités restent accessibles +✅ **Indicateur visuel** : Un badge ou notification rappelle que la maintenance est active + +### Pour les utilisateurs + +🚫 **Accès bloqué** : Impossible de se connecter à l'espace client +🚫 **Sessions terminées** : Les utilisateurs connectés sont déconnectés +✅ **Page informative** : Affichage de la page de maintenance personnalisée + +## Personnalisation avancée + +### Modifier le template de maintenance + +Pour une personnalisation complète, vous pouvez modifier le fichier template : + +``` +resources/themes/default/views/maintenance.blade.php +``` + +Cela permet de : +- Adapter complètement le design à votre charte graphique +- Ajouter des éléments dynamiques (compte à rebours, etc.) +- Intégrer des informations supplémentaires + +### Bonnes pratiques de personnalisation + +1. **Conservez la simplicité** : La page doit charger rapidement +2. **Restez informatif** : Message clair sur la durée et la raison +3. **Gardez votre identité** : Utilisez vos couleurs et votre logo +4. **Pensez mobile** : La page doit être responsive + +## Exemples d'utilisation + +### Maintenance planifiée + +Pour une mise à jour prévue : +1. Activez la maintenance **avant** de commencer les travaux +2. Définissez un message précis avec l'heure de retour estimée +3. Effectuez vos modifications +4. Désactivez la maintenance une fois terminé + +### Maintenance d'urgence + +En cas de problème critique : +1. Activez immédiatement la maintenance +2. Utilisez un message générique si nécessaire +3. Mettez à jour le message avec plus de détails dès que possible +4. Communiquez sur d'autres canaux (réseaux sociaux, email) ## Aperçu de la page de maintenance -![Maintenance](/img/next_gen/settings/core/maintenance/maintenance_home.png) \ No newline at end of file + +Voici à quoi ressemble la page de maintenance vue par vos utilisateurs : + + + +La page affiche : +- Votre message personnalisé +- L'image ou icône configurée +- Le bouton de redirection (si configuré) +- Un design épuré et professionnel + +## Conseils et recommandations + +### Communication proactive + +- **Prévenez à l'avance** : Informez vos clients des maintenances planifiées +- **Soyez précis** : Donnez des horaires clairs et respectez-les +- **Restez joignable** : Indiquez un moyen de contact pour les urgences + +### Optimisation du temps + +- **Heures creuses** : Planifiez les maintenances aux heures de faible activité +- **Durée minimale** : Préparez tout en amont pour réduire le temps d'arrêt +- **Tests préalables** : Testez les modifications dans un environnement de test + +### Suivi post-maintenance + +- **Vérifiez tout** : Assurez-vous que tout fonctionne après la maintenance +- **Communiquez la fin** : Informez vos clients que le service est rétabli +- **Surveillez** : Restez vigilant aux éventuels problèmes post-maintenance + +:::tip À retenir +Le mode maintenance est un outil puissant qui, bien utilisé, renforce la confiance de vos clients. Une maintenance bien gérée et communiquée est perçue comme un signe de professionnalisme et de fiabilité. +::: \ No newline at end of file diff --git a/docs/settings/helpdesk/departments.md b/docs/settings/helpdesk/departments.md index 02255b2..7c5f0fc 100644 --- a/docs/settings/helpdesk/departments.md +++ b/docs/settings/helpdesk/departments.md @@ -1,45 +1,284 @@ +--- +sidebar_position: 2 +--- + # Départements -Les départements sont des catégories qui permettent de classer les tickets. Vous pouvez créer des départements pour organiser les tickets de votre centre d'aide. -![img](/img/next_gen/settings/helpdesk/departments/index_admin.png) + +Dans **CLIENTXCMS**, les **départements** constituent l'épine dorsale de l'organisation de votre centre d'aide.
+L'objectif est organisationnel : **structurer le support par spécialités**, **orienter efficacement les demandes** et **optimiser l'expertise de chaque équipe**. Une organisation départementale bien pensée accélère les résolutions, améliore la qualité des réponses et permet une montée en compétences ciblée. + +Les départements permettent de catégoriser automatiquement les tickets selon leur nature et de les diriger vers les bonnes équipes. + +Vous pouvez gérer les départements depuis : + +`Paramètres` > `Centre d'aide` > `Départements` + +![Interface de gestion des départements](/img/next_gen/settings/helpdesk/departments/index_admin.png) + +:::tip Astuce +Des départements bien organisés transforment le chaos des demandes en **flux de travail structuré**. +Chaque client est dirigé vers l'expert le plus qualifié pour son problème. +::: + +## Pourquoi organiser en départements ? + +La structuration départementale est essentielle pour : + +* **Spécialiser les équipes** selon leurs compétences +* **Accélérer les résolutions** grâce à l'expertise ciblée +* **Améliorer la satisfaction** avec des réponses plus précises +* **Optimiser la charge** de travail entre les équipes +* **Faciliter le suivi** des métriques par domaine + +:::tip Astuce +C'est comme organiser un hôpital en services spécialisés 🏥 — cardiologie, pédiatrie, urgences... chaque patient va au bon endroit du premier coup. +::: ## Départements par défaut -CLIENTXCMS crée automatiquement des départements par défaut pour vous aider à démarrer. Vous pouvez les modifier ou les supprimer selon vos besoins. -Liste des départements par défaut : -- Général -- Facturation -- Technique -- Commercial -## Créer un département -Pour créer un département, cliquez sur le bouton `Créer` en haut à droite de la page. Vous serez redirigé vers la page de création de département. -![img](/img/next_gen/settings/helpdesk/departments/create.png) +### Configuration initiale + +CLIENTXCMS propose une structure départementale standard pour démarrer rapidement : + +| Département | Utilisation | Expertise requise | +|-------------|-------------|-------------------| +| 🔧 **Technique** | Problèmes serveurs, bugs, configurations | Informatique, développement | +| 💰 **Facturation** | Factures, paiements, remboursements | Comptabilité, commercial | +| 🏢 **Commercial** | Ventes, devis, négociations | Business, relation client | +| 📋 **Général** | Demandes diverses, informations | Support généraliste | + +### Adaptation à votre activité + +Ces départements par défaut peuvent être : +- **Modifiés** : Changement de nom, icône, description +- **Supprimés** : Si non pertinents pour votre activité +- **Complétés** : Ajout de départements spécifiques + +**Exemples d'adaptations** : + +#### Hébergeur web +- 🔧 **Technique** : Serveurs, DNS, SSL +- 💰 **Facturation** : Paiements, renouvellements +- 🚀 **Migration** : Transferts de sites +- 📈 **Commercial** : Nouvelles offres + +#### Agence de développement +- 💻 **Développement** : Bugs, nouvelles fonctionnalités +- 🎨 **Design** : Interface, UX/UI +- 📋 **Projet** : Planning, spécifications +- 💰 **Facturation** : Devis, paiements + +## Création d'un département + +### Processus de création + +Pour ajouter un nouveau département : -**Nom** : Nom du département +1. Cliquez sur **"Créer"** en haut à droite +2. Remplissez les informations du département +3. Configurez l'apparence visuelle +4. Sauvegardez la configuration -**Icône** : Icône du département +![Formulaire de création d'un département](/img/next_gen/settings/helpdesk/departments/create.png) -**Description** : Description du département +### Configuration du département +**Nom** | (texte)
+Le nom affiché dans l'interface client et administrateur. +Utilisez un terme clair et immédiatement compréhensible. -### Rendu sur la création de ticket +**Exemples de noms efficaces** : +- ✅ "Support Technique" plutôt que "Tech" +- ✅ "Facturation & Paiements" plutôt que "Compta" +- ✅ "Assistance Commerciale" plutôt que "Ventes" -![img](/img/next_gen/settings/helpdesk/departments/departments.png) +**Icône** | (sélecteur d'icône)
+Représentation visuelle du département pour une identification rapide. -Vous pouvez préselectionner certains valeurs lors de la création de ticket avec des paramètres dans l'URL : +**Icônes recommandées** : +- 🔧 Technique : `fas fa-cogs`, `fas fa-wrench` +- 💰 Facturation : `fas fa-dollar-sign`, `fas fa-credit-card` +- 🏢 Commercial : `fas fa-handshake`, `fas fa-chart-line` +- 📋 Général : `fas fa-question-circle`, `fas fa-info-circle` -- `department` : Département préselectionné -- `priority` : Priorité préselectionnée -- `content` : Contenu prérempli -- `subject` : Sujet prérempli -- `related_id` : ID du service lié +**Description** | (texte long)
+Explication détaillée du type de demandes traitées par ce département. +Aide les clients à choisir le bon département. -Par exemple : +**Exemple de description pour "Support Technique"** : ``` -https://clientxcms.app/client/support/create?department=1&priority=low&content=Bonjour&subject=Problème&related_id=1 +Problèmes techniques, pannes serveur, configurations, erreurs de site, +questions DNS, certificats SSL, performances et optimisations. ``` -## Modifier un département -Pour modifier un département, cliquez sur le bouton `Afficher` sur la liste des départements. Vous serez redirigé vers la page de modification de département. -Vous pouvez modifier le nom, l'icône et la description du département ou traduire le nom et la description du département avec l'icone à droite du champ. -![img](/img/next_gen/settings/helpdesk/departments/edit.png) -## Supprimer un département -Pour supprimer un département, cliquez sur le bouton `Supprimer` sur la liste des départements. Notez que vous ne pouvez pas supprimer un département si des tickets sont associés à ce département. \ No newline at end of file + +## Interface client + +### Sélection de département + +Lors de la création d'un ticket, les clients voient tous les départements disponibles : + +![Sélection de département côté client](/img/next_gen/settings/helpdesk/departments/departments.png) + +L'affichage comprend : +- **Icône** du département +- **Nom** descriptif +- **Description** d'aide au choix + +### Pré-sélection automatique + +Vous pouvez diriger automatiquement les clients vers un département via des paramètres URL : + +#### Paramètres disponibles + +| Paramètre | Description | Exemple de valeur | +|-----------|-------------|-------------------| +| `department` | ID du département | `1` (Technique) | +| `priority` | Priorité du ticket | `low`, `medium`, `high` | +| `subject` | Sujet pré-rempli | `Problème de connexion` | +| `content` | Message pré-rempli | `Bonjour, j'ai un problème avec...` | +| `related_id` | Service concerné | `123` (ID du service) | + +#### Exemples d'URLs pré-configurées + +**Support technique avec contexte** : +``` +https://demo.clientxcms.com/client/support/create?department=1&priority=high&subject=Serveur+inaccessible +``` + +**Facturation avec service lié** : +``` +https://demo.clientxcms.com/client/support/create?department=2&related_id=456&subject=Question+facture +``` + +**Demande commerciale** : +``` +https://demo.clientxcms.com/client/support/create?department=4&content=Je+souhaiterais+un+devis+pour... +``` + +### Utilisation des URLs pré-configurées + +**Dans vos e-mails** : Liens directs selon le contexte +**Sur votre site** : Boutons d'aide contextuelle +**En signature** : Accès rapide au support +**Dans vos FAQ** : Création de ticket ciblée + +## Gestion des départements + +### Modification d'un département + +Pour éditer un département existant : + +1. Cliquez sur **"Afficher"** dans la liste +2. Modifiez les informations nécessaires +3. Adaptez les traductions si besoin +4. Sauvegardez les modifications + +![Interface de modification d'un département](/img/next_gen/settings/helpdesk/departments/edit.png) + +### Traductions multilingues + +Chaque département peut être traduit dans toutes les langues activées : +- **Nom** spécifique par langue +- **Description** adaptée culturellement +- **Cohérence** avec la terminologie locale + +**Accès aux traductions** : Icône à droite de chaque champ + +### Suppression de départements + +**Conditions de suppression** : +- Aucun ticket ouvert ou fermé associé +- Aucune règle d'automatisation référençant ce département +- Confirmation explicite de l'action + +**Alternative à la suppression** : +Plutôt que supprimer, considérez : +- **Désactivation temporaire** : Masquer sans supprimer +- **Fusion** : Rediriger vers un autre département +- **Archivage** : Conserver pour l'historique + +:::warning Attention +La suppression d'un département est **irréversible**. Tous les liens et références seront brisés. Privilégiez la désactivation temporaire. +::: + +## Stratégies d'organisation + +### Selon la taille d'équipe + +#### Petite équipe (1-3 personnes) +``` +- Général (tout type de demande) +- Technique (problèmes spécialisés) +``` + +#### Équipe moyenne (4-10 personnes) +``` +- Technique (serveurs, bugs) +- Commercial (ventes, devis) +- Facturation (paiements, comptes) +- Général (divers) +``` + +#### Grande organisation (10+ personnes) +``` +- Support N1 (premiers contacts) +- Support N2 (problèmes complexes) +- Facturation (comptabilité) +- Commercial (ventes) +- Projets (développements spécifiques) +- Urgences (disponibilité 24/7) +``` + +### Selon le type d'activité + +#### Hébergeur +``` +- Infrastructure (serveurs, réseau) +- Applications (sites, e-mails) +- Sécurité (SSL, sauvegardes) +- Commercial (nouvelles offres) +``` + +#### SaaS/Logiciel +``` +- Bugs (dysfonctionnements) +- Fonctionnalités (demandes d'évolution) +- Intégrations (API, webhooks) +- Formation (aide à l'utilisation) +``` + +### Optimisation continue + +#### Métriques à surveiller +- **Volume** par département +- **Temps de résolution** moyen +- **Taux de satisfaction** par équipe +- **Transferts** entre départements + +#### Ajustements réguliers +- **Répartition** selon les compétences +- **Fusion** des départements peu actifs +- **Division** des départements surchargés +- **Formation** croisée des équipes + +## Automatisation avancée + +### Routage intelligent + +Configurez des règles pour diriger automatiquement les tickets : +- **Mots-clés** dans le sujet → Département technique +- **Services spécifiques** → Équipe dédiée +- **Heures ouvrables** → Support standard vs urgences +- **Langue client** → Équipe multilingue + +### Escalade automatique + +Définissez des processus d'escalade : +- **Délai dépassé** → Niveau supérieur +- **Mot-clé urgent** → Équipe prioritaire +- **Client VIP** → Support premium +- **Complexité élevée** → Experts spécialisés + +:::tip À retenir +L'organisation en départements doit évoluer avec votre activité. Commencez simple, observez les flux de tickets, et adaptez progressivement. Une bonne organisation départementale peut diviser par deux votre temps de résolution moyen. +::: \ No newline at end of file diff --git a/docs/settings/helpdesk/helpdesk-settings.md b/docs/settings/helpdesk/helpdesk-settings.md index c366036..1e8eb72 100644 --- a/docs/settings/helpdesk/helpdesk-settings.md +++ b/docs/settings/helpdesk/helpdesk-settings.md @@ -1,18 +1,242 @@ +--- +sidebar_position: 1 +--- + # Paramètres du centre d'aide -Les paramètres du centre d'aide vous permettent de personnaliser le centre d'aide à votre image. Vous pouvez modifier les paramètres du centre d'aide depuis les `Paramètres` > `Centre d'aide` > `Paramètres du centre d'aide`. -**Fermeture automatique des tickets après inactivité** : Nombre de jours avant la fermeture automatique des tickets après inactivité. Par défaut, il est de 7 jours. Vous pouvez désactiver cette fonctionnalité en mettant la valeur à 0. +Dans **CLIENTXCMS**, les **paramètres du centre d'aide** définissent le comportement et les règles de fonctionnement de votre système de support.
+L'objectif est stratégique : **optimiser l'efficacité du support**, **automatiser les processus répétitifs** et **garantir une expérience cohérente** pour vos clients et votre équipe. Une configuration appropriée améliore la productivité, réduit la charge de travail manuelle et maintient un niveau de service élevé. + +Ces paramètres contrôlent les automatisations, les notifications, les pièces jointes et les intégrations externes. + +Vous pouvez modifier les paramètres depuis : + +`Paramètres` > `Centre d'aide` > `Paramètres du centre d'aide` + +:::tip Astuce +Des paramètres bien configurés transforment votre centre d'aide en **machine bien huilée**. +Chaque automatisation vous fait gagner du temps pour vous concentrer sur les cas complexes. +::: + +## Pourquoi configurer ces paramètres ? + +La configuration du centre d'aide est essentielle pour : + +* **Automatiser la gestion** des tickets inactifs +* **Contrôler les interactions** avec les clients +* **Sécuriser les échanges** de fichiers +* **Intégrer avec vos outils** externes +* **Maintenir la qualité** du service + +:::tip Astuce +C'est comme régler les paramètres d'une machine industrielle ⚙️ — plus c'est précis, plus c'est efficace et fiable. +::: + +## Gestion automatique des tickets + +### Fermeture automatique + +**Fermeture automatique après inactivité** | (nombre de jours)
+Définit après combien de jours un ticket sans activité sera automatiquement fermé. + +**Valeurs recommandées** : +- **7 jours** : Standard pour la plupart des cas +- **3 jours** : Support haute réactivité +- **14 jours** : Projets complexes nécessitant plus de temps +- **0** : Désactive la fermeture automatique + +:::tip Avantages de la fermeture automatique +- **Nettoie automatiquement** les tickets abandonnés +- **Maintient des statistiques** précises +- **Libère la charge** de travail des équipes +- **Encourage la réactivité** des clients +::: + +### Ré-ouverture contrôlée + +**Autorisation de ré-ouverture** | (nombre de jours)
+Permet aux clients de rouvrir leurs tickets fermés pendant une période limitée. + +**Options disponibles** : +- **7 jours** : Délai standard recommandé +- **0** : Désactive la ré-ouverture +- **-1** : Ré-ouverture illimitée dans le temps + +**Cas d'usage** : +- **7 jours** : Pour les problèmes techniques standards +- **14 jours** : Pour les migrations ou projets complexes +- **0** : Pour forcer de nouveaux tickets et éviter la confusion +- **-1** : Pour un support premium avec suivi long terme + +:::warning Attention +Une ré-ouverture illimitée peut créer des tickets très anciens difficiles à gérer. Privilégiez un délai raisonnable. +::: + +## Gestion des pièces jointes + +### Activation des fichiers + +**Autoriser les pièces jointes** | (interrupteur)
+Active ou désactive la possibilité pour les clients de joindre des fichiers à leurs tickets. + +**Avantages des pièces jointes** : +- **Captures d'écran** pour les problèmes visuels +- **Logs d'erreur** pour le diagnostic technique +- **Documents** pour les demandes administratives +- **Preuves** pour les réclamations + +### Sécurité et limitations + +**Taille maximale** | (Mo)
+Limite la taille des fichiers que les clients peuvent joindre. + +**Recommandations par type d'usage** : + +| Type de support | Taille recommandée | Justification | +|-----------------|-------------------|---------------| +| **Support général** | 5 Mo | Screenshots et documents légers | +| **Support technique** | 10 Mo | Logs et fichiers de configuration | +| **Support développeur** | 25 Mo | Archives de code et dumps | +| **Serveur limité** | 2 Mo | Économie d'espace disque | + +### Types de fichiers autorisés + +**Extensions acceptées** | (liste séparée par virgules)
+Définit quels types de fichiers sont acceptés dans les tickets. + +**Configuration par défaut** : `jpg,jpeg,png,doc,docx,xls,xlsx` + +**Configurations recommandées** : + +#### Support standard +``` +jpg,jpeg,png,gif,pdf,doc,docx,txt,log +``` + +#### Support technique avancé +``` +jpg,jpeg,png,gif,pdf,doc,docx,txt,log,zip,rar,sql,json,xml +``` + +#### Support sécurisé (restrictif) +``` +jpg,jpeg,png,pdf,txt +``` + +:::warning Sécurité des fichiers +**Types à éviter absolument** : +- `.exe, .bat, .cmd` : Fichiers exécutables +- `.php, .js, .html` : Scripts potentiellement malveillants +- `.scr, .pif` : Extensions souvent utilisées par les malwares + +**Bonnes pratiques** : +- Limitez aux types strictement nécessaires +- Scannez les fichiers avec un antivirus +- Vérifiez régulièrement les uploads suspects +::: + +## Intégrations et notifications + +### Webhooks de notification + +**URL du webhook** | (URL HTTPS)
+Configurez une URL pour recevoir des notifications en temps réel sur les événements du centre d'aide. + +![Exemple de notification webhook](https://cdn.clientxcms.com/ressources/docs/ticket.png) + +#### Types d'événements notifiés +- **Nouveau ticket** créé +- **Réponse client** ajoutée +- **Ticket fermé** ou résolu +- **Escalade** vers un département +- **Pièce jointe** uploadée + +#### Configuration webhook Discord + +Exemple d'intégration avec Discord : + +1. **Créer un webhook** dans votre serveur Discord +2. **Copier l'URL** générée +3. **Coller dans le champ** URL du webhook +4. **Tester** avec un ticket de démonstration + +#### Format des notifications + +Les notifications incluent : +```json +{ + "ticket_id": 123, + "subject": "Problème de connexion", + "department": "Technique", + "priority": "high", + "client": "john@example.com", + "status": "open" +} +``` + +### Intégrations populaires + +**Discord** : Notifications dans canal dédié +**Slack** : Messages dans workspace équipe +**Microsoft Teams** : Alertes dans channel support +**Zapier** : Automatisation avec 1000+ services +**API personnalisée** : Intégration avec vos outils internes + +## Exemples de configuration + +### Startup agile +``` +Fermeture automatique : 3 jours +Ré-ouverture : 7 jours +Pièces jointes : Activées (5 Mo) +Types autorisés : jpg,png,pdf,txt +Webhook : Discord équipe +``` + +### Entreprise établie +``` +Fermeture automatique : 7 jours +Ré-ouverture : 14 jours +Pièces jointes : Activées (10 Mo) +Types autorisés : jpg,png,pdf,doc,docx,txt,log +Webhook : Système CRM +``` + +### Support technique spécialisé +``` +Fermeture automatique : 14 jours +Ré-ouverture : -1 (illimitée) +Pièces jointes : Activées (25 Mo) +Types autorisés : jpg,png,pdf,txt,log,zip,sql,json +Webhook : Slack + monitoring +``` + +### Organisation sécurisée +``` +Fermeture automatique : 5 jours +Ré-ouverture : 0 (désactivée) +Pièces jointes : Activées (2 Mo) +Types autorisés : jpg,png,pdf,txt +Webhook : Système audit interne +``` -**URL du webhook** : URL du webhook pour les notifications. Vous pouvez utiliser cette URL pour envoyer des notifications à votre système externe. +## Optimisation des performances -![image](https://cdn.clientxcms.com/ressources/docs/ticket.png) +### Surveillance des métriques -**Autorisation de re-ouverture des tickets** : Vous pouvez autoriser la ré-ouverture des tickets par les clients. Par défaut, cette fonctionnalité est définit à 7 jours. Vous pouvez désactiver cette fonctionnalité en mettant la valeur à 0 ou -1 pour une ré-ouverture illimitée. +Analysez régulièrement : +- **Taux de ré-ouverture** : Indicateur de qualité des résolutions +- **Temps de fermeture** : Efficacité des automatisations +- **Volume de pièces jointes** : Impact sur l'espace disque +- **Types de fichiers** : Adaptation aux besoins réels -**Autoriser les pièces jointes** : Vous pouvez autoriser les pièces jointes dans les tickets. Par défaut, cette fonctionnalité est désactivée. +### Maintenance préventive -**Taille maximale des pièces jointes** : Taille maximale des pièces jointes en Mo. Par défaut, elle est de 5 Mo. +1. **Nettoyage périodique** : Supprimez les vieux fichiers +2. **Révision des paramètres** : Ajustez selon l'évolution +3. **Tests webhook** : Vérifiez la connectivité régulièrement +4. **Formation équipe** : Assurez-vous que tous maîtrisent les paramètres -**Types de fichiers autorisés** : Types de fichiers autorisés pour les pièces jointes. Par défaut, les types de fichiers autorisés sont `jpg,jpeg,png,doc,docx, xls, xlsx`. Vous pouvez ajouter des types de fichiers en les séparant par une virgule. -:::info -Vous devez faire attention à la taille des pièces jointes pour ne pas surcharger votre serveur. Et faites attention aux types de fichiers autorisés pour éviter les attaques de sécurité. Nous vous recommandons de ne pas rajouter de types de fichiers sensibles. \ No newline at end of file +:::tip À retenir +Les paramètres du centre d'aide doivent évoluer avec votre activité. Ce qui fonctionne pour une petite équipe peut ne pas convenir à une organisation plus importante. Révisez et ajustez régulièrement selon vos métriques et retours d'expérience. +::: \ No newline at end of file diff --git a/docs/settings/helpdesk/helpdesk.md b/docs/settings/helpdesk/helpdesk.md index c36f5de..591941d 100644 --- a/docs/settings/helpdesk/helpdesk.md +++ b/docs/settings/helpdesk/helpdesk.md @@ -1,4 +1,153 @@ import DocCardList from '@theme/DocCardList'; # Centre d'aide + +Dans **CLIENTXCMS**, le **centre d'aide** est votre solution complète pour **gérer le support client** et **maintenir la satisfaction de vos utilisateurs**.
+L'objectif est fondamental : **centraliser toutes les demandes d'assistance**, **organiser le support de manière efficace** et **garantir un suivi optimal de chaque interaction**. Un centre d'aide bien configuré améliore l'expérience client, optimise le temps de résolution et renforce la relation de confiance avec vos utilisateurs. + +Cette section couvre tous les aspects du support : configuration générale, organisation des départements, et gestion des paramètres avancés. + +Vous pouvez accéder aux paramètres du centre d'aide depuis : + +`Paramètres` > `Centre d'aide` + +:::tip Astuce +Un support client efficace est la **clé de la fidélisation**. +Chaque ticket résolu rapidement et professionnellement renforce la confiance de vos clients. +::: + +## Pourquoi optimiser votre centre d'aide ? + +Un système de support structuré vous permet de : + +* **Centraliser toutes les demandes** en un seul endroit +* **Organiser le travail d'équipe** avec des départements spécialisés +* **Suivre les métriques** de performance et satisfaction +* **Automatiser les processus** pour plus d'efficacité +* **Maintenir un historique complet** des interactions client + +:::tip Astuce +C'est comme avoir un centre d'appel virtuel 📞 — organisé, traçable et disponible 24h/24 pour vos clients. +::: + +## Composants du centre d'aide + +Le système de support de CLIENTXCMS s'articule autour de plusieurs éléments clés : + +### 🎫 Système de tickets +Gestion complète des demandes client avec suivi, priorités et historique. + +### ⚙️ Paramètres généraux +Configuration des règles de fonctionnement, notifications et automatisations. + +### 🏢 Départements +Organisation thématique du support pour une meilleure spécialisation. + +## Fonctionnalités principales + +### Gestion des tickets +- **Création intuitive** : Interface simple pour les clients +- **Suivi en temps réel** : Statuts et notifications automatiques +- **Priorités** : Classification des urgences +- **Pièces jointes** : Support des fichiers et captures d'écran +- **Historique complet** : Traçabilité de toutes les interactions + +### Organisation d'équipe +- **Départements spécialisés** : Technique, commercial, facturation +- **Attribution automatique** : Routage intelligent des tickets +- **Collaboration** : Partage et transfert entre équipes +- **Notifications** : Alertes en temps réel + +### Automatisation +- **Fermeture automatique** : Tickets inactifs après délai +- **Ré-ouverture contrôlée** : Gestion des demandes de suivi +- **Webhooks** : Intégration avec outils externes +- **Modèles de réponse** : Réponses standardisées + +## Interface client + +### Création de tickets +Les clients peuvent facilement créer des tickets via : +- Interface web dédiée +- Formulaire de contact intégré +- E-mail vers adresse support +- Paramètres URL prédéfinis + +### Suivi personnalisé +- **Tableau de bord client** : Vue d'ensemble des tickets +- **Notifications e-mail** : Mises à jour automatiques +- **Historique complet** : Accès aux conversations passées +- **Statuts clairs** : Suivi de l'avancement + +## Interface administrative + +### Gestion centralisée +- **Vue d'ensemble** : Tous les tickets en un coup d'œil +- **Filtres avancés** : Recherche par critères multiples +- **Actions en lot** : Traitement groupé +- **Statistiques** : Métriques de performance + +### Outils de productivité +- **Réponses rapides** : Templates prédéfinis +- **Assignation** : Attribution manuelle ou automatique +- **Escalade** : Transfert vers niveaux supérieurs +- **Notes internes** : Communication équipe + +## Intégrations avancées + +### Webhooks +Connectez votre centre d'aide à : +- **Discord/Slack** : Notifications temps réel +- **CRM externes** : Synchronisation client +- **Outils de monitoring** : Alertes système +- **Solutions tierces** : API personnalisées + +### Personnalisation +- **Branding** : Adaptation à votre charte graphique +- **Multilingue** : Support international +- **Champs personnalisés** : Données spécifiques métier +- **Workflows** : Processus sur mesure + +## Métriques et optimisation + +### Indicateurs clés +Surveillez la performance avec : +- **Temps de première réponse** +- **Temps de résolution moyen** +- **Taux de satisfaction client** +- **Volume de tickets par département** +- **Charge de travail par agent** + +### Amélioration continue +- **Analyse des tendances** : Identification des problèmes récurrents +- **Formation équipe** : Basée sur les métriques réelles +- **Optimisation processus** : Réduction des temps d'attente +- **Base de connaissances** : Prévention des tickets répétitifs + +## Bonnes pratiques + +### Configuration initiale +1. **Définir les départements** selon votre activité +2. **Paramétrer les automatisations** appropriées +3. **Former l'équipe** aux outils et processus +4. **Tester le workflow** avant mise en production + +### Gestion quotidienne +1. **Traiter rapidement** les urgences +2. **Maintenir une communication** claire et régulière +3. **Utiliser les modèles** pour la cohérence +4. **Analyser les métriques** pour l'amélioration + +### Évolution +1. **Adapter la configuration** selon l'activité +2. **Former régulièrement** l'équipe +3. **Collecter les retours** clients +4. **Optimiser continuellement** les processus + +:::warning Important +Un centre d'aide efficace nécessite une maintenance régulière et une attention constante aux besoins de vos clients. Investissez dans la formation de votre équipe et l'optimisation de vos processus. +::: + +## Navigation dans cette section + \ No newline at end of file diff --git a/docs/settings/personalization/bottom_menu.md b/docs/settings/personalization/bottom_menu.md index 5e6e44f..b4a81b0 100644 --- a/docs/settings/personalization/bottom_menu.md +++ b/docs/settings/personalization/bottom_menu.md @@ -1,14 +1,255 @@ -# Menu de pied de la page -Vous pouvez modifier les éléments du menu de pied de la page en allant dans les `Paramètres` puis dans `Personnalisation` puis `Menu du pied de la page`. -![image](/img/next_gen/settings/personalization/bottom_menu/admin.png) -Vous pouvez ajouter, modifier ou supprimer des éléments du menu de pied de la page. +# Menu du pied de page -**Description** : Vous pouvez ajouter une description de votre société en bas de page. +Dans **CLIENTXCMS**, le **pied de page** représente l'ancrage final de votre plateforme et l'espace de confiance où vos visiteurs cherchent les informations essentielles.
+L'objectif est capital : **rassurer sur votre professionnalisme**, **fournir les liens légaux obligatoires** et **renforcer votre crédibilité**. Un footer bien structuré complète parfaitement l'expérience utilisateur et peut convertir les visiteurs hésitants en dernière instance. -**Badge TopHeberg** : Vous pouvez ajouter un badge TopHeberg en bas de page. +Cette page permet de configurer tous les éléments du pied de page pour créer une zone de confiance optimale. -Vous pouvez sauvegarder les modifications en cliquant sur le bouton `Enregistrer`. +Vous pouvez personnaliser le pied de page depuis : -Vous pouvez également ajouter des liens vers vos [réseaux sociaux](/docs/settings/personalization/socials.md). -## Bas de page -![image](/img/next_gen/settings/personalization/socials/footer.png) \ No newline at end of file +`Paramètres` > `Personnalisation` > `Menu du pied de page` + +![Configuration du pied de page](/img/next_gen/settings/personalization/bottom_menu/admin.png) + +:::tip Astuce +Votre pied de page est votre **zone de confiance finale**. +C'est souvent le dernier élément consulté avant une décision d'achat - il doit rassurer et légitimer votre entreprise. +::: + +## Pourquoi optimiser le pied de page ? + +Un footer efficace permet de : + +* **Rassurer les visiteurs** avec les informations légales et de contact +* **Améliorer le référencement** avec des liens internes structurés +* **Renforcer la crédibilité** avec des badges et certifications +* **Faciliter la navigation** avec des liens utiles organisés +* **Respecter les obligations légales** (mentions, CGV, politique de confidentialité) + +:::tip Astuce +C'est comme les références d'un CV professionnel 📄 — personne ne les regarde en premier, mais tout le monde vérifie qu'elles sont là et sérieuses. +::: + +## Configuration des éléments + +### Contenu descriptif + +**Description de votre société** | (texte enrichi)
+Présentation courte et percutante de votre entreprise qui renforce votre positionnement. + +**Exemples efficaces** : +``` +"Spécialiste de l'hébergement web haute performance depuis 2015. +Plus de 5 000 clients nous font confiance pour héberger leurs projets +avec 99.9% de disponibilité garantie." +``` + +``` +"Agence digitale créative accompagnant les entreprises ambitieuses +dans leur transformation numérique. Expertise reconnue en design, +développement et stratégie digitale." +``` + +**Conseils de rédaction** : +- **Concision** : 2-3 phrases maximum +- **Crédibilité** : Chiffres, années d'expérience, certifications +- **Différenciation** : Ce qui vous rend unique +- **Call-to-action subtil** : Invitation à l'action discrète + +### Éléments de navigation + +**Menu du pied de page** | (liens organisés)
+Structure de liens permettant l'accès aux pages importantes et obligatoires. + +**Actions disponibles** : +- **Ajouter** : Nouveau lien vers une page +- **Modifier** : Changer le libellé ou la destination +- **Supprimer** : Retirer un lien obsolète +- **Réorganiser** : Changer l'ordre d'affichage + +**Types de liens recommandés** : +- **Légaux** : Mentions légales, CGV, politique de confidentialité +- **Support** : Contact, FAQ, documentation +- **Commerciaux** : Produits, tarifs, partenaires +- **Institutionnels** : À propos, équipe, recrutement + +### Éléments de crédibilité + +**Badge TopHeberg** | (certification)
+Badge de certification TopHeberg pour renforcer votre crédibilité dans le secteur de l'hébergement. + +#### Avantages du badge +- **Reconnaissance sectorielle** : Certification officielle TopHeberg +- **Confiance client** : Validation par un tiers de confiance +- **Différenciation** : Preuve de qualité face à la concurrence +- **SEO** : Backlink de qualité depuis TopHeberg + +#### Quand l'utiliser +- ✅ **Hébergeurs certifiés** : Membres actifs de TopHeberg +- ✅ **Secteur web** : Activité directement liée à l'hébergement +- ❌ **Autres secteurs** : Non pertinent pour les agences pure-play + +## Structure recommandée + +### Footer classique organisé + +``` +┌─────────────────────────────────────────────────────────────┐ +│ [LOGO] Description de l'entreprise │ +│ │ +│ PRODUITS SUPPORT LÉGAL CONTACT │ +│ • Hébergement Web • Documentation • Mentions • Email │ +│ • Serveurs VPS • Tickets • CGV • Tel. │ +│ • Domaines • FAQ • Confidentialité │ +│ │ +│ [Réseaux sociaux] [Badge TopHeberg] © 2024 VotreEntreprise │ +└─────────────────────────────────────────────────────────────┘ +``` + +### Footer avec 4 colonnes + +**Colonne 1 : Produits/Services** +- Offres principales +- Nouveautés +- Comparatifs + +**Colonne 2 : Support & Aide** +- Documentation +- Tutoriels +- Centre d'aide +- Statut des services + +**Colonne 3 : Entreprise** +- À propos +- Équipe +- Carrières +- Actualités + +**Colonne 4 : Légal & Contact** +- Mentions légales +- CGV/CGU +- Politique de confidentialité +- Contact + +## Intégration des réseaux sociaux + +### Configuration automatique + +Les liens vers vos réseaux sociaux configurés dans `Personnalisation` > `Réseaux sociaux` s'affichent automatiquement dans le pied de page. + +[Configuration des réseaux sociaux](./socials) + +**Affichage dans le footer** : +![Réseaux sociaux dans le pied de page](/img/next_gen/settings/personalization/socials/footer.png) + +### Optimisation des réseaux + +**Choix stratégique** : +- **LinkedIn** : Crédibilité B2B et professionnelle +- **Twitter** : Communication et support client +- **Facebook** : Proximité et communauté +- **Instagram** : Vitrine visuelle et culture d'entreprise +- **YouTube** : Tutoriels et démonstrations + +**Bonnes pratiques** : +- **Icônes cohérentes** : Style uniforme avec votre charte +- **Ouverture externe** : Nouveaux onglets pour ne pas perdre le visiteur +- **Activité régulière** : Réseaux actifs et entretenus uniquement +- **Pertinence sectorielle** : Adaptés à votre audience + +## Obligations légales + +### Mentions obligatoires + +**Entreprises françaises** : +- **Mentions légales** : Raison sociale, SIRET, RCS +- **Hébergeur** : Coordonnées de l'hébergeur du site +- **Responsable publication** : Directeur de publication +- **Contact** : Email et téléphone obligatoires + +**E-commerce** : +- **CGV** : Conditions générales de vente +- **Politique de retour** : Délais et procédures +- **Frais de livraison** : Tarifs et modalités +- **Service client** : Coordonnées et horaires + +### Conformité RGPD + +**Politique de confidentialité** : +- **Données collectées** : Types et finalités +- **Durée de conservation** : Périodes de stockage +- **Droits utilisateur** : Accès, rectification, suppression +- **Cookies** : Utilisation et gestion + +**Gestion des cookies** : +- **Banner de consentement** : Obligatoire sur le site +- **Choix granulaire** : Par catégorie de cookies +- **Révocation** : Possibilité de retirer le consentement + +## Optimisation SEO + +### Structure technique + +**Balisage sémantique** : +- **Footer HTML** : Balise `