diff --git a/blog/2024-05-20-nouvelle-version-2.10.0.md b/blog/2024-05-20-nouvelle-version-2.10.0.md index 334c365..b36da47 100644 --- a/blog/2024-05-20-nouvelle-version-2.10.0.md +++ b/blog/2024-05-20-nouvelle-version-2.10.0.md @@ -11,7 +11,7 @@ Nous sommes ravis de vous annoncer la sortie de la version **v2.10.0** de Client -`➕` **Menus personnalisables en haut et en bas de page** : Profitez d'une plus grande flexibilité dans la navigation en ajoutant des menus personnalisés en haut et en bas de vos pages., -`➕` **Clonage de produits, de configurations et de groupe** : Simplifiez votre processus de création en clonant rapidement des produits existants avec toutes leurs configurations., -`➕` **Envoi d'email à différents moments avant expiration** : Restez en contact avec vos utilisateurs en leur envoyant des rappels à différents moments avant l'expiration des services, avec des options prédéfinies et modifiables., -`➕` **Page de gains de l'hébergeur** : Visualisez facilement vos gains en tant qu'hébergeur avec une nouvelle page dédiée. +- `➕` **Menus personnalisables en haut et en bas de page** : Profitez d'une plus grande flexibilité dans la navigation en ajoutant des menus personnalisés en haut et en bas de vos pages., +- `➕` **Clonage de produits, de configurations et de groupe** : Simplifiez votre processus de création en clonant rapidement des produits existants avec toutes leurs configurations., +- `➕` **Envoi d'email à différents moments avant expiration** : Restez en contact avec vos utilisateurs en leur envoyant des rappels à différents moments avant l'expiration des services, avec des options prédéfinies et modifiables., +- `➕` **Page de gains de l'hébergeur** : Visualisez facilement vos gains en tant qu'hébergeur avec une nouvelle page dédiée. diff --git a/blog/2024-06-11-nouvelle-version-2.11.0.md b/blog/2024-06-11-nouvelle-version-2.11.0.md index 52eca7c..17410e0 100644 --- a/blog/2024-06-11-nouvelle-version-2.11.0.md +++ b/blog/2024-06-11-nouvelle-version-2.11.0.md @@ -11,13 +11,13 @@ Nous sommes ravis de vous annoncer la sortie de la version **v2.11.0** de Client -`➕` **Codes promotionnels personnalisables** : Améliorez vos ventes avec des codes promo adaptés à vos clients !, -`➕` **Module Pterobox** : Permettez à vos clients de créer leurs propres serveurs sur votre plateforme Pterodactyl., -`➕` **Addon Page** : Créez votre propre page HTML sur l'espace client., -`➕` **Ajout des frais de transaction** : Déduisez directement les frais des passerelles de paiements sur la facture., -`➕` **Pièces jointes dans le centre d'aide** : Facilitez le support client en permettant l'ajout de pièces jointes dans le système de support., -`➕` **Système de statut clients** : Désactiver ou bannissez des clients non conformes, -`➕` **Refonte du PDF de facture & Numéro de facture** : Facilitez le l'administratif avec un numéro de facture unique personnalisable du type : CTX-2024-06-01., -`➕` Création de compte utilisateurs via l'administration, -`➕` **Bot communautaire & Personnalisé Discord sync** : Nous avons re-développer les bots spécialement pour Next GEN, -`➕` **Ajouts d'options dans les personnalisation** : Autoriser uniquement le mode sombre ou claire sur votre espace client ou désactivez la page d'accueil. +- `➕` **Codes promotionnels personnalisables** : Améliorez vos ventes avec des codes promo adaptés à vos clients !, +- `➕` **Module Pterobox** : Permettez à vos clients de créer leurs propres serveurs sur votre plateforme Pterodactyl., +- `➕` **Addon Page** : Créez votre propre page HTML sur l'espace client., +- `➕` **Ajout des frais de transaction** : Déduisez directement les frais des passerelles de paiements sur la facture., +- `➕` **Pièces jointes dans le centre d'aide** : Facilitez le support client en permettant l'ajout de pièces jointes dans le système de support., +- `➕` **Système de statut clients** : Désactiver ou bannissez des clients non conformes, +- `➕` **Refonte du PDF de facture & Numéro de facture** : Facilitez le l'administratif avec un numéro de facture unique personnalisable du type : CTX-2024-06-01., +- `➕` Création de compte utilisateurs via l'administration, +- `➕` **Bot communautaire & Personnalisé Discord sync** : Nous avons re-développer les bots spécialement pour Next GEN, +- `➕` **Ajouts d'options dans les personnalisation** : Autoriser uniquement le mode sombre ou claire sur votre espace client ou désactivez la page d'accueil. diff --git a/blog/2024-07-07-nouvelle-version-2.12.0.md b/blog/2024-07-07-nouvelle-version-2.12.0.md index f203c4a..6e93761 100644 --- a/blog/2024-07-07-nouvelle-version-2.12.0.md +++ b/blog/2024-07-07-nouvelle-version-2.12.0.md @@ -11,14 +11,15 @@ Nous sommes ravis de vous annoncer la sortie de la version **v2.12.0** de Client -`➕` Ajout de l'2FA Clients/Administrateur : Sécurisez davantage vos comptes avec l'authentification à deux facteurs., -`➕` Historique des modifications/actions effectuées par le système : Gardez une trace des modifications et actions effectuées pour une meilleure transparence., -`➕` Ajout d'un système de rôle et permissions : Gérez les accès et les permissions de manière plus fine et sécurisée., -`➕` Extension Virtualizor : Avec l'automatisation des revendeurs, -`➕` Actions de masse : Gagnez du temps avec les actions de masse sur vos services, factures et IPAM., -`➕` Système de maintenance : Mettez en place facilement des périodes de maintenance pour votre espace client., -`➕` Ajout de captcha de sécurité : Renforcez la sécurité avec des captchas pour protéger votre espace client., -`➕` Possibilité de proposer des sous-domaines à l'achat : Offrez plus de flexibilité à vos clients en permettant de mettre leur site sur un de vos domaines., +- `➕` Ajout de l'2FA Clients/Administrateur : Sécurisez davantage vos comptes avec l'authentification à deux facteurs. +- `➕` Historique des modifications/actions effectuées par le système : Gardez une trace des modifications et actions effectuées pour une meilleure transparence. +- `➕` Ajout d'un système de rôle et permissions : Gérez les accès et les permissions de manière plus fine et sécurisée. +- `➕` Extension Virtualizor : Avec l'automatisation des revendeurs, +- `➕` Actions de masse : Gagnez du temps avec les actions de masse sur vos services, factures et IPAM. +- `➕` Système de maintenance : Mettez en place facilement des périodes de maintenance pour votre espace client. +- `➕` Ajout de captcha de sécurité : Renforcez la sécurité avec des captchas pour protéger votre espace client. +- `➕` Possibilité de proposer des sous-domaines à l'achat : Offrez plus de flexibilité à vos clients en permettant de mettre leur site sur un de vos domaines. + Corrections : -`🛠️` Correction de divers bugs pour améliorer la stabilité et la performance du système. +- `🛠️` Correction de divers bugs pour améliorer la stabilité et la performance du système. diff --git a/blog/2025-03-18-nouvelle-version-2.14.3.md b/blog/2025-03-18-nouvelle-version-2.14.3.md index 7847d95..346450a 100644 --- a/blog/2025-03-18-nouvelle-version-2.14.3.md +++ b/blog/2025-03-18-nouvelle-version-2.14.3.md @@ -4,7 +4,7 @@ title: Nouvelle version v2.14.3 authors: [martindev] tags: [version, release, clientxcms] --- -# v2.14.3 - Contact Update** +# v2.14.3 - Contact Update Nous sommes ravis de vous annoncer la sortie de la version **v2.14.3** de ClientXCMS, qui apporte de nombreuses améliorations et nouvelles fonctionnalités pour enrichir votre expérience utilisateur. ![version v2.14.3](/img/blog/versions/v2.14.3.png) diff --git a/blog/2025-04-25-nouvelle-version-2.14.4.md b/blog/2025-04-25-nouvelle-version-2.14.4.md index e686a77..463bbaf 100644 --- a/blog/2025-04-25-nouvelle-version-2.14.4.md +++ b/blog/2025-04-25-nouvelle-version-2.14.4.md @@ -4,7 +4,7 @@ title: Nouvelle version v2.14.4 authors: [martindev] tags: [version, release, clientxcms] --- -# v2.14.4** +# v2.14.4 Nous sommes ravis de vous annoncer la sortie de la version **v2.14.4** de ClientXCMS, qui apporte de nombreuses améliorations et nouvelles fonctionnalités pour enrichir votre expérience utilisateur. ![version v2.14.4](/img/blog/versions/v2.14.4.png) diff --git a/blog/2025-05-28-nouvelle-version-2.14.5.md b/blog/2025-05-28-nouvelle-version-2.14.5.md index dfabad6..50b2001 100644 --- a/blog/2025-05-28-nouvelle-version-2.14.5.md +++ b/blog/2025-05-28-nouvelle-version-2.14.5.md @@ -4,7 +4,7 @@ title: Nouvelle version v2.14.5 authors: [martindev] tags: [version, release, clientxcms] --- -# v2.14.5 - Amélioration du centre d'aide** +# v2.14.5 - Amélioration du centre d'aide Nous sommes ravis de vous annoncer la sortie de la version **v2.14.5** de ClientXCMS, qui apporte de nombreuses améliorations et nouvelles fonctionnalités pour enrichir votre expérience utilisateur. ![version v2.14.5](/img/blog/versions/v2.14.5.png) diff --git a/blog/2025-05-31-mise-en-opensource.md b/blog/2025-05-31-mise-en-opensource.md index b5431b6..b2bbe52 100644 --- a/blog/2025-05-31-mise-en-opensource.md +++ b/blog/2025-05-31-mise-en-opensource.md @@ -10,7 +10,7 @@ Nous avons aujourd’hui le plaisir de vous annoncer un changement significatif {/* truncate */} ![image](/img/blog/mise-en-opensource/image.png) -======= + ### Un CMS conçu pour être ouvert à toutes et à tous diff --git a/blog/2025-07-02-nouvelle-version-2.14.6.md b/blog/2025-07-02-nouvelle-version-2.14.6.md new file mode 100644 index 0000000..941f268 --- /dev/null +++ b/blog/2025-07-02-nouvelle-version-2.14.6.md @@ -0,0 +1,14 @@ +--- +slug: nouvelle-version-2.14.6 +title: Nouvelle version 2.14.6 +authors: [martindev] +--- +# v2.14.6 + +Nous sommes ravis de vous annoncer la sortie de la version **2.14.6** de ClientXCMS ! +![version 2.14.6](/img/blog/versions/v2.14.6.png) + + +## ➕ Ajouts + +- ➕ Ajout de la **télémetrie** diff --git a/blog/2025-07-16-nouvelle-version-2.14.7.md b/blog/2025-07-16-nouvelle-version-2.14.7.md new file mode 100644 index 0000000..218b8cb --- /dev/null +++ b/blog/2025-07-16-nouvelle-version-2.14.7.md @@ -0,0 +1,17 @@ +--- +slug: nouvelle-version-2.14.7 +title: Nouvelle version 2.14.7 +authors: [martindev] +--- +# v2.14.7 + +Nous sommes ravis de vous annoncer la sortie de la version **2.14.7** de ClientXCMS ! +![version 2.14.7](/img/blog/versions/v2.14.7.png) + + + +## ➕ Ajouts + +- ➕ Addon **DiscordGift** +- ➕ Addon **GiftCard** +- ➕ [Proxmox] Support de la gestion des **IPv6** diff --git a/blog/2025-08-01-lancement-giftcard-discordgift.md b/blog/2025-08-01-lancement-giftcard-discordgift.md new file mode 100644 index 0000000..34c50e9 --- /dev/null +++ b/blog/2025-08-01-lancement-giftcard-discordgift.md @@ -0,0 +1,76 @@ +--- +slug: lancement-giftcard-discordgift +title: Lancement des addons « Gift Card » & « Discord Gift » +authors: [martindev] +tags: [addons, boutique, communauté, clientxcms] +--- +# Lancement officiel des add-ons « Gift Card » & « Discord Gift » + +Nous sommes heureux d’annoncer la sortie de **deux nouveaux addons majeurs** qui viennent renforcer la boutique, dynamiser votre communauté et offrir de nouvelles possibilités d’engagement pour vos utilisateurs. + +![addons](/img/blog/lancement-giftcard-discordgift/header.png) + +Ces deux outils sont simples, puissants, et surtout conçus pour augmenter vos revenus tout en proposant une meilleure expérience utilisateur. + + +## Gift Card – Cartes-cadeaux + +![giftcard](/img/next_gen/extensions/addons/giftcards/giftcards_client_view.png) + +L’addon **Gift Card** permet de créer, vendre et gérer des cartes-cadeaux directement depuis votre espace client ClientXCMS. + + +### Fonctionnalités principales + +- Génération automatique de cartes-cadeaux (code unique) +- Montant **fixe** ou **aléatoire** +- Utilisations limitées ou illimitées +- Envoi automatique par e-mail +- Tableau de bord complet : total reversé, taux d’utilisation, historique + +![admin-giftcards](/img/next_gen/extensions/addons/giftcards/giftcards_admin_view.png) + + +### Achat en boutique + +![giftcard-store](/img/next_gen/extensions/addons/giftcards/giftcards_creer_admin.png) + +👉 Choisir un montant → valider le paiement → recevoir le code instantanément. + +### Prix + +➡️ **6,50€ TTC – à vie** +👉 https://clientxcms.com/resources/giftcard + +Documentation : https://docs.clientxcms.com/extensions/addons/giftcard + + +## Discord Gift – Cadeaux Discord automatisés + +![discordgift](/img/next_gen/extensions/addons/discordgift/discordgift_admin_config.png) + +L’addon **Discord Gift** crée une nouvelle dynamique communautaire : +un code généré automatiquement, publié sur votre serveur via Webhook, et utilisable une seule fois par chaque membre. + + +### Fonctionnalités principales + +- Lancement automatique ou manuel +- Publication du code via Webhook avec minuteur +- Montant crédité **aléatoire** (min/max) +- Nombre d’utilisations configurable +- Graphique des derniers lancements +- Messages personnalisables : début, utilisation, fin + +![discordgift-webhook](/img/next_gen/extensions/addons/discordgift/discordgift_webhooks.png) + + + +### Prix + +➡️ **6,50€ TTC – à vie** +👉 https://clientxcms.com/resources/discordgift + +Documentation : https://docs.clientxcms.com/extensions/addons/discordgift + + diff --git a/blog/2025-08-21-nouvelle-version-2.14.8.md b/blog/2025-08-21-nouvelle-version-2.14.8.md new file mode 100644 index 0000000..1efed81 --- /dev/null +++ b/blog/2025-08-21-nouvelle-version-2.14.8.md @@ -0,0 +1,36 @@ +--- +slug: nouvelle-version-2.14.8 +title: Nouvelle version 2.14.8 +authors: [martindev] +--- +# v2.14.8 - Open-source update + + +Nous sommes ravis de vous annoncer la sortie de la version **2.14.8** de ClientXCMS ! +![version 2.14.8](/img/blog/versions/v2.14.8.png) + +## ➕ Ajouts + +- ➕ Téléchargement via la page d’extensions +- ➕ Abonnement via PayPal disponible +- ➕ Paiement partiel d’une facture grâce au crédit +- ➕ Indépendance des données de facturation +- ➕ Création automatique de facture lors du paiement +- ➕ Export des factures sous différents formats +- ➕ Champ entreprise & informations fiscales sur factures +- ➕ Date prédéfinie sur un abonnement +- ➕ Historique amélioré des modifications de solde client +- ➕ Ajout d’une bannière RGPD + +## ❌ Suppressions + +- ❌ Effacement & suppression de fichiers dans l’historique +- ❌ Suppression d’une facture interdite lorsqu'elle est payée + +## 🔄 Modifications + +- 🔄 Format UUID réduit : **8 → 5 caractères** + +## 🔧 Corrections + +- 🔧 Vérification améliorée des domaines lors d’un achat diff --git a/blog/2025-11-20-nouvelle-version-2.14.9.md b/blog/2025-11-20-nouvelle-version-2.14.9.md new file mode 100644 index 0000000..f7ca834 --- /dev/null +++ b/blog/2025-11-20-nouvelle-version-2.14.9.md @@ -0,0 +1,35 @@ +--- +slug: nouvelle-version-2.14.9 +title: Nouvelle version 2.14.9 +authors: [martindev] +--- +# v2.14.9 + +Nous sommes ravis de vous annoncer la sortie de la version **2.14.9** de ClientXCMS ! +![version 2.14.9](/img/blog/versions/v2.14.9.png) + +## ➕ Ajouts + +- ➕ Envoi de payloads vers **des webhooks autres que Discord** +- ➕ Addon **Announcement Bar** +- ➕ Addon **particules.js** *(merci à Ikae ❤️)* +- ➕ [Proxmox] Support des **commandes post-installation** sur les LXC +- ➕ Possibilité de définir **une route personnalisée comme page d’accueil** +- ➕ Ajout d’une **description formatée** dans les factures +- ➕ Mise en place des contenus pour les **badges produits** (Addon Avis & Addon FAQ) +- ➕ Ajout d’un **historique des actions sur les factures** +- ➕ Possibilité de **livrer ou annuler une commande directement depuis une facture** + +## 🔄 Modifications + +- 🔄 **Refonte visuelle** : la facture est désormais découpée en plusieurs tableaux pour une meilleure lisibilité + +## 🔧 Corrections + +- 🔧 [Proxmox] Correction du **MUT** +- 🔧 Correction de l’édition/suppression d’éléments dans une facture +- 🔧 Correction du 2FA lors de la modification du mot de passe +- 🔧 Normalisation des dates sur l’outil de migration v1 +- 🔧 Amélioration & renforcement des permissions administrateur +- 🔧 Correction du prix des réductions sur un service +- 🔧 Correction du loggable lors du changement de balance utilisateur diff --git a/blog/2025-11-21-update-clientxcms-novembre-2025.md b/blog/2025-11-21-update-clientxcms-novembre-2025.md new file mode 100644 index 0000000..6322fd0 --- /dev/null +++ b/blog/2025-11-21-update-clientxcms-novembre-2025.md @@ -0,0 +1,142 @@ +--- +slug: update-clientxcms-novembre-2025 +title: Mise à jour du site CLIENTXCMS 11/2025 +authors: [martindev] +tags: [update, clientxcms, features, marketplace, releases] +--- +import useBaseUrl from '@docusaurus/useBaseUrl'; + +# 🚀 Mise à jour du site CLIENTXCMS + +Nous sommes heureux de vous présenter les dernières améliorations du site **clientxcms.com**, incluant de nouvelles fonctionnalités, un meilleur workflow pour la communauté, et plusieurs nouveautés côté addons & services. +Découvrez tout ce qui a changé ces derniers jours 👇 + +![Header mise à jour CLIENTXCMS](/img/blog/update-novembre-2025/header.png) + + + +## CTXMailer + +Les offres **Premium** et **Entreprise** incluent désormais **CTXMailer**, un service de mails professionnels : + +- 📬 jusqu’à **20 boîtes mail incluses** +- 📧 jusqu'à **25 alias de boîtes** +- 💾 **15 Go de stockage** +- 🔐 interface simple & sécurisée + +Pour les utilisateurs ayant une licence Community, CTXMailer est disponible en option pour **3 € / mois**. + +**Idéal pour :** + +- avoir des adresses e-mail *pro* au nom de votre domaine +- centraliser la gestion via CLIENTXCMS +- maintenir une communication professionnelle avec vos clients +- bénéficier de SMTP fiable et rapide + +**Aperçu CTXMailer :** + +![CTXMailer screenshot](/img/blog/update-novembre-2025/ctxmailer.png) + +## Support des redirections multiples + +Il est désormais possible d’ajouter **plusieurs URLs de redirection** dans l'onglet **"Changer de domaine"** de votre espace client. Elle permet d'ajouter plusieurs redirections pour une même licence, par exemple : + +- https://client.clientxcms.com +- https://www.clientxcms.com +- https://client.clientxcms.com + +Ces redirections facilitent la gestion de domaines, de sous-domaines et d'environsments miroir. + +![Capture](/img/blog/update-novembre-2025/redirects.png) + +## Synchronisation Discord intégrée + +Vous pouvez maintenant **lier votre compte CLIENTXCMS à Discord** afin de recevoir automatiquement les rôles qui correspondent à votre statut : + +- **@Customers** : licence payante +- **@Community** : licence gratuite +- **@Développeur** : développeur enregistré +- **@Développeur certifié** : développeur certifié + +### Comment synchroniser ? + +1. Rendez-vous sur : **https://clientxcms.com/client/profile** +2. Cliquez sur **« Synchroniser avec Discord »** en bas de page +3. Autorisez la connexion +4. Les rôles sont automatiquement appliqués 🎉 + +**Aperçu :** + +![Capture connexion Discord](/img/blog/update-novembre-2025/discord_sync.png) + +Ces rôles permettent de faciliter la gestion des accès aux salons privés, aux ressources exclusives et aux discussions réservées aux membres de la communauté CLIENTXCMS. + +## Nouvel addon gratuit : Announcement Bar + +Nous publions un nouvel addon totalement **gratuit** : +🎉 **Announcement Bar**, une barre d’annonce moderne, responsive et hautement personnalisable. + +Idéal pour afficher : + +- promotions +- alertes +- messages de maintenance +- actualités importantes + +➡️ Documentation : https://docs.clientxcms.com/extensions/addons/announcement_bar + +➡️ Ressource : https://clientxcms.com/resources/announcement_bar + +**Aperçu :** + +![Preview Announcement Bar](/img/blog/update-novembre-2025/announcement_bar.png) + +## Contribution de la communauté : merci @Ikiae + +Un énorme merci à **@Ikiae**, qui a contribué à deux améliorations majeures : + +### Nouvelle extension **Particles.js** + +Une extension permettant d’ajouter de magnifiques effets visuels avec `particles.js`. ✨ + +➡️ Disponible ici : https://clientxcms.com/resources/particles + +![Particles.js](https://i.postimg.cc/YC5sW0bs/default.gif) + +### Commandes post-installation sur le module Proxmox + +Un ajout qui permet d’automatiser les étapes post-install, rendant possible la configuration avancée de vos services Proxmox. +➡️ Documentation : https://docs.clientxcms.com/extensions/modules/proxmox + +## Releases GitHub automatiques + +Le versionning a été amélioré : chaque mise à jour de CLIENTXCMS déclenche désormais une **release GitHub automatique**.Cela permet : + +- un suivi de versions propre +- un changelog clair +- des téléchargements plus fiables +- une meilleure organisation du projet open-source + +## Thème Nexus & Addon Avis Client + +Le thème **Nexus** est en phase de développement 🎨Il sera publié d’ici **1 à 2 semaines**, en même temps que le nouveau **Addon Avis Client**, qui permettra : + +- l’envoi automatique d’e-mails pour demander un avis +- validation manuelle ou auto +- récompenses pour les utilisateurs +- affichage public des avis +- formulaire personnalisable par offre +- espace utilisateur dédié + +## Un mot de fin + +Nous faisons en sorte de **bien faire les choses**, de prendre le temps nécessaire et de nous appuyer sur les bons outils, afin de vous proposer : + +- un système plus propre +- plus simple +- plus fiable +- et plus durable pour l’avenir + +Nous pourrons ainsi continuer à innover et vous offrir les meilleures fonctionnalités possibles pour gérer votre activité en ligne grâce à CLIENTXCMS. + +Merci pour votre soutien, vos retours et votre implication dans la communauté 🚀💙 diff --git a/docs/developpers/extensions/extensions.md b/docs/developpers/extensions/extensions.md index b8cf8a8..9f7fc3f 100644 --- a/docs/developpers/extensions/extensions.md +++ b/docs/developpers/extensions/extensions.md @@ -30,4 +30,13 @@ Les extensions chargées peuvent s'activer ou se désactiver dans la page Extens Pour faire simple, les modules sont utilisés comme livraison de service par exemple pour implémenter un panel de gestion comme Virtualizor, Plesk, ou Pterodactyl. Les addons sont utilisés pour ajouter des fonctionnalités supplémentaires comme des méthodes de paiement, logique, ou des pages personnalisées. ## Demande d'ajout au marketplace -Pour toutes demandes, veuillez nous contacter. \ No newline at end of file + +Vous pouvez faire la demande pour être développeur sur [https://clientxcms.com/client/resources](https://clientxcms.com/client/ressources) et ainsi proposer vos extensions à la communauté. +![Capture d’écran création d'une extension](/img/blog/lancement-opensource/marketplace2.png) + +Désormais, chaque développeur peut : +- Créer ses propres extensions +- Publier et partager ses créations via [clientxcms.com/client/ressources](https://clientxcms.com/client/ressources) +- Explorer et installer facilement les extensions partagées par la communauté + +Cette interface intuitive a été pensée pour simplifier la gestion et encourager l’écosystème collaboratif autour de CLIENTXCMS. diff --git a/docs/extensions/addons/abby.md b/docs/extensions/addons/abby.md new file mode 100644 index 0000000..c4598dc --- /dev/null +++ b/docs/extensions/addons/abby.md @@ -0,0 +1,28 @@ +# Abby +Abby automatise l’enregistrement des recettes dans votre livre comptable. Chaque vente, paiement ou facture réglée dans CLIENTXCMS est synchronisée automatiquement dans le bon compte de recettes, sans saisie manuelle. Configurez vos produits, laissez Abby générer les écritures et gardez un historique complet : date, montant, client, facture et lien direct. + + +:::info +Pour utiliser les fonctionnalités suivantes, il faut que l'addon Abby soit activé sur votre CLIENTXCMS . [cliquez ici pour l'activer](../) +::: + +:::info Comptabilité +L'addon Abby importe uniquement les factures une fois qu'elles sont payées. Les factures impayées, annulées ou autres ne seront pas importées dans Abby. Cela n'importe pas les paiements manuels effectués par les crédits clients considérant qu'ils sont déjà comptabilisés en tant que recettes lors de l'ajout du crédit. +::: +## Configuration +Vous pouvez configurer votre environement Abby dans votre fichier `.env` en ajoutant les lignes suivantes : + +```env +ABBY_API_KEY=your_api_key +``` +Remplacez `your_api_key` par votre clé API Abby. +Vous pouvez retrouver votre clé API dans votre compte Abby sous `Paramètres` > `Intégration` > `Clé d'API` > `Ajouter une clé`. + +## Migration des données existantes +Si vous avez déjà des factures payées dans CLIENTXCMS avant l'installation d'Abby, vous pouvez migrer ces données vers Abby en utilisant la commande artisan suivante : +```bash +php artisan abby:process-invoices --start-date=YYYY-MM-DD --end-date=YYYY-MM-DD +``` +Remplacez `YYYY-MM-DD` par les dates de début et de fin de la période que vous souhaitez migrer. Cette commande va traiter toutes les factures payées entre ces deux dates et les enregistrer dans Abby. + +Cela importera uniquement les factures payées. Les factures impayées, annulées ou autres ne seront pas migrées. \ No newline at end of file diff --git a/docs/extensions/addons/announcement_bar.md b/docs/extensions/addons/announcement_bar.md new file mode 100644 index 0000000..cdde63e --- /dev/null +++ b/docs/extensions/addons/announcement_bar.md @@ -0,0 +1,183 @@ +--- +sidebar_position: 1 +--- + +# Announcement Bar +L'addon Announcement Bar permet d'afficher une barre de notification en haut de votre site web pour informer vos utilisateurs des nouveautés, promotions ou alertes importantes. + +:::warning +Cet addon nécessite une version v2.14.9 ou supérieure de ClientXCMS. +::: + +## Configuration +Vous pouvez gérer la configuration de l'announcement bar dans `Espace d'administration ` > `Paramètres` > `Personalisations ` > `Bandeau d'annonce` + +**HTML du bandeau** : Vous pouvez mettre du HTML dans le champ de texte pour personnaliser le contenu de la barre d'annonce. +**Début d'affichage** : Vous pouvez définir la date et l'heure de début d'affichage de la barre d'annonce. +**Fin d'affichage** : Vous pouvez définir la date et l'heure de fin d'affichage de la barre d'annonce. +**Activer le bandeau** : Vous pouvez activer ou désactiver l'announcement bar. +:::info +Vérifiez que le thème que vous utilisez supporte l'affichage de l'announcement bar. Certains thèmes personnalisés peuvent ne pas afficher cette fonctionnalité. +::: + +## Comment supporter l'addon sur un thème ? +Pour que l'announcement bar s'affiche correctement, votre thème doit inclure le code suivant dans votre fichier `layouts/client.blade.php` ou `layouts/front.blade.php` ou équivalent, juste après la balise `` : + +```php + {!! app('seo')->header() !!} +``` + +## Exemple d'affichage de l'announcement bar : + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + + + +### Preview : + ![img](/img/next_gen/extensions/addons/announcement_bar/example1.png) +### Code source : +```html +
+
+ +
+
+
+

