Système de réservation de clients WordPress

Documentation CC Système de réservation de clients WordPress

1. Introduction
2. Installation et exigences du système
3. Activation de la licence
4. Panel de gestion
5. Gestion des clients
6. Gestion des services
7. Système de réservation
8. Calendrier de réservation
9. Blocage du temps
10. Système de pourboire
11. Statistiques et rapports
12. Importer des clients à partir d'un fichier CSV
13. Formulaire de réservation au recto
14. Personnalisation de l'apparence
15. Notifications par courrier électronique
16. Paramètres avancés
17. Résolution de problèmes
18. FAQ

1. Introduction

• Calendrier de réservation avancé avec intégration de FullCalendar 6.1
• Gestion complète des clients avec historique des visites
• Système de services avec prix, remises et durée
• Blocage de plages horaires (vacances, pauses)
• Système de pourboire pour chaque réservation
• Statistiques et rapports financiers détaillés
• Importation de clients à partir de fichiers CSV
• Formulaire de réservation pour les clients sur la page d'accueil du site web
• Calendrier public avec les dates d'activité
• Notifications automatiques par courrier électronique
• Couleurs d'interface personnalisées
• Multidevise et paramètres flexibles
• Système de gestion des licences

2. l'installation et les exigences du système

• WordPress 5.0 ou supérieur
• PHP 7.4 ou supérieur
• Base de données MySQL 5.6 ou supérieure
• Permission de créer des types d'articles personnalisés
• Possibilité d'envoyer des courriels via WordPress (optionnel)

1. Télécharger le fichier ZIP du plug-in depuis le site officiel cocos.codes
2. Se connecter au panneau d'administration de WordPress
3. Aller à : Plugins → Ajouter un nouveau → Télécharger le plugin sur le serveur
4. Sélectionnez le fichier ZIP téléchargé et cliquez sur "Installer maintenant"
5. Une fois l'installation terminée, cliquez sur "Activer le plug-in"
6. Le plug-in enregistrera automatiquement les Custom Post Types (réservations, clients, services).
7. Un nouveau menu "Réservations" sera créé dans le tableau de bord de WordPress.
8. Allez dans Réservations → Paramètres pour configurer le plug-in

3. Activation de la licence

1. Après l'installation, allez dans Réservations → Paramètres
2. Sélectionnez l'onglet "Licence
3. Saisir la clé de licence reçue après l'achat
4. Cliquez sur "Activer la licence"
5. Une fois l'activation réussie, un message de confirmation s'affiche
6. Toutes les fonctions du plug-in seront déverrouillées.

4 Panneau de gestion

• Panneau principal - aperçu des statistiques clés et des réservations à venir
• Calendrier - calendrier interactif de toutes les réservations et de tous les blocs horaires
• Réservations - liste filtrable et modifiable de toutes les réservations
• Clients - la gestion de la base de clients avec l'historique des visites
• Services - catalogue de services avec prix et remises
• Statistiques - des rapports et analyses financiers détaillés
• Importations de clients - Importation en masse de données clients à partir de fichiers CSV
• Paramètres - la configuration de toutes les fonctions du plug-in

• Paramètres - configuration des heures de fonctionnement, des devises, des couleurs et des notifications
• Documentation - lien vers le manuel complet en ligne
• Licence - gestion des licences des plug-ins
• Plug-ins - des informations sur d'autres produits COCOS
• Soutien - l'accès à l'assistance technique

5. gestion des clients

• Nom - le nom complet du client (affiché comme titre de l'entrée)
• Numéro de téléphone - contact téléphonique (utilisé pour détecter les doublons)
• Adresse électronique - utilisé pour les notifications (facultatif)
• Notes - des informations supplémentaires sur le client (préférences, allergies, commentaires)
• Historique des visites - liste générée automatiquement de toutes les réservations

1. Aller dans Réservations → Clients → Ajouter un client
2. Saisissez votre nom dans le champ du titre
3. Complétez vos coordonnées (le téléphone est obligatoire)
4. Ajouter des notes si nécessaire
5. Cliquez sur "Publier"

• Lors de la modification d'un client, un tableau de toutes ses réservations s'affiche.
• Informations sur la date, l'heure, le service et le statut de chaque visite
• Indication de la prise en charge de la visite
• Lien direct pour modifier une réservation

6 Gestion des services

• Nom du service - affiché sur les formulaires et les factures
• Description - description détaillée du service (facultatif)
• Durée de l'accord - en minutes (par exemple 30, 45, 60, 90, 120)
• Prix - le prix de base du service dans la devise choisie
• Type de réduction - pourcentage (%) ou montant fixe
• Valeur du rabais - l'importance de la réduction en fonction du type

1. Aller dans Réservations → Services → Ajouter un service
2. Saisissez le nom du service dans le champ "Titre".
3. Possibilité d'ajouter une description dans l'éditeur de contenu
4. Complétez les détails du service : durée et prix
5. Fixer une remise si elle est offerte
6. Cliquez sur "Publier"

• Nom du service - nom avec lien pour l'éditer
• Durée de l'accord - affiché en minutes (par exemple "45 min")
• Prix - prix formaté avec la devise (par exemple "80.00 PLN")
• Remise - le type et la valeur de la remise ou "-" s'il n'y en a pas
• Date - ajout de la date de service

7 Système de réservation

• Client - sélection dans la base de données clients (avec moteur de recherche AJAX)
• Service - sélection dans le catalogue des services
• Date - jour de réservation
• Heure de début - date de début de service
• Statut - prévu / terminé / annulé
• Payé - si la visite a été payée
• Conseil - montant supplémentaire du client (facultatif)
• Notes - informations complémentaires sur les réservations

1. Aller dans Réservations → Réservations → Ajouter une réservation
2. Rechercher et sélectionner un client (saisir le prénom, le nom ou le téléphone)
3. Sélectionnez un service dans la liste déroulante
4. Fixer la date et l'heure de la réservation
5. Sélectionner le statut (par défaut "programmé")
6. Ajouter éventuellement un conseil et des notes
7. Cliquez sur "Publier"

• Changement de statut - cliquez sur le menu déroulant de la colonne "Statut".
• Marquage des paiements - cliquez sur l'icône de la coche dans la colonne "Payé".
• Les modifications sont sauvegardées automatiquement via AJAX
• Un rouleau s'affiche lors de l'enregistrement.

• Titre - généré automatiquement : "Réservation - [Client] - [Service]".
• Client - nom avec lien vers la carte de client
• Service - nom du service avec lien pour l'éditer
• Date de la visite - la date et l'heure au format des paramètres
• Statut - menu déroulant pour des changements rapides
• Payé - Icône OUI/NON avec possibilité de changement rapide

8 Calendrier de réservation

• Différents points de vue - mois, semaine, 3 jours, un seul jour
• Activités de coloriage - par statut de réservation
• Cliquer sur une réservation - déplacer vers l'édition
• Cliquez sur la date - création d'une nouvelle réservation avec une date prédéfinie
• L'indicateur "maintenant - ligne rouge indiquant l'heure actuelle
• Réactivité - adaptation automatique aux appareils mobiles
• Localisation - traduction automatique dans la langue de WordPress

• Bleu - réservations programmées (#007bff)
• Vert - Réservations terminées (#28a745)
• Rouge - Réservations annulées (#dc3545)
• Gris - serrures à temps (#6c757d)

1. Aller à Réservations → Calendrier
2. Sélectionnez votre vue préférée (mois/semaine/jour)
3. Utilisez les boutons "précédent/suivant" pour naviguer.
4. Cliquez sur "Aujourd'hui" pour revenir à la date du jour.
5. Cliquez sur une réservation pour la modifier
6. Cliquez sur une date libre pour ajouter une nouvelle réservation

• Le calendrier s'adapte automatiquement aux heures de travail à partir des paramètres
• Affichage par défaut de l'heure de début à l'heure de fin
• Le créneau "toute la journée" est désactivé
• Toutes les heures sont affichées au format 24 heures (HH:mm).

9. blocage du temps

• Un type spécial de réservation marqué "Time lock" (verrouillage du temps)
• Aucune sélection de clients ou de services n'est nécessaire
• Nécessite une heure de début et de fin
• Affiché en gris dans le calendrier avec l'icône 🚫.
• Non inclus dans les statistiques financières
• Empêche la création de réservations normales à des périodes bloquées

1. Aller dans Réservations → Réservations → Ajouter une réservation
2. Cochez la case "🚫 Time lock" en haut du formulaire.
3. Les champs Client et Service seront automatiquement masqués
4. Fixer la date de verrouillage
5. Spécifier l'heure de début (obligatoire)
6. Spécifier l'heure de fin (obligatoire pour les blocages)
7. Vous pouvez également ajouter un titre et des notes (par exemple, "Vacances", "Pause technique").
8. Cliquez sur "Publier"

• Dans la liste des réservations - la colonne "Client" affiche "🚫 Time lock".
• Dans le calendrier - champ gris avec le texte "🚫 Time lock" + titre facultatif
• Au recto - affiché comme "Occupé" (pas de détails)
• Durée - affiché comme "date HH:mm - HH:mm".

10. Système de basculement

• Champ pour les pourboires dans chaque réservation (facultatif)
• Ajout automatique au prix final de la réservation
• Statistiques distinctes sur les pourboires dans le tableau de bord
• Classement des clients les plus généreux
• Inclusion dans les rapports financiers
• Suivi du pourboire moyen par client

1. Ouvrir l'enregistrement pour l'éditer
2. Trouvez le champ "Tip (PLN) :" dans la section paiement.
3. Saisissez le montant du pourboire (par exemple 10,00).
4. Le pourboire sera automatiquement ajouté au prix final.
5. Enregistrer une réservation

Prix final = (prix du service - réduction) + pourboire
Exemple :
Service : 100 PLN
Remise 10% : -10 PLN
Pourboire : 15 PLN
Prix final : 105 PLN

• Tableau de bord - tuile avec le total des pourboires pour le mois en cours
• Les clients les plus généreux - classement avec les pourboires totaux et moyens
• Statistiques - rapports détaillés sur les pourboires par période
• Les revenus - les pourboires inclus dans les rapports sur les recettes

11 Statistiques et rapports

• Les revenus de ce mois-ci - recettes totales provenant des visites achevées
• Nombre de réservations - toutes les réservations du mois en cours
• Payé - total des réservations payées
• A payer - total des réservations impayées
• Conseils ce mois-ci - séparer le montant du pourboire

• Formulaire de filtrage - sélection de la plage de dates pour l'analyse
• Comparaison avec la période précédente - variation en pourcentage des bénéfices et des réservations
• Taux d'annulation - pourcentage d'annulations
• Prévisions de recettes - recettes attendues des visites programmées
• Remplissage aujourd'hui - pourcentage de créneaux horaires occupés
• Durée moyenne entre les visites - analyse des taux de retour des clients

• Visualisation des revenus pour chaque mois de l'année en cours
• Division en payé (vert) et à payer (jaune)
• Diagramme à barres interactif avec valeurs
• Noms de mois abrégés pour une meilleure lisibilité

• Graphique de la popularité de chaque heure de la journée (0-23)
• Identification des pics et des creux d'occupation
• Aide à l'optimisation des horaires de travail
• Visualisation sous forme de diagramme à barres

• Comparaison des revenus pour chaque jour (lun-sam)
• Nombre de réservations pour chaque jour
• Identifier les meilleurs et les pires jours
• Aide à la planification de l'emploi du temps

• Classement des clients en fonction du nombre d'annulations
• Pourcentage d'annulations par rapport à l'ensemble des réservations
• Coloration : >30% rouge, autres gris
• Aide à l'identification des clients problématiques

• Top 10 des services par nombre de réservations
• Prix unitaire de chaque service
• Lien vers la modification du service
• Numérotation de 1 à 10

• Classement des services par recettes totales
• Nombre de représentations de chaque service
• Prix unitaire et recettes totales
• Aider à identifier les services les plus rentables

• 5 visites programmées à venir
• Date, client et service
• Tri chronologique
• Lien pour modifier une réservation

• Montant total perdu sur les rabais
• Nombre de remises accordées
• Analyse de l'efficacité du système de rabais

• Bouton d'exportation en haut de la page des statistiques
• Génération d'un fichier CSV avec toutes les réservations de la période sélectionnée
• Colonnes : Date, Heure, Client, Service, Prix, Remise, Pourboire, Prix final, Statut, Payé.
• Encodage UTF-8 avec BOM pour les caractères polonais
• Nom du fichier : statistics-reservations-[data].csv

12. importer des clients à partir d'un fichier CSV

• Séparateur - virgule (,)
• Codage - UTF-8
• Première ligne - les titres des colonnes (seront omis)
• Taille maximale - 2MB

1. Nom - requis
2. Nom - requis
3. Téléphone - requis (utilisé pour détecter les doublons)
4. Courriel - facultatif
5. Notes - facultatif

Prénom, Nom, Téléphone, Email, Notes
Jan,Kowalski,+48500100200,[email protected],Stały client
Anna,Nowak,+48600200300,[email protected],Preferuje après-midi
Piotr,Wiśniewski,+48700300400,,

1. Aller dans Réservations → Importer des clients
2. Lire les instructions et les exigences
3. Préparer le fichier CSV selon le format
4. Cliquez sur "Select CSV file" et sélectionnez le fichier.
5. Cliquez sur "🚀 Importer des clients".
6. Attendre la fin de l'importation
7. Lire le rapport des résultats

• Vérification du type de fichier - uniquement text/csv et text/plain
• Validation des données - les champs obligatoires ne doivent pas être vides
• Détection des doublons - sur la base d'un numéro de téléphone
• Assainissement des données - nettoyage de toutes les valeurs d'entrée

• Importé - nombre de clients ajoutés avec succès
• Omis - nombre d'enregistrements rejetés
• Détails des erreurs - un maximum des 10 premières erreurs
• Raisons de l'omission - données manquantes, doublons, erreurs d'enregistrement

• Sauvegarder la base de données avant toute importation importante
• Tester l'importation sur un petit échantillon de données (5-10 enregistrements)
• Veiller à ce que les numéros de téléphone soient présentés de manière cohérente
• Vérifier l'encodage du fichier (doit être UTF-8)
• Supprimer les lignes vides d'un fichier CSV
• Les importations importantes (>100 enregistrements) peuvent prendre plusieurs minutes.

13. Formulaire de réservation au recto

• Nom - obligatoire, texte
• Nom - obligatoire, texte
• Numéro de téléphone - obligatoire, tel champ avec placeholder
• Courriel - optionnel, validation du courrier électronique
• Sélectionner un service - obligatoire, liste déroulante avec les prix
• Date de la visite - obligatoire, champ de date (min : aujourd'hui)
• Heure de la visite - requis, sélectionner avec les heures de travail

• Nonce WordPress - Protection CSRF
• Validation côté serveur - vérification de tous les champs
• Vérifier la disponibilité - si la date est déjà prise
• Validation de l'intervalle - si l'heure correspond aux intervalles définis
• Détection des réservations qui se chevauchent - en tenant compte de la durée des services

1. Créer un nouveau site WordPress (Sites → Ajouter un nouveau)
2. Appelez-le, par exemple, "Réservation en ligne".
3. Dans l'éditeur, collez le shortcode : [cc_reservation_form]
4. Il est possible de modifier le titre : [cc_reservation_form title="Make an appointment"].
5. Publier la page
6. Copiez le lien et ajoutez-le au menu de votre site web

1. Le client remplit le formulaire
2. Après avoir cliqué sur "Prendre un rendez-vous", la validation a lieu
3. Le système vérifie si le client existe déjà (par numéro de téléphone).
4. Si ce n'est pas le cas, il crée automatiquement un nouveau client
5. La disponibilité de la date sélectionnée est vérifiée
6. Une nouvelle réservation est créée avec le statut "Programmée"
7. Les notifications par courriel sont envoyées (si elles sont activées)
8. Le client voit le message de confirmation

• Succès - La réservation a été acceptée ! La confirmation a été envoyée à votre adresse électronique."
• Date d'entrée en vigueur - Cette date est déjà prise. Veuillez choisir une autre date."
• Erreur de données - "Remplir tous les champs obligatoires".
• Erreur d'enregistrement - Échec de l'enregistrement de la réservation. Essayez à nouveau."

• Tous les rendez-vous occupés sont affichés comme étant "occupés".
• N'affiche pas les détails de la réservation (confidentialité)
• Les visites annulées sont cachées
• Localisation automatique (langue WordPress)
• Conception adaptée
• Vues : mois, semaine, jour

14. personnalisation de l'apparence

• Couleur dominante - la couleur principale utilisée dans l'interface
• Palettes prédéfinies - 8 schémas de couleurs prédéfinis
• Vue en direct - visualisation immédiate des changements
• Ombres automatiques - le système génère un survol des couleurs (-30 de luminosité)

• Formulaire de réservation - boutons, titres, focus de saisie
• Calendrier - boutons de navigation, date du jour, affichage de l'heure
• Boutons - arrière-plan, survol, actif, focus
• Entrées - bordure au centre, bord gauche des champs obligatoires
• A la une - bord inférieur (border-bottom)

1. Aller dans Réservations → Paramètres
2. Trouver la section "Frontend appearance
3. Cliquer dans la boîte de couleurs ou sélectionner dans la palette
4. Utiliser les boutons "Sélection rapide des couleurs" pour les palettes prédéfinies
5. Vérifier la prévisualisation en direct (exemple de bouton, d'en-tête, d'entrée)
6. Sauvegarder vos paramètres

• Exemple de bouton - couleur d'arrière-plan, plus sombre au survol
• Exemple de titre - bord inférieur en couleur de tête
• Champ de saisie - cadre de mise au point en couleur principale
• Interactivité - survol du bouton, focus sur l'entrée

// fonction adjust_color_brightness dans Plugin.php
public static function adjust_color_brightness($hex, $steps) {
    // Conversion de HEX en RGB
    // Ajout/soustraction de $steps à chaque composant
    // Conversion en HEX
    // Renvoi de la couleur plus foncée/plus claire
}

• Les styles s'adaptent automatiquement aux préférences de l'utilisateur
• Utilisation de la requête média : @media (prefers-color-scheme : dark)
• La couleur guide fonctionne à la fois en mode clair et en mode foncé

15. notifications par courrier électronique

• Confirmation pour le client - email après une réservation réussie depuis le front
• Notification à l'administrateur - nouvelles informations sur les réservations
• Envoi automatique - pour les réservations en amont uniquement
• Réservations manuelles - sans notifications automatiques

Objet : Confirmation de réservation - [Nom du site].
Bonjour [Nom du client] !
Votre réservation a été confirmée.
Détails :

Service : [Nom du service].
Date : [Date de réservation].
Heure : [Heure].

Rendez-vous sur place !
[Nom du site]

Objet : Nouvelle réservation - [Nom du client].
[Même contenu que pour le client].

1. Aller dans Réservations → Paramètres
2. Trouvez la section "Notifications
3. Cochez la case "Envoyer des notifications par courrier électronique pour les réservations"
4. Saisir l'adresse électronique de l'administrateur (par défaut : admin_email WordPress)
5. Sauvegarder vos paramètres

• WordPress doit avoir la fonction configurée wp_mail()
• Le serveur doit être en mesure d'envoyer des courriers électroniques
• Le client doit saisir une adresse électronique valide dans le formulaire.
• Pour une livraison plus fiable, nous recommandons un plug-in SMTP (par exemple WP Mail SMTP).

• Le courrier électronique n'arrive pas - vérifier le spam, configurer le SMTP
• Mauvais expéditeur - WordPress utilise [email protected]
• Pas d'email client - le champ email est facultatif, assurez-vous qu'il est rempli
• Fonction désactivée - cochez la case dans les paramètres de notification

16. paramètres avancés

• Monnaie - PLN, EUR, USD, GBP
• Position de change - avant ou après le quota
• Format de la date - par exemple d.m.Y (31.12.2025), Y-m-d (2025-12-31)
• Format de l'heure - H:i (24h) ou h:i A (12h avec AM/PM)

• Heure de début - début de la journée de travail (par défaut : 08:00)
• Heure de fermeture - fin de la journée de travail (par défaut : 18:00)
• Intervalle de réservation - le nombre de minutes pendant lesquelles il est possible de réserver (par exemple 15, 30, 45, 60)

• Couleur dominante - la couleur principale de l'interface (voir chapitre 14 pour plus de détails)
• Palettes prédéfinies - 8 schémas de couleurs prédéfinis
• Vue en direct - visualisation interactive des changements

• Réservations depuis le front - activer/désactiver le formulaire sur la page
• Vue du calendrier - mois / semaine / jour

• Notifications par courrier électronique - courriels automatiques après la réservation
• Courriel de l'administrateur - adresse pour les notifications (par défaut admin_email WP)
• Notifications par SMS - fonction en préparation (non active)

• Permettre l'ajout de données d'échantillonnage - données automatiques lors de l'activation
• 3 exemples de clients
• 4 exemples de services
• 5 échantillons de réservations (futures et historiques)

• Un tableau avec tous les shortcodes affichés dans les paramètres
• Description de chaque shortcode et de ses paramètres
• Exemples d'utilisation
• Bouton "Copier" vers le presse-papiers pour chaque shortcode

// Les paramètres sont traités par :
admin_post_cc_wp_cr_save_settings
// Et sauvegardés dans les options de WordPress :
cc_wp_cr_options (tableau de tous les réglages)
// Accès aux réglages dans le code :
$plugin->get_option('currency') ; // option unique
$plugin->get_all_options() ; // toutes les options

17. résolution de problèmes

1. Vérifiez si vous disposez d'une licence active (Paramètres → Licence)
2. Assurez-vous d'être connecté en tant qu'administrateur
3. Vérifier les droits d'écriture de la base de données
4. Désactiver le cache de WordPress et les plugins de cache
5. Vérifier les journaux d'erreurs PHP (WP_DEBUG = true)
6. S'assurer que la nonce passe la validation

1. Vérifier s'il y a des réservations dans le système
2. S'assurer que les réservations ont une date et une heure fixes
3. Vérifier si la console du navigateur contient des erreurs JavaScript
4. Vérifier que FullCalendar a été chargé (vérifier les sources de la page)
5. Vider le cache du navigateur et le cache des plug-ins
6. Vérifier que le point de terminaison AJAX fonctionne (admin-ajax.php)

1. Assurez-vous que la fonction est activée dans les paramètres
2. Vérifier que le shortcode est collé correctement
3. Vérifier les erreurs JavaScript dans la console du navigateur
4. S'assurer que le script reservation-form-frontend.js a été chargé
5. Vérifier que le nonce est généré correctement
6. Désactiver d'autres plug-ins pour la détection des conflits

1. Vérifier si la fonction est activée dans les paramètres
2. S'assurer que le client a saisi un courriel dans le formulaire
3. Vérifiez votre dossier spam
4. Vérifier la configuration de wp_mail() (test mailing)
5. Installer un plug-in SMTP (par exemple WP Mail SMTP)
6. Vérifier les journaux du serveur de messagerie

1. Vérifier le format du fichier (séparateur : virgule, encodage : UTF-8)
2. Veillez à ce que la première ligne corresponde aux en-têtes
3. Vérifiez que toutes les colonnes requises sont remplies
4. Vérifier l'exactitude des numéros de téléphone
5. Supprimer les lignes vides du fichier
6. Test sur un petit échantillon (5-10 enregistrements)

1. Vérifier que les réservations ont le bon statut ("Terminé" pour les statistiques)
2. S'assurer que les services ont des prix attribués
3. Vérifier les dates de réservation (si elles correspondent à la période filtrée)
4. Vérifier que les remises sont calculées correctement
5. Reconstruire le cache des statistiques (désactiver/activer le plug-in)

1. Assurez-vous que la case "Time lock" est cochée.
2. Vérifier que l'heure de fermeture est indiquée
3. Vérifier que les horaires ne se chevauchent pas avec d'autres réservations.
4. Vérifier que le JavaScript qui permet de masquer les champs fonctionne
5. Vider le cache du navigateur

1. Veillez à cliquer sur "Enregistrer les paramètres".
2. Effacer le cache de WordPress et les plugins de cache
3. Vider le cache du navigateur (Ctrl+F5 ou Cmd+Shift+R)
4. Vérifier que les styles en ligne sont générés dans le code source
5. Vérifiez que vous utilisez la dernière version du plug-in

18. LES FAQ