CC Demande de documentation Produit
Documentation complète pour le module de demande de renseignements sur les produits pour PrestaShop (cc_ps_product_question) avec des fonctions de sécurité avancées, un style et une gestion détaillée des formulaires de demande de renseignements.Table des matières
- Introduction
- Installation
- Activation de la licence
- Panel de gestion
- Paramètres généraux
- Apparence et emplacement
- Style des boutons
- Style modal
- Paramètres du formulaire
- Configuration du courrier électronique
- Système de sécurité
- Gestion des questions
- Résolution de problèmes
- FAQ
1. Introduction
CC Ask Product est un module avancé qui permet aux clients de poser des questions directement sur la page du produit. Le module offre une interface intuitive qui augmente l'engagement des clients et les aide à prendre des décisions d'achat grâce à une communication facile avec le personnel du magasin.Fonctions du module principal :
- Formulaire de question directement sur la page du produit
- Stylisation complète des boutons et des fenêtres modales
- Champs de formulaire flexibles (nom, e-mail, téléphone, message)
- Système de sécurité avancé
- Modèles d'e-mails multilingues
- Gestion des questions dans le panneau d'administration
- Multiples crochets pour le positionnement
- Protection contre les spams et les bots
2. installation
Exigences du système- PrestaShop 1.7.0.0 ou plus récent
- PHP 7.2 ou version ultérieure
- MySQL 5.6 ou plus récent
- Permission d'installer des modules
- 256 Mo de RAM au minimum (512 Mo recommandés)
- Télécharger le fichier ZIP du module depuis la boutique officielle cocos.codes
- Se connecter au panneau d'administration de PrestaShop
- Allez dans : Modules > Gestionnaire de modules > Ajouter un nouveau module
- Cliquez sur "Ajouter un module" et sélectionnez le fichier ZIP téléchargé.
- Une fois l'installation terminée, cliquez sur "Configurer"
Info
Après l'installation, le module créera automatiquement les tables de base de données nécessaires, les répertoires pour les courriels et définira la configuration par défaut. Il sera nécessaire de configurer le module et d'activer la licence avant de pouvoir utiliser toutes les fonctions.
3. Activation de la licence
Avant de pouvoir utiliser toutes les fonctionnalités du module, il est nécessaire d'activer la licence :- Après l'installation, procéder à la configuration du module
- Sélectionnez l'onglet "Licence
- Saisir la clé de licence reçue après l'achat
- Cliquez sur "Activer la licence"
- Une fois l'activation réussie, un message de confirmation s'affiche et toutes les fonctions du module sont déverrouillées.
Avertissement
Sans licence active, le module fonctionnera en mode restreint - le formulaire fonctionnera, mais les courriels ne seront pas envoyés et un message indiquant que la licence est inactive sera affiché en haut du panneau d'administration.
4 Panneau de gestion
Le panneau de gestion du module se compose de plusieurs onglets qui permettent une configuration et une gestion complètes :Principaux onglets :
- Configuration - paramètres, style et formulaire du module principal
- Questions - liste gérable de toutes les questions reçues
- Documentation - lien vers la documentation en ligne
- Soutien - lien vers la page d'assistance
- Plug-ins - extensions supplémentaires de COCOS
- Licence - gestion des licences de modules
5. paramètres généraux
Dans la section des paramètres généraux, vous trouverez les options de base qui contrôlent le fonctionnement du module :| Paramètres | Description | Valeur par défaut |
| Mise sous tension du module | Activation/désactivation globale du module | Sur |
- Sur - le questionnaire est visible sur toutes les pages du produit
- Arrêt - le formulaire n'est affiché sur aucune page de produit
Conseil
Cet interrupteur permet d'éteindre rapidement le module sans le désinstaller, par exemple lors d'un entretien ou d'un test en atelier.
6 Apparence et emplacement
Cette section permet de contrôler entièrement l'apparence et le positionnement du bouton de la question :Étiquette du bouton
Champ multilingue permettant de définir des textes de boutons différents pour chaque langue active dans la boutique. Valeur par défaut : "Demander ce produit".
Position du bouton
Le module offre plusieurs choix de crochets pour le placement des boutons :
| Crochet | Description de l'article | Utilisation recommandée |
| afficherlesinformationscomplémentairessurlesproduits | Sous les informations sur les produits | L'article le plus populaire |
| boutons d'affichage des produits | A côté du bouton "Ajouter au panier | Un engagement élevé de la part des clients |
| displayAfterProductThumbs | Après les vignettes des produits | Lorsqu'il y a peu de place dans la section principale |
| displayHeader (en-tête d'affichage) | Dans l'en-tête de la page | Toujours visible |
| afficher le pied de page | Dans le pied de page | Position secondaire |
| displayCustomProductQuestion | Crochet personnalisé | Nécessite la modification du thème |
Note
Le changement de position désenregistre automatiquement le module des anciens crochets et l'enregistre dans le nouveau. Un crochet personnalisé nécessite l'ajout d'un callout à l'endroit approprié dans le thème.
7. style du bouton
Le module offre un contrôle total sur l'apparence du bouton sans avoir à modifier le CSS :Couleurs des boutons
- Couleur de fond - couleur principale du bouton (par défaut : #007bff)
- Couleur du texte - couleur de l'inscription sur le bouton (par défaut : #ffffff)
- Couleur après le survol - couleur d'arrière-plan au survol (par défaut : #0056b3)
- Couleur de la bordure - couleur du cadre du bouton (par défaut : #007bff)
- Epaisseur du cadre - largeur de la bordure en pixels (0 = pas de bordure)
- Arrondi d'angle - rayon d'arrondi en pixels
- Rembourrage - l'espacement interne au format CSS (par exemple "10px 20px")
- Taille de la police - choix parmi des tailles prédéfinies (12px-20px)
- Epaisseur de la police - de Léger (300) à Gras (700)
- Icône - icône de question facultative à côté du texte
Conseil
Tous les styles sont appliqués avec le drapeau !important, ce qui garantit qu'ils fonctionnent quel que soit le thème. Vous pouvez prévisualiser les changements en direct après avoir enregistré vos paramètres.
8 Style modal
Contrôle tout aussi détaillé de l'apparence du dialogue du formulaire :Couleurs modales
- Arrière-plan de l'en-tête - couleur d'arrière-plan de la section supérieure (par défaut : #f8f9fa)
- Texte de l'en-tête - couleur du titre de la fenêtre modale (par défaut : #495057)
- Fond modal - fond principal du formulaire (par défaut : #ffffff)
- Couleur de la bordure - cadre modal entier (par défaut : #dee2e6)
- Arrondi d'angle - le rayon de courbure de l'ensemble du modal
- Largeur maximale - en px, %, vw (par défaut : 600px)
- Couleur de fond - la couleur de l'arrière-plan translucide derrière la fenêtre modale
- Transparence - 0% (invisible) à 100% (opaque)
9. paramètres du formulaire
La configuration flexible des champs du formulaire permet de l'adapter aux besoins du magasin :Configuration des champs de contact
Chaque champ a deux options : visibilité et exigence
| Champ d'application | Options de configuration | Paramètres par défaut |
| Nom | Afficher le champ / Champ obligatoire | Visible et obligatoire |
| Courrier électronique | Afficher le champ / Champ obligatoire | Visible et obligatoire |
| Téléphone | Afficher le champ / Champ obligatoire | Visible mais non obligatoire |
| Message | Afficher le champ / Champ obligatoire | Visible et obligatoire |
- Variantes de produits - afficher une liste des combinaisons de produits disponibles
- Message de bienvenue - texte affiché en haut du formulaire
Le module vérifie automatiquement :
- Correction du format de l'e-mail
- Exactitude du numéro de téléphone
- Présence d'au moins une information de contact
- Longueur maximale des champs (1000 caractères pour un message)
- Protection contre les XSS et les injections
Avertissement
Si vous désactivez tous les champs de contact ou les définissez comme non obligatoires, les clients peuvent envoyer des questions anonymes. Nous vous recommandons de laisser au moins le courriel comme champ obligatoire.
10. configuration du courrier électronique
Système complet d'envoi de notifications par courrier électronique à l'administrateur et aux clients :Paramètres de base
- Courriel de l'administrateur - l'adresse du destinataire des questions (par défaut : shop e-mail)
- Copie au client - l'envoi d'un accusé de réception à l'auteur de la demande
- Informations complémentaires - pied de page de l'e-mail avec les informations de contact
Le module offre un système de modèles flexible :
- Modèle par défaut - conception du message standard
- Modèles personnalisés - possibilité de créer ses propres modèles
- Aperçu du modèle - possibilité de prévisualisation avant utilisation
{nom_du_client} - nom_du_client
{customer_email} - email du client
{customer_phone} - téléphone du client
{nom_du_produit} - nom_du_produit
{product_url} - lien du produit
{message} le contenu de la question
{date} - date d'envoi
{shop_name} - nom de la boutique
{email_footer} - informations complémentaires
{customer_ip} - Adresse IP (uniquement pour l'administrateur)
Note
Les modèles d'e-mails sont créés automatiquement pour toutes les langues actives lors de l'installation. Vous pouvez les modifier dans le dossier /modules/cc_ps_product_question/mails/.
11. Système de sécurité
Le module comprend des mécanismes de protection avancés contre les spams et les attaques :Protection des pots de miel
Un champ caché invisible pour les utilisateurs mais rempli par les robots. S'il est rempli, le formulaire est rejeté.
Limitation de fréquence
- Temps de blocage - fenêtre de limitation de temps (par défaut : 60 secondes)
- Nombre maximum - nombre autorisé de questions d'une IP (par défaut : 3)
- Durée minimale - le plus petit temps de remplissage (par défaut : 3 secondes)
- Durée maximale - délai d'expiration du formulaire (par défaut : 30 minutes)
Trois types de vérification sont disponibles :
| Type de CAPTCHA | Description | Exigences |
| Question simple | Action mathématique (par exemple, 5 + 3 = ?) | Non |
| Graphique | Image avec code à transcrire | Extension GD |
| Google reCAPTCHA | Vérification externe de Google | Clés API |
Liste noire d'adresses IP
Possibilité de bloquer des adresses IP spécifiques. Liste séparée par des virgules, compatible avec IPv4 et IPv6.
Enregistrement des données de sécurité
Toute activité suspecte est enregistrée dans le journal des erreurs du serveur avec des informations :
- Adresse IP de l'attaquant
- Type de tentative d'infraction
- Heure de l'attaque
- Données contextuelles supplémentaires
Conseil
Nous recommandons au moins d'activer la protection Honeypot et la restriction de fréquence. N'utilisez le CAPTCHA que pour les grandes quantités de spam.
12 Gestion des questions
L'onglet "Questions" offre un panel complet pour gérer les questions reçues :Liste des questions
Tableau avec toutes les questions incluses :
- Question ID - identifiant unique
- Date d'envoi - date de création de la question
- Données sur les clients - nom, e-mail, téléphone et adresse IP
- Nom du produit - le produit sur lequel porte votre question
- Contenu de la question - message complet du client
- Actions - opérations sur la question
- Pagination - divisé en pages (20 questions par page)
- Liens de contact - adresses électroniques et téléphones cliquables
- Aperçu de l'IP - lien pour vérifier l'emplacement de l'IP
- Retrait unique - suppression des questions sélectionnées
- Suppression de tous les - nettoyage de toute la liste
Le panneau affiche automatiquement des informations utiles :
- Le nombre total de questions dans le système
- Aucune question n'est posée
- Messages d'erreur de la base de données
Avertissement
La suppression de questions est irréversible. Assurez-vous d'avoir répondu à vos clients avant de supprimer leurs questions. La fonction "Supprimer tout" efface la totalité de la base de données des questions.
13 Dépannage
Le bouton n'apparaît pas sur la page du produit- Vérifier si le module est activé dans les paramètres généraux
- S'assurer que la licence est active
- Vérifier que le crochet sélectionné est pris en charge par le modèle
- Vider le cache de PrestaShop
- Vérifier s'il y a des conflits avec d'autres modules
- Vérifier si la console du navigateur contient des erreurs JavaScript
- Assurez-vous que l'URL AJAX est correcte
- Vérifier les autorisations de la base de données
- Désactiver temporairement le CAPTCHA et la sécurité
- Vérifier que la table cc_product_question existe
- Vérifier la configuration de l'email dans PrestaShop
- S'assurer que l'adresse de l'administrateur est correcte
- Vérifiez votre dossier spam
- Tester l'envoi de courriers électroniques à partir d'autres modules
- Vérifier les journaux du serveur pour les erreurs de Mail::Send
- Vérifier que l'adresse IP du client n'est pas sur liste noire
- Veiller à ce que les délais de remplissage soient réalistes
- Désactiver le CAPTCHA s'il pose problème
- Vérifier que le champ Honeypot n'est pas visible
- Vérifier les clés reCAPTCHA si vous utilisez Google
- Vérifier que le tableau comporte toutes les colonnes nécessaires
- Assurez-vous que les permissions de MySQL sont correctes
- Essayez de désinstaller et de réinstaller le module.
- Vérifier les journaux d'erreurs de MySQL
- Contacter l'administrateur du serveur
Erreur
Si vous rencontrez des problèmes insolubles avec le module, veuillez vous assurer que vous utilisez la dernière version et que votre boutique PrestaShop est à jour. En cas de difficultés, veuillez contacter le service d'assistance de COCOS à l'adresse suivante cocos.codes/support.
14. LES FAQ
Puis-je placer le bouton à un endroit personnalisé ?Oui, sélectionnez le hook "displayCustomProductQuestion" et ajoutez un callout à l'endroit approprié dans le modèle :
{hook h='displayCustomProductQuestion'}.Comment modifier l'apparence du formulaire ?
Vous pouvez modifier les fichiers CSS dans le dossier /modules/cc_ps_product_question/views/css/ ou utiliser les paramètres de style dans le panneau d'administration.
Puis-je ajouter des champs supplémentaires au formulaire ?
Actuellement, le module prend en charge des champs prédéfinis. L'ajout de nouveaux champs nécessite une modification du code source du module.
Comment créer un modèle de courrier électronique personnalisé ?
Copiez le fichier product_question_admin.html dans le dossier mails/[language]/ et renommez-le par exemple en custom_product_question_admin.html. Sélectionnez ensuite le modèle "custom" dans les paramètres.
Le module fonctionne-t-il avec des produits combinés ?
Oui, si vous activez l'option "Afficher les variantes de produits", les clients pourront sélectionner une combinaison spécifique dans la question.
Combien de temps les questions sont-elles conservées ?
Les questions sont stockées indéfiniment jusqu'à ce qu'elles soient supprimées manuellement par un administrateur.
Puis-je exporter des questions ?
Actuellement, le module n'a pas de fonction d'exportation intégrée, mais toutes les données se trouvent dans la table cc_product_question et peuvent être exportées via phpMyAdmin.
Que se passe-t-il lorsque la licence expire ?
À l'expiration de la licence, le formulaire continuera à fonctionner, mais les courriels ne seront pas envoyés. L'accès à la consultation des questions sauvegardées est maintenu.
Le module prend-il en charge les boutiques multilingues ?
Oui, le module prend entièrement en charge les boutiques multilingues. Les étiquettes des boutons peuvent être définies séparément pour chaque langue et des modèles d'e-mails sont créés pour toutes les langues actives.
À quelle fréquence le module est-il mis à jour ?
Le module est régulièrement mis à jour pour assurer la compatibilité avec les dernières versions de PrestaShop et pour introduire de nouvelles fonctionnalités. Les détenteurs d'une licence valide ont accès à toutes les mises à jour gratuitement.
Puis-je utiliser le module dans un environnement de test ?
Oui, la licence permet également d'utiliser le module sur des sous-domaines de test (par exemple test.mojsklep.pl) et des environnements de développement locaux. Veuillez vous référer aux conditions de la licence pour plus de détails.
Comment fonctionne la protection anti-spam ?
Le module utilise plusieurs couches de protection : Honeypot (champ caché), restrictions de fréquence par IP, contrôle du temps de remplissage, CAPTCHA optionnel et liste noire d'IP.
Le formulaire fonctionne-t-il avec la mise en cache des pages ?
Oui, le formulaire est chargé dynamiquement via AJAX, il fonctionne donc correctement même si le cache de la page est activé.
Comment vérifier si des courriels sont envoyés ?
Vérifiez l'onglet "Avancé > Email" dans le tableau de bord PrestaShop et testez l'envoi d'un email. Si le test réussit, le problème peut se situer dans la configuration du module.
Puis-je modifier l'adresse "de qui" dans les courriels ?
Les emails sont envoyés à partir des paramètres par défaut de votre boutique PrestaShop. Pour changer l'expéditeur, modifiez les paramètres sous "Avancé > Email".
Que signifie l'erreur "La table n'existe pas" ?
Cela signifie que la table de la base de données n'a pas été créée lors de l'installation. Essayez de désinstaller et de réinstaller le module ou contactez l'assistance.
Comment modifier la longueur maximale d'un message ?
Actuellement, la limite est de 1000 caractères et est définie dans le code pour la sécurité. Le changement nécessite la modification du fichier SecurityHandler.php.
Le module fonctionne-t-il avec les modules de référencement ?
Oui, le module n'interfère pas avec les URL ou les métadonnées des pages, il est donc compatible avec les modules de référencement.
Comment fonctionne la protection contre les attaques XSS ?
Le module analyse automatiquement les messages à la recherche de schémas suspects tels que