+ Démarrez dès aujourd'hui. +

+

+ Profitez du code promo "TEST" pour une remise de 5% sur votre première commande. +

+
+
+ +
+
+
+``` +
+ + +```html +
+
+
+
+ +
+

+ Frais d'installation offert dès 50€ d'achat +

+

+ Profitez-en avant la fin du mois +

+
+
+
+ + Découvrir + + +
+
+
+
+``` +
+ +### Preview : + ![img](/img/next_gen/extensions/addons/announcement_bar/example3.png) + +### Code source : +```html +
+
+
+
+ + + +

+ Offre Spéciale: -30% sur toute la collection Été avec le code ETE30 +

+
+ +
+
+
+``` +
+ +### Preview : + ![img](/img/next_gen/extensions/addons/announcement_bar/example4.png) +### Code source : +```html +
+
+
+
+ +
+

+ Offres exclusives du moment +

+
+ + WELCOME10 → -10% + + + FIRST20 → -20€ + + + FREE50 → Livraison offerte + +
+
+
+ +
+
+
+``` +
+ +
+ + ### Comment ajouter un bouton de fermeture ? + Vous pouvez ajouter un bouton de fermeture à l'announcement bar en utilisant le code HTML et + JavaScript suivant : +```html + + + +``` \ No newline at end of file diff --git a/docs/extensions/addons/free_trial.md b/docs/extensions/addons/free_trial.md index ce40d88..ee9d6f6 100644 --- a/docs/extensions/addons/free_trial.md +++ b/docs/extensions/addons/free_trial.md @@ -20,6 +20,7 @@ Deux options disponibles : * **Essai gratuit** : Le client accède gratuitement au service pendant un nombre défini de jours. À l’issue de cette période, il peut payer pour un mois d'utilisation. * **Amélioration** : Le client reçoit un service de base pendant l’essai. Il peut ensuite l’améliorer avec des services supplémentaires. +* **Essaie simple** : Le client peut tester le service gratuitement pendant une période définie. À la fin de cette période, le service est automatiquement supprimé s'il n'est pas converti en achat payant. ⚠️ **Important** : Si les upgrades n’apparaissent pas sur le service, il faut sauvegarder les produits dans le groupe correspondant. diff --git a/docs/extensions/addons/netbox.md b/docs/extensions/addons/netbox.md new file mode 100644 index 0000000..d4f4298 --- /dev/null +++ b/docs/extensions/addons/netbox.md @@ -0,0 +1,38 @@ +# Netbox +Utilisez NetBox comme source de vérité (Source of Truth) pour la gestion de vos adresses IP dans CLIENTXCMS. Cette extension remplace l'IPAM par défaut du module Proxmox pour vous permettre d'attribuer et de gérer vos adresses IP directement depuis votre instance NetBox, garantissant une meilleure organisation et évitant les conflits d'IP. + +:::info Prérequis +- Avoir une instance NetBox opérationnelle. +- Avoir l'API de NetBox accessible depuis votre instance CLIENTXCMS. +::: + +:::info +Cette extension nécessite que le module Proxmox soit activé sur votre CLIENTXCMS. [cliquez ici pour l'activer](../modules/Proxmox.md) +::: + +## Configuration de l'extension +Pour configurer l'extension, rendez-vous dans votre fichier d'environnement `.env` et ajoutez les variables suivantes : + +```env +NETBOX_URL=https://votre-instance-netbox/ +NETBOX_TOKEN=votre_token_api_netbox +``` +- **NETBOX_URL** : L'URL de votre instance NetBox. +- **NETBOX_TOKEN** : Le token API pour accéder à l'API de NetBox + +## Panel d'administration +Une fois l'extension installée, vous pouvez configurer les paramètres de NetBox dans `Espace d'administration ` > `Paramètres` > `Paramètres des extensions` > `Netbox`. +![img](/img/next_gen/extensions/addons/netbox/netbox.png) + +Vous retrouverez l'ensemble des IPs disponibles dans NetBox avec leur état. Le module Proxmox utilisera ces IPs pour l'attribution automatique lors de la création de machines virtuelles ou de conteneurs. +### Gestion des IPs + +Vous pouvez visualiser une IP spécifique pour la modification de son état (Disponible, Attribuée, Réservée). +![img](/img/next_gen/extensions/addons/netbox/details.png) +- **Active** : L'IP est disponible pour l'attribution. +- **Reserved** : L'IP est actuellement attribuée à une machine virtuelle ou un conteneur. +- **Indisponible** : L'IP n'est pas disponible pour l'attribution. + +:::info +Cette extension à été développée pour des utilisations spécifiques. N'hésitez pas à nous contacter pour toute demande de fonctionnalité ou d'amélioration. +::: \ No newline at end of file diff --git a/docs/extensions/modules/Proxmox.md b/docs/extensions/modules/Proxmox.md index a5fd525..09fa7ac 100644 --- a/docs/extensions/modules/Proxmox.md +++ b/docs/extensions/modules/Proxmox.md @@ -292,3 +292,6 @@ Si aucune IP n'est trouvée. Cette erreur est renvoyée. | `proxmox:disk-vps` | Gère le disque pour l'installation d'un VPS. | - | | `proxmox:installation-vps` | Gère l'installation des VPS qui doivent être installés. | - | | `proxmox:migrate-config` | Migre la configuration de Proxmox. | - | +| `proxmox:process-post-install` | Gère les actions post-installation des VPS. | - | + +### \ No newline at end of file diff --git a/docs/installation/docker.md b/docs/installation/docker.md new file mode 100644 index 0000000..0be8f45 --- /dev/null +++ b/docs/installation/docker.md @@ -0,0 +1,59 @@ +# Docker + +Vous pouvez installer ClientXCMS via Docker en suivant les étapes ci-dessous. +## Prérequis +Avant de commencer, assurez-vous d'avoir les éléments suivants : +- Un serveur avec Docker et Docker Compose installés. Vous pouvez suivre les instructions d'installation de + - [Docker](https://docs.docker.com/get-docker/) + - [Docker Compose](https://docs.docker.com/compose/install/) +- Un nom de domaine pointant vers votre serveur. + +Lancer les commandes suivantes pour installer Docker et Docker Compose sur un serveur Ubuntu : +```bash +docker compose build +``` +```bash +docker compose up -d +``` +## Installation + +1. Créez un répertoire pour ClientXCMS et accédez-y : +```bash +mkdir /var/www +cd /var/www +``` +2. Clonez le dépôt Git de ClientXCMS : +```bash +git clone https://github.com/ClientXCMS/clientxcms.git +cd clientxcms +``` +3. Copiez le fichier d'exemple de configuration Docker Compose : +```bash +cp docker-compose.example.yml docker-compose.yml +``` +4. Modifiez le fichier d'environnement pour configurer les variables nécessaires, notamment la connexion à la base de données et le nom de domaine : +```bash +cp .env.example .env +nano .env +``` +Vous pouvez modifier les variables comme le domaine : +```env +APP_URL=https://votre-domaine.com +OAUTH_CLIENT_ID="XX" +OAUTH_CLIENT_SECRET="XX" +``` +Ainsi que vos clés API, la connexion à la base de données, etc. + +Le docker se chargera de générer le certificat SSL via Let's Encrypt automatiquement en rajoutant l'email dans le fichier docker-compose.yml : +```yaml +- LETSENCRYPT_EMAIL=your_email@example.com +``` +5. Lancez les conteneurs Docker : +```bash +docker-compose up --build -d +``` +6. Ajouter un compte administrateur : +```bash +docker exec -it clientxcms_app-1 php artisan clientxcms:install-admin +``` +7. Accédez à votre nom de domaine dans un navigateur web pour terminer l'installation en confirmation l'accès à la licence diff --git a/docs/installation/requis.md b/docs/installation/requis.md index 35a9f42..94082e0 100644 --- a/docs/installation/requis.md +++ b/docs/installation/requis.md @@ -54,4 +54,4 @@ ClientXCMS supporte nativement MySQL. Il est recommandé d'utiliser la **version ### Serveur web ClientXCMS est compatible avec la plupart des serveurs web. Il est recommandé d'utiliser [Apache ou Nginx](./selfhosted) ou un [hébergement Plesk](./plesk). ### Docker -ClientXCMS pourra bientôt être installé via Docker. Pour cela, vous aurez besoin de Docker et Docker Compose installés sur votre serveur. \ No newline at end of file +Vous pouvez également installer ClientXCMS via Docker. Pour cela, vous devez disposer de Docker et Docker Compose installés sur votre serveur. Vous pouvez suivre les instructions d'installation via Docker [ici](./docker). \ No newline at end of file diff --git a/docs/installation/selfhosted.md b/docs/installation/selfhosted.md index c3df879..08791e8 100644 --- a/docs/installation/selfhosted.md +++ b/docs/installation/selfhosted.md @@ -1,6 +1,10 @@ --- sidebar_position: 5 --- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + # Autohébergement Cette page vous guidera dans l'installation de ClientXCMS Next Gen pour les versions autohébergées. Les offres Cloud sont installées automatiquement sur les serveurs de CLIENTXCMS. L'installation est disponible [ici](./cloud). @@ -21,10 +25,11 @@ Créez un dossier d'installation pour votre CMS si vous n'avez pas encore de ser ```bash mkdir /var/www/clientxcms ``` -## Téléchargement de l'archive -unzip clientxcms.zip -d /var/www/clientxcms +## Téléchargement du code source -Téléchargez la dernière version de ClientXCMS NextGen directement depuis GitHub avec la commande suivante : + + +Téléchargez la dernière version de ClientXCMS NextGen directement depuis GitHub : ```bash curl -L -o clientxcms.zip https://github.com/ClientXCMS/ClientXCMS/archive/refs/heads/master.zip ``` @@ -42,6 +47,21 @@ Si vous n'avez pas installé ZIP, vous pouvez l'installer avec la commande suiva sudo apt-get install zip unzip ``` ::: + + +Si vous préférez travailler avec Git, clonez directement le dépôt officiel : +```bash +cd /var/www +git clone https://github.com/ClientXCMS/ClientXCMS.git clientxcms +cd /var/www/clientxcms +``` + +Vous pourrez ensuite mettre à jour votre instance très simplement : +```bash +git pull origin master +``` + + ## Mise en place de l'environnement Créez un fichier `.env` en utilisant la commande suivante : @@ -99,9 +119,6 @@ mysql -u root -p ``` ## Mise en place du serveur web -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; - :::info @@ -327,14 +344,14 @@ sudo apt install supervisor Ensuite, créez un fichier de configuration `/etc/supervisor/conf.d/clientxcms-worker.conf` : ```ini -[program:laravel-worker] +[program:clientxcms-worker] process_name=%(program_name)s_%(process_num)02d -command=php /var/www/clientxcms/artisan queue:work --daemon +command=php /var/www/clientxcms/artisan queue:work --sleep=3 --tries=3 --timeout=90 autostart=true autorestart=true numprocs=1 redirect_stderr=true -stdout_logfile=/var/log/laravel-worker.log +stdout_logfile=/var/log/clientxcms-worker.log ``` Recharge et démarre Supervisor : @@ -411,4 +428,12 @@ Si vous avez des problèmes du jour au lendemain, vous avez problablement un pro ```bash php artisan cache:clear ``` -ou vous pouvez vérifier les permissions de votre dossier de cache (storage/framework/cache). \ No newline at end of file +ou vous pouvez vérifier les permissions de votre dossier de cache (storage/framework/cache). + +### Problème de permissions sur le dossier de logs +Si vous avez régulièrement des problèmes de permissions dans le dossier de logs, cela vient problablement que vous avez executer des commandes avec un utilisateur différent de celui utilisé par le serveur web (www-data sur Debian/Ubuntu). Pour régler ce problème, vous pouvez exécuter la commande suivante pour donner les bonnes permissions : +```bash +sudo chmod -R 775 storage/logs +``` + +Cela peut également venir des cron jobs qui s'exécutent avec un utilisateur différent. Assurez-vous que les permissions sont correctement définies pour tous les utilisateurs qui pourraient accéder à ces fichiers. diff --git a/docs/settings/billing/billing.md b/docs/settings/billing/billing.md index d7b0359..dd7976b 100644 --- a/docs/settings/billing/billing.md +++ b/docs/settings/billing/billing.md @@ -81,183 +81,47 @@ Le mode **inclusif** est généralement préféré pour le B2C car il évite les **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-" +**URL du webhook** : URL de votre endpoint pour recevoir les notifications de paiement (POST JSON). Utilisez une URL en HTTPS si possible. + +- Si l'URL fournie est un webhook Discord (ex. https://discord.com/api/webhooks/xxxxx), les notifications apparaîtront automatiquement sous forme d'embed (capture ci‑dessus). +- Si vous utilisez un webhook personnalisé, CLIENTXCMS enverra une requête HTTP POST avec un payload JSON structuré. Exemple : + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + + + + + +```json +{ + "payload": { + "action": "checkout_completed", + "_url": "https://example.com/admin/invoices/42", + "invoiceurl": "https://example.com/admin/invoices/42", + "customer_url": "https://example.com/admin/customers/1", + "customername": "Martin Dev", + "customeremail": "test@clientxcms.com", + "basketid": "BASK-123", + "total": "199.99", + "currency": "€", + "gatewayname": "Stripe", + "productnames": "VPS Pro, Sauvegarde avancée" + } +} ``` + -### Configuration société soumise à TVA -``` -Mode de taxe : Exclusif -TVA : Activée (20%) -Mode TVA : Taux variable (UE) -Préfixe : "FACT-" -``` + -### Configuration boutique internationale +Notes utiles : -``` -Devise : EUR -Mode de taxe : Inclusif -TVA : Taux variable -Webhook : Configuré pour Slack -``` +- `action` : identifie l'événement envoyé (`checkout_completed`, `service_upgraded`, etc.). +- `_url`, `invoiceurl` ou `service_url` : liens internes vers la facture ou le service concerné. +- Les valeurs sont envoyées en tant que chaînes. Adaptez la conversion (montant, devise…) selon votre intégration. -## 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é +**Taux de TVA par défaut** | (pourcentage)
+Le taux appliqué par défaut si aucun taux spécifique n'est défini. -:::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. -::: +**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. diff --git a/docs/settings/core/app.md b/docs/settings/core/app.md index f8c941e..3289bfe 100644 --- a/docs/settings/core/app.md +++ b/docs/settings/core/app.md @@ -95,146 +95,4 @@ Exemple de dimensions recommandées : - 128x128px minimum accepté ### Logo texte -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 +[](https://clientxcms.com/assets/images/logo/LogoBlueText.png) diff --git a/docs/settings/core/core.md b/docs/settings/core/core.md index 339646d..3579983 100644 --- a/docs/settings/core/core.md +++ b/docs/settings/core/core.md @@ -1,12 +1,11 @@ --- 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.
+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. @@ -38,178 +37,3 @@ Les paramètres généraux s'organisent autour de plusieurs composants : * **[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'; - - \ No newline at end of file diff --git a/docs/settings/core/license.md b/docs/settings/core/license.md index 3f39c0d..72ea088 100644 --- a/docs/settings/core/license.md +++ b/docs/settings/core/license.md @@ -14,275 +14,3 @@ 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/mail.md b/docs/settings/core/mail.md index f3b4366..ec92814 100644 --- a/docs/settings/core/mail.md +++ b/docs/settings/core/mail.md @@ -1,12 +1,11 @@ --- sidebar_position: 2 --- - import ThemedImage from '@theme/ThemedImage'; # Messagerie -Dans **CLIENTXCMS**, la configuration de la **messagerie** est essentielle pour maintenir une **communication fluide avec vos clients**.
+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. La messagerie est utilisée pour toutes les communications automatiques : inscriptions, réinitialisations de mot de passe, notifications de commandes, factures, etc. @@ -47,31 +46,31 @@ C'est un peu comme avoir un assistant personnel qui envoie automatiquement tous 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)
+**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)
+**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)
+**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)
+**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)
+**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)
+**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. @@ -79,33 +78,45 @@ Empêche l'envoi de tous les e-mails depuis le système. 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. +### CTXMailer - service mail professionnel + +CLIENTXCMS propose également **CTXMailer**, une offre d'hébergement de boîtes mail entièrement intégrée : + +- **Inclus** dans les plans **Premium** et **Enterprise** (support + hébergement cloud) +- **Caractéristiques** : jusqu'à 20 boîtes mail incluses, 15 Go de stockage, interface sécurisée +- **Option** : disponible pour les autres licences à **3 € / mois** + +En savoir plus : https://clientxcms.com/ctxmailer + +:::tip +Si vous utilisez CTXMailer, les paramètres SMTP sont fournis automatiquement et la configuration de délivrabilité (SPF/DKIM) est facilitée depuis l'espace client. +::: + ### Paramètres de connexion -**Hôte SMTP** | (adresse serveur)
+**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)
+**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) -**Chiffrement SMTP** | (menu déroulant)
+**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 ### Authentification -**Nom d'utilisateur SMTP** | (texte)
+**Nom d'utilisateur SMTP** | (texte) Généralement votre adresse e-mail complète ou un identifiant fourni par votre hébergeur. -**Mot de passe SMTP** | (mot de passe)
+**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. @@ -127,29 +138,30 @@ Après avoir configuré vos paramètres SMTP, il est **essentiel** de tester la alt="Test réussi de la connexion SMTP" sources={{ light: '/img/next_gen/settings/core/mail/mail_success.png', - dark: '/img/next_gen/settings/core/mail/mail_success_dark.png' + dark: '/img/next_gen/settings/core/mail/mail_success.png' }} /> ### 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 +- ✅ **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"**
+**"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"**
+**"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"**
+**"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. diff --git a/docs/settings/core/maintenance.md b/docs/settings/core/maintenance.md index 64a2438..a7471e7 100644 --- a/docs/settings/core/maintenance.md +++ b/docs/settings/core/maintenance.md @@ -5,23 +5,15 @@ sidebar_position: 4 import ThemedImage from '@theme/ThemedImage'; # Maintenance - -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` - - +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. +- **URL de maintenance** : L'URL pour passer outre la maintenance. +- **Texte du bouton de maintenance** : Le texte du bouton pour passer outre la maintenance. +- **URL de l'image de maintenance** : L'URL de l'image de maintenance. +- **Icone de maintenance** : L'icone de maintenance. :::tip Astuce Le mode maintenance est votre **bouclier de protection** pendant les opérations sensibles. diff --git a/docs/settings/helpdesk/departments.md b/docs/settings/helpdesk/departments.md index 7c5f0fc..9434820 100644 --- a/docs/settings/helpdesk/departments.md +++ b/docs/settings/helpdesk/departments.md @@ -1,10 +1,9 @@ --- sidebar_position: 2 --- - # Départements -Dans **CLIENTXCMS**, les **départements** constituent l'épine dorsale de l'organisation de votre centre d'aide.
+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. @@ -16,7 +15,7 @@ Vous pouvez gérer les départements depuis : ![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é**. +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. ::: @@ -40,16 +39,17 @@ C'est comme organiser un hôpital en services spécialisés 🏥 — cardiologie 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 | +| 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 @@ -57,12 +57,14 @@ Ces départements par défaut peuvent être : **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 @@ -83,29 +85,25 @@ Pour ajouter un nouveau département : ### Configuration du département -**Nom** | (texte)
+**Nom** | (texte) Le nom affiché dans l'interface client et administrateur. Utilisez un terme clair et immédiatement compréhensible. **Exemples de noms efficaces** : + - ✅ "Support Technique" plutôt que "Tech" - ✅ "Facturation & Paiements" plutôt que "Compta" - ✅ "Assistance Commerciale" plutôt que "Ventes" -**Icône** | (sélecteur d'icône)
+**Icône** | (sélecteur d'icône) Représentation visuelle du département pour une identification rapide. -**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` - -**Description** | (texte long)
+**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. **Exemple de description pour "Support Technique"** : + ``` Problèmes techniques, pannes serveur, configurations, erreurs de site, questions DNS, certificats SSL, performances et optimisations. @@ -130,37 +128,52 @@ Vous pouvez diriger automatiquement les clients vers un département via des par #### 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) | +| 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... -``` +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + + + + ``` + https://demo.clientxcms.com/client/support/create?department=1&priority=high&subject=Serveur+inaccessible + ``` + + + ``` + https://demo.clientxcms.com/client/support/create?department=2&related_id=456&subject=Question+facture + ``` + + + ``` + https://demo.clientxcms.com/client/support/create?department=4&content=Je+souhaiterais+un+devis+pour... + ``` + + + + Utilisez ces URLs pré-configurées pour : + + - **Dans vos e-mails** : insérer un lien direct contextuel vers la création d'un ticket pré-rempli. + - **Sur votre site** : boutons d'aide qui ouvrent la création de ticket avec le bon département/priorité. + - **Dans les signatures** : proposer un accès rapide au support adapté selon la nature du message. + - **Automatisation** : appels depuis des scripts ou des notifications pour ouvrir un ticket lié à un service précis. + + Astuce : encodez correctement les paramètres (espaces, caractères spéciaux) pour garantir le bon remplissage des champs. ### 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 +- **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 @@ -183,102 +196,3 @@ Chaque département peut être traduit dans toutes les langues activées : - **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 01d0110..ed64fe0 100644 --- a/docs/settings/helpdesk/helpdesk-settings.md +++ b/docs/settings/helpdesk/helpdesk-settings.md @@ -1,20 +1,13 @@ --- sidebar_position: 1 --- - # Paramètres du centre d'aide -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.
+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**. +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. ::: @@ -36,33 +29,37 @@ C'est comme régler les paramètres d'une machine industrielle ⚙️ — plus c ### Fermeture automatique -**Fermeture automatique après inactivité** | (nombre de jours)
+**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)
+**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 @@ -72,14 +69,125 @@ Permet aux clients de rouvrir leurs tickets fermés pendant une période limité Une ré-ouverture illimitée peut créer des tickets très anciens difficiles à gérer. Privilégiez un délai raisonnable. ::: +## Webhooks + +**URL du webhook** : URL de votre endpoint pour recevoir les notifications de tickets (POST JSON). Utilisez une URL en HTTPS si possible. + +- Si l'URL fournie est un webhook Discord (ex. https://discord.com/api/webhooks/xxxxx), les notifications apparaîtront automatiquement sous forme d'embed (capture ci‑dessous). + ![image](https://cdn.clientxcms.com/ressources/docs/ticket.png) +- Si vous utilisez un webhook personnalisé, CLIENTXCMS enverra une requête HTTP POST avec un payload JSON structuré. Exemple : + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + + + + +```json +{ + "payload": { + "action": "helpdesk_create", + "_url": "https://example.com/admin/helpdesk/tickets/1", + "ticketid": "1", + "customer_url": "https://example.com/admin/customers/1", + "department": "Général", + "priority": "Basse", + "subject": "Test ticket", + "message": "Bonjour, voici le contenu du ticket.", + "customername": "Martin Dev", + "customeremail": "test@clientxcms.com", + "appname": "CLIENTXCMS", + "appurl": "https://example.com/" + } +} +``` + + + + + +```json +{ + "payload": { + "action": "helpdesk_closed", + "_url": "https://example.com/admin/helpdesk/tickets/1", + "ticketid": "1", + "customer_url": "https://example.com/admin/customers/1", + "department": "Général", + "priority": "Basse", + "subject": "Test ticket", + "customername": "Martin Dev", + "customeremail": "test@clientxcms.com", + "appname": "CLIENTXCMS", + "appurl": "https://example.com/" + } +} +``` + + + + + +```json +{ + "payload": { + "action": "helpdesk_answered_staff", + "_url": "https://example.com/admin/helpdesk/tickets/1", + "ticketid": "1", + "customer_url": "https://example.com/admin/customers/1", + "department": "Général", + "priority": "Basse", + "subject": "Test ticket", + "message": "Bonjour, voici le contenu de la réponse du staff.", + "customername": "Martin Dev", + "customeremail": "test@clientxcms.com", + "appname": "CLIENTXCMS", + "appurl": "https://example.com/" + } +} +``` + + + + +```json +{ + "payload": { + "action": "helpdesk_answered_customer", + "_url": "https://example.com/admin/helpdesk/tickets/1", + "ticketid": "1", + "customer_url": "https://example.com/admin/customers/1", + "department": "Général", + "priority": "Basse", + "subject": "Test ticket", + "message": "Bonjour, voici le contenu de la réponse du client.", + "customername": "Martin Dev", + "customeremail": "test@clientxcms.com" + "appname": "CLIENTXCMS", + "appurl": "https://example.com/" + } +} +``` + + + + + +Notes utiles : + +- `action` : indique l'événement (ex. `helpdesk_create`, `helpdesk_answered_staff`, `helpdesk_answered_customer`). +- `_url` : lien interne vers l'édition du ticket +- Les valeurs sont au format chaîne. Adaptez votre traitement côté serveur selon vos besoins. + ## Gestion des pièces jointes ### Activation des fichiers -**Autoriser les pièces jointes** | (interrupteur)
+**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 @@ -87,21 +195,21 @@ Active ou désactive la possibilité pour les clients de joindre des fichiers à ### Sécurité et limitations -**Taille maximale** | (Mo)
+**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 | +| 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)
+**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` @@ -109,91 +217,89 @@ Définit quels types de fichiers sont acceptés dans les tickets. **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) +### Entreprise établie -#### 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 +``` +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 +``` -#### Configuration webhook Discord +### 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 +``` -Exemple d'intégration avec Discord : +### 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 +``` -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 +## Optimisation des performances -#### Format des notifications +### Surveillance des métriques -Les notifications incluent : -```json -{ - "ticket_id": 123, - "subject": "Problème de connexion", - "department": "Technique", - "priority": "high", - "client": "john@example.com", - "status": "open" -} -``` +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 -### Intégrations populaires +### Maintenance préventive -**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 +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 -## Exemples de configuration +:::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. +::: -### 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 @@ -203,6 +309,7 @@ Webhook : Système CRM ``` ### Support technique spécialisé + ``` Fermeture automatique : 14 jours Ré-ouverture : -1 (illimitée) @@ -212,6 +319,7 @@ Webhook : Slack + monitoring ``` ### Organisation sécurisée + ``` Fermeture automatique : 5 jours Ré-ouverture : 0 (désactivée) @@ -225,6 +333,7 @@ Webhook : Système audit interne ### Surveillance des métriques 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 diff --git a/docs/settings/helpdesk/helpdesk.md b/docs/settings/helpdesk/helpdesk.md index 591941d..8dfd5e5 100644 --- a/docs/settings/helpdesk/helpdesk.md +++ b/docs/settings/helpdesk/helpdesk.md @@ -2,7 +2,7 @@ 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**.
+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. @@ -12,7 +12,7 @@ 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**. +Un support client efficace est la **clé de la fidélisation**. Chaque ticket résolu rapidement et professionnellement renforce la confiance de vos clients. ::: @@ -30,124 +30,6 @@ Un système de support structuré vous permet de : 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 b4a81b0..80a3d28 100644 --- a/docs/settings/personalization/bottom_menu.md +++ b/docs/settings/personalization/bottom_menu.md @@ -10,246 +10,3 @@ Vous pouvez personnaliser le pied de page depuis : `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 `