Gestionnaire de FAQ : installation et aide
Démarrage rapide
- Importez le fichier ZIP de mprfaq dans Modules > Gestionnaire de modules et installez le module.
- Ouvrez FAQ > Settings > Configuration. Dans Page Settings, définissez FAQ Page Slug et traduisez Page Title et Page Description.
- Dans General, choisissez le mode Question pages et vérifiez Show Search Bar. Enregistrez les paramètres.
- Ouvrez FAQ > Categories et créez ou modifiez une catégorie active avec un nom et une URL simplifiée traduits.
- Ouvrez FAQ > Questions. Ajoutez une question et une réponse traduites, choisissez sa catégorie et activez la question.
- Associez-la à un produit si vous avez besoin de l'onglet FAQ sur la fiche produit, puis enregistrez.
- Ouvrez la page principale de la FAQ et le produit associé sur la boutique. Vérifiez la réponse et la recherche, puis testez l'envoi d'une question avec Ask a Question.
Nécessite PrestaShop 1.6.1 ou ultérieur et PHP 7.1 ou ultérieur.
Manuel de configuration
Installation et configuration
Suivez les étapes de la section Démarrage rapide.
Configurer les écrans de la FAQ
Ouvrez FAQ > Settings > Configuration. Enregistrez les paramètres après avoir modifié chaque section. Les valeurs par défaut ci-dessous s'appliquent à une nouvelle installation. Donnez aux employés accès aux contrôleurs FAQ dont ils ont besoin pour la modification ou la modération.
Général
- Enable legacy Schema.org FAQ markup. Détermine si le JSON-LD FAQPage/QAPage peut être généré lorsque la politique SEO de la page autorise les données structurées ; valeur par défaut :
0. À définir dans FAQ → Settings → Configuration → General. - Include in Sitemap. Ajoute les URL de FAQ éligibles au sitemap XML via
gSitemapAppendUrls; valeur par défaut :1. À définir dans General. - Allow FAQ landing page indexing. Permet à la page principale de la FAQ d'utiliser
index,follow, hreflang, l'inclusion dans le sitemap et les données structurées lorsque cela est autorisé ; valeur par défaut :1. À définir dans General. - Allow FAQ category page indexing. Interrupteur global pour les pages de catégorie ; chaque catégorie doit aussi avoir Index this category page activé ; valeur par défaut :
0. À définir dans General. - Allow FAQ tag page indexing. Permet aux pages de tags FAQ d'utiliser
index,followet hreflang ; les pages de tags restent exclues du sitemap ; valeur par défaut :0. À définir dans General. - Allow individual question pages to be indexed. Interrupteur global pour les pages de question individuelles ; chaque question doit aussi avoir Index this question page activé ; valeur par défaut :
0. À définir dans General. - Show Search Bar. Affiche l'interface de recherche de la FAQ sur la boutique ; valeur par défaut :
1. À définir dans General. - Show Category Description. Affiche les descriptions de catégorie sur les cartes et les pages de catégorie de la FAQ ; valeur par défaut :
1. À définir dans General. - Show Question Count. Affiche le nombre de questions sur les cartes de catégorie et dans les titres de catégorie ; valeur par défaut :
1. À définir dans General. - Compact Related Products. Utilise des cartes produit compactes pour les produits associés sur les pages de question FAQ ; valeur par défaut :
1. À définir dans General. - Expand First Question. Ouvre automatiquement la première question sur les pages de catégorie/tag en accordéon ; valeur par défaut :
0. À définir dans General. - Allow Multiple Open Questions. Permet de garder plusieurs réponses de l'accordéon ouvertes en même temps ; valeur par défaut :
1. À définir dans General.
Vérifiez aussi ces paramètres dans General :
| Paramètre | Valeur par défaut | Quand le modifier |
|---|---|---|
| Question pages | Pages individuelles (pages) |
Choisissez Sections on product and category pages (sections) pour afficher les réponses dépliées avec une table des matières. Ce paramètre concerne toutes les boutiques. |
| Questions on the Product Page | 0 | En mode Individual pages, définissez une limite pour les listes FAQ des fiches produit. Zéro signifie toutes. L'onglet propose des liens vers les pages FAQ pour les autres questions. |
En mode sections, les champs SEO des questions individuelles et la limite de questions par produit ne s'appliquent pas. Les liens entrants vers une question mènent au premier produit associé disponible, par ordre d'ID, ou à la catégorie FAQ si aucun produit n'est disponible. Les pages de question individuelles ne sont pas indexables dans ce mode.
Paramètres de la page
- FAQ Page Slug. Définit l'URL de base de la FAQ pour la langue par défaut ; valeur par défaut :
faq. À définir dans Page Settings ; videz le cache après modification. - Page Title. Définit le titre visible de la page principale de la FAQ ; valeur par défaut :
Frequently Asked Questions. À définir par langue dans Page Settings. - Page Description. Définit le texte d'introduction visible de la page principale de la FAQ ; valeur par défaut :
Find answers to frequently asked questions about our products and services.À définir par langue dans Page Settings. - Meta Title (SEO). Remplace le méta-titre de la page principale de la FAQ ; valeur par défaut : vide, auquel cas Page Title est utilisé. À définir par langue dans Page Settings.
- Meta Description (SEO). Remplace la méta-description de la page principale de la FAQ ; valeur par défaut : vide, auquel cas Page Description est utilisé. À définir par langue dans Page Settings.
| Paramètre supplémentaire | Valeur par défaut | Quand le modifier |
|---|---|---|
| Category and question URL suffix | Vide | Saisissez une extension commençant par un point, comme .html, si nécessaire. Les URL existantes de catégorie et de question sont redirigées après modification. Les URL de la page principale, des tags, de pagination et de recherche conservent leur format. |
| Show computed FAQ facts | Oui | Masquez le nombre de réponses publiées et les dates calculées Created, Reviewed et Latest answer si vous ne souhaitez pas les afficher. Ce paramètre est propre à chaque boutique. |
| Byline label | Vide | Saisissez votre propre titre multilingue pour les auteurs de la FAQ. |
| Byline text | Vide | Saisissez votre propre description multilingue des auteurs. Si le champ est vide, la mention des auteurs est masquée. |
| Published answers supporting text | Vide | Expliquez votre processus de publication. Si le champ est vide, le nombre calculé apparaît sans texte explicatif. |
Les trois paramètres de texte éditorial sont propres à chaque boutique et à chaque langue. Sélectionnez la boutique souhaitée avant de les modifier. Videz le cache après une modification de route et vérifiez que les anciens liens redirigent vers la nouvelle destination prévue.
Poser une question
- Enable "Ask a Question" Form. Affiche le formulaire de question client sur les pages FAQ et dans les onglets FAQ des produits ; valeur par défaut :
1. À définir dans Ask a Question. - Section Title. Définit le titre du bloc Ask a Question ; valeur par défaut :
Still have questions?. À définir par langue dans Ask a Question. - Section Description. Définit la description du bloc Ask a Question ; valeur par défaut :
Can't find what you're looking for? Send us your question and we'll get back to you.À définir par langue dans Ask a Question. - Button Text. Définit le libellé du bouton Ask a Question ; valeur par défaut :
Ask a Question. À définir par langue dans Ask a Question. - Success Message. Définit le message affiché après l'envoi d'une question ; valeur par défaut :
Thank you! Your question has been submitted successfully. We will respond as soon as possible.À définir par langue dans Ask a Question. - Max Pending Questions per Category. Limite les questions en attente par visiteur et par catégorie de produits de premier niveau ; valeur par défaut :
2, et0signifie illimité. À définir dans Ask a Question. - Show Pending Questions. Affiche dans les listes FAQ/produit les questions envoyées qui attendent encore une réponse ; valeur par défaut :
1. À définir dans Ask a Question.
Réponses publiques
- Enable Public Replies. Permet aux visiteurs d'envoyer des réponses supplémentaires aux questions FAQ existantes ; valeur par défaut :
0. À définir dans Public Replies. - Require Login. Exige un compte client pour que les visiteurs puissent envoyer des réponses publiques ; valeur par défaut :
0. À définir dans Public Replies. - Success Message. Définit le message affiché après l'envoi d'une réponse publique ; valeur par défaut :
Thank you! Your answer has been submitted for review and will appear once approved.À définir par langue dans Public Replies.
Les nouvelles réponses publiques attendent leur vérification dans FAQ > Additional Replies. Approuvez-les pour qu'elles puissent s'afficher publiquement. Les votes utile/pas utile utilisent un hachage avec clé de l'adresse IP et de l'agent utilisateur du visiteur pour empêcher les votes en double pendant 30 jours après un vote accepté. Ils ne sont pas rattachés à un compte client. Le service de vote actuel ne conserve pas les valeurs brutes de l'adresse IP ni de l'agent utilisateur.
Styles du thème
Utilisez Theme styles pour hériter des couleurs, bordures, rayons et styles de champs détectés pour la FAQ, ou les remplacer. Les valeurs par défaut dépendent du thème actif.
Créer des catégories et des réponses
- Ouvrez FAQ > Categories. Créez une catégorie comme Livraison. Traduisez son nom, sa description, son URL simplifiée, son méta-titre et sa méta-description. Activez-la.
- Associez la catégorie FAQ à des catégories de la boutique PrestaShop si vous souhaitez afficher les questions associées dans la barre latérale des catégories. Cet emplacement utilise
displayLeftColumn. - Ouvrez FAQ > Questions et créez une réponse dans cette catégorie FAQ. Traduisez Question, Answer, l'URL simplifiée et les champs SEO. Ajoutez des tags dans l'éditeur et gérez-les dans FAQ > Tags.
- Utilisez le sélecteur de produits pour associer la question à des produits précis. Les réponses publiées et associées s'affichent via
displayProductExtraContent. - Laissez la sélection des groupes de clients vide pour rendre la réponse visible à tous les groupes, ou sélectionnez les groupes autorisés à la voir.
- Définissez Publish Date si vous souhaitez différer la publication. Définissez Answer Reveal Date si la réponse doit apparaître après la question. Activez la question et enregistrez.
- Si vous utilisez les pages individuelles et souhaitez que cette réponse soit indexée, activez Index this question page et le paramètre global Allow individual question pages to be indexed.
Pour le thème Livraison, vous pouvez utiliser le slug de catégorie shipping et le slug de question how-long-does-delivery-take. Rédigez la réponse sur la livraison dans chaque langue et associez-la aux produits concernés. Utilisez les champs de l'éditeur plutôt que de coller des exemples de clés de configuration dans la base de données.
Le texte des questions, les réponses, les slugs et les champs SEO ont des valeurs propres à chaque langue. Les nouvelles questions sont associées à toutes les boutiques où FAQ Manager est installé ; créer une question dans le contexte d'une boutique ne la rend pas exclusive à cette boutique. Vérifiez sa disponibilité dans chaque boutique concernée avant de la publier.
Ouvrez Manage Product Q&A pour vérifier l'état des questions-réponses au niveau du produit si son interface de questions est indisponible. Examinez les questions des clients dans Pending Questions. Vous pouvez les approuver, les rejeter ou y répondre depuis le back-office. Par défaut, Ask a Question limite les envois en attente à deux par visiteur et par catégorie de produits de premier niveau ; zéro supprime cette limite.
Vérifier la boutique et les routes
Ouvrez la page principale de la FAQ, une catégorie et une question sans être connecté. Vérifiez la recherche, les descriptions de catégorie, le nombre de questions, le comportement de l'accordéon, les questions associées, les produits associés et les votes. Envoyez une question de test depuis la page FAQ et une fiche produit. Vérifiez qu'elles arrivent dans Pending Questions.
Voici des routes anglaises typiques sans suffixe :
/faq
/faq/page/2
/faq/shipping
/faq/shipping/how-long-does-delivery-take
/faq/tag/installation
/faq/search
/faq/search/returns
/faq/search/returns/page/2
Les segments de base localisés intégrés comprennent l'anglais faq, l'allemand haeufige-fragen, le français questions-frequentes, le polonais najczesciej-zadawane-pytania, l'italien domande-frequenti et l'espagnol preguntas-frecuentes. Utilisez les liens générés sur la boutique pour votre langue, le chemin de base de votre boutique et votre configuration réels.
Les réponses propres à un produit peuvent être présentes dans le HTML initial du produit. Les réponses partagées peuvent se charger à l'ouverture. Le module fournit aussi une recherche AJAX et des suggestions. L'intégration avec MPR Search Revolution est facultative et nécessite la présence de cette intégration distincte.
Configurer l'indexation et la génération du sitemap
| Type de page | Valeur par défaut | Conditions d'indexation ou d'inclusion dans le sitemap |
|---|---|---|
| Page principale de la FAQ | Indexation activée | Allow FAQ landing page indexing. Include in Sitemap doit aussi être activé pour la génération du sitemap. |
| Catégorie FAQ | Indexation désactivée | Allow FAQ category page indexing et Index this category page sur la catégorie. |
| Question individuelle | Indexation désactivée | Mode Individual pages, indexation globale des questions et Index this question page sur la question. |
| Pages de tags | Indexation désactivée | Allow FAQ tag page indexing. Les pages de tags restent exclues du sitemap. |
| Pages de recherche | Noindex | Utilisez la recherche pour parcourir le contenu. |
Les pages éligibles peuvent émettre des signaux canonical et hreflang conformément à la politique SEO du module. Le générateur de sitemap doit appeler gSitemapAppendUrls. Enable legacy Schema.org FAQ markup est désactivé par défaut. Activez-le uniquement si vous avez besoin de la génération facultative de FAQPage/QAPage et avez vérifié la politique de la page correspondante. Les moteurs de recherche choisissent le format du résultat.
Personnaliser les templates et le CSS
L'emplacement sur les fiches produit utilise displayProductExtraContent. Il n'existe actuellement aucun shortcode FAQ pour les pages CMS/produit à configurer. Votre thème doit afficher le hook de contenu supplémentaire du produit et la colonne gauche des catégories pour que ces emplacements fonctionnent.
Utilisez ces chemins pour surcharger les templates :
themes/your-theme/modules/mprfaq/views/templates/front/faq.tpl
themes/your-theme/modules/mprfaq/views/templates/front/category.tpl
themes/your-theme/modules/mprfaq/views/templates/front/question.tpl
themes/your-theme/modules/mprfaq/views/templates/hook/product-tab.tpl
themes/your-theme/modules/mprfaq/views/templates/hook/category-sidebar.tpl
Placez le CSS dans la feuille de style personnalisée de votre thème, par exemple :
.mprfaq-cat-card { border-color: #d8dde6; }
.mprfaq-detail-answer { font-size: 15px; line-height: 1.7; }
.mprfaq-vote-btn--yes:hover { border-color: #16a34a; color: #16a34a; }
#left-column .mprfaq-sidebar__widget.mpr-sidebar-section { margin-top: 24px; }
Dépannage
- Si du contenu manque, vérifiez que la catégorie et la question sont actives, ainsi que la langue de la boutique, la date de publication, la date d'affichage de la réponse et les associations aux groupes de clients.
- Si l'onglet produit manque, vérifiez les associations explicites aux produits, Manage Product Q&A et l'emplacement de
displayProductExtraContentdans le thème. - Si les questions de catégorie manquent, vérifiez les associations aux catégories de la boutique et la présence d'une colonne gauche sur cette page dans le thème.
- Si une question ouvre une section produit au lieu d'une page indépendante, vérifiez Question pages.
- Si les champs SEO semblent sans effet, vérifiez le mode et les options d'indexation globales et propres à chaque élément. Les pages noindex sont volontairement exclues du sitemap lorsque la politique l'exige.
- Si les réponses publiques manquent, vérifiez Enable Public Replies, Require Login et leur approbation dans Additional Replies.
- Après avoir modifié des slugs ou des suffixes, videz le cache et vérifiez les URL actuelles et anciennes. Le module conserve un historique des URL et redirige les anciennes URL.
Désactiver ou désinstaller
Désactivez le module dans le Gestionnaire de modules pour arrêter son intégration tout en conservant les données. Sauvegardez les catégories, questions, réponses, tags, votes, associations et paramètres avant de choisir Désinstaller. La désinstallation supprime son menu d'administration, la configuration du module, le schéma de base de données déclaré et les métadonnées des routes du module.
Captures d'écran de référence




Questions
2
Quelles données les questions envoyées, les réponses et les votes enregistrent-ils ?
Les questions en attente enregistrent le nom, l’e-mail, la question, le contexte produit ou catégorie, le statut et les horodatages.
Les réponses de la communauté enregistrent les informations de l’auteur et le texte pour la modération.
Les votes utilisent un hachage à clé de l’adresse IP et du user-agent pour éviter les doublons pendant 30 jours après un vote accepté. Le service de vote ne conserve pas ces valeurs brutes.
Les questions FAQ sont-elles distinctes pour chaque boutique et chaque langue ?
Dans FAQ Manager, le texte des questions, les réponses, les slugs et les champs SEO ont des valeurs propres à chaque langue.
Ces textes sont stockés dans les tables _lang. Les nouvelles questions sont associées à toutes les boutiques où le module est installé.
Créer une question dans le contexte d’une boutique ne la réserve pas à celle-ci. Les requêtes en boutique contrôlent les associations aux boutiques.
Problèmes connus
29
Textes d’administration restés en anglais
Création de question échouée laissant des données incomplètes
Vote enregistré pouvant sembler échoué
Réparation des onglets FAQ modifiant les libellés traduits
Visibilité FAQ anonyme utilisant le mauvais groupe de visiteurs
La maintenance FAQ modifiait les emplacements du marchand
URL des questions perdant des lettres aux mises à jour
Enregistrer et rester ignorait la validation des réglages
Erreurs de compatibilité de la détection du thème
Visibilité planifiée des FAQ périmée
Sélecteurs d’attribution enregistrant des choix inattendus
Échec de la FAQ sous PHP 7.1
Sitemap ignorant les choix d’indexation des questions
Échec possible du routage FAQ localisé
Emplacements FAQ supprimés réapparus
Pages de questions chargeant trop de produits associés
Renforcement de la sécurité
Échec possible des pages FAQ sur PrestaShop 8 et 9
Votes précédents mal restaurés
Nouvelles questions sans association à la boutique
Adresses FAQ inconnues sans réponse de page introuvable
Liens de questions redirigés vers eux-mêmes
Accordéon FAQ inactif avec les scripts combinés
Balisage FAQ obsolète resté actif
Produits affichant des questions FAQ sans rapport
Anciennes installations incapables de gérer les questions en attente
Échec possible du tri par utilité
Confirmation d’envoi de question masquée
Votes d’utilité répétés acceptés
Demandes de fonctionnalités
25
Implémenté
Questions clients sur les produits avec validation
Questions produit et votes d'utilité
Catégories de FAQ et questions des visiteurs
Réponses de la communauté et publication planifiée
Barre latérale FAQ par catégorie avec recherche
Étiquettes FAQ
Liens FAQ localisés
Intégration à la recherche de la boutique
Intégration à la base de connaissances
Questions en attente dans les listes FAQ
Réponses utiles en premier
Contrôle de l'indexation des questions
Mises à jour en un clic
Réglages des questions par produit
Blocs de code dans les réponses
Redirections des anciennes URL de questions
Règles d'indexation par type de page
Suffixe d'URL FAQ configurable
Limite de questions affichées par produit
Actualisation ciblée du cache FAQ
Variables de contenu FAQ dynamiques
Réparation d'URL avec aperçu
Choix de vote sans cookies FAQ
Formulaire de question chargé à la demande
Réponses regroupées en sections de page
Journal des modifications
v1.20.142026-05-27
- AddedReduce shared FAQ duplication in product tabs
- AddedAdd selective FAQ question indexing
- AddedAdd FAQ question indexability policy
- AddedOverhaul FAQ category and search pages
- AddedPaginate FAQ category pages
- Addedcomplete FR/DE/ES/IT/PL translations
- ImprovedRender FAQ resource lists with shared component
- ImprovedExpose knowledge base CTA in FAQ
- FixedPrevent FAQ question self-redirects
- FixedNofollow nonindexable FAQ detail links
- FixedEnforce FAQ noindex upgrade policy
- FixedRequire product-specific FAQ for inline answers
Versions précédentes
v1.3.02026-04-20
- AddedCenter modal, add translations for product tab and rate limiter
- AddedRate limit ask-a-question to max 2 pending per email per product
- AddedShow pending questions at top of product tab accordion
- AddedShow date and reactions in product tab headers, sort by helpfulness
- AddedLicense management tab with key management and renewal options
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedcomplete FR/DE/ES/IT/PL translations
- ImprovedUnified KPI component, modal ask form, monochrome vote icons
- ImprovedLeft-align hero intro, add category tiles heading, improve FR description
- Improvedadmin list columns with visual badge indicators and multiselect filters
- ImprovedSEO handling with proper canonical URLs and meta tags on all front pages
- FixedUse ProductAssembler for related products on question page
- FixedReplace hardcoded French source strings with English across all templates
- FixedSwap related questions before products, use theme product grid
- Fixedvarious stability and compatibility improvements (23 fixes total)
- Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
v1.2.02026-01-15
- Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
- AddedFAQ Schema (FAQPage structured data) for Google rich results on all FAQ pages
- Improvedaccordion animation — uses CSS transitions instead of jQuery for smoother UX
- Fixedcategory ordering not respected on the front-end when categories were reordered via drag-and-drop
- Addedsearch/filter bar to quickly find questions within a long FAQ page
v1.0.02025-12-12
- Initialrelease: accordion FAQ management with unlimited questions and categories
- InitialConfigurable hook placement — works on any controller via back-office hook selector
- InitialClean, accessible HTML5 markup with ARIA attributes for screen readers
- InitialMulti-language support for questions, answers, and category names
v1.1.02025-07-24
- Addedcategory grouping — questions can now be organised under collapsible category headings
- Improvedadmin list with sortable drag-and-drop for both categories and questions
- Fixedduplicate IDs on pages with multiple FAQ widgets on the same hook
- Addedoption to show FAQ widget on product pages with product-specific question sets
Demo
Testez le module complet avant d'acheter
Achetez la licence plus tard et gardez vos réglages.
- Votre démo de 30 jours Testez-le sur votre propre boutique pendant 30 jours à partir de la première installation.
- Boutique de démo prête Découvrez une boutique de démo prête dans votre navigateur.
- Sans inscription Ni compte, ni e-mail, ni domaine de boutique requis.
En téléchargeant, vous acceptez les conditions de la démo et la politique de confidentialité.
En ouvrant cette démo, vous acceptez les conditions de la démo et la politique de confidentialité.