Dépannage
Avant tout : vérifiez le panneau État de la page de configuration. S’il est orange, la FAQ est simplement masquée aux visiteurs (voir Réglages).
Vider le cache
C’est la solution d’une grande partie des problèmes après une installation ou une mise à jour.
- Paramètres avancés > Performances.
- Vider le cache, en haut à droite.
- Rechargez la page de la boutique (sur ordinateur, Ctrl + F5 ou Cmd + Maj + R).
AnswerKit vide lui-même le cache de la FAQ à chaque modification d’une question ou d’un réglage. Le cache général de PrestaShop, lui, doit être vidé après chaque installation ou mise à jour du module, surtout si Cache intelligent pour les CSS est activé.
La FAQ est dans le code de la page, mais pas à l’écran
Le thème n’affiche pas l’emplacement choisi, ou le cache en sert une ancienne version.
- Videz le cache (ci-dessus).
- Dans Où les FAQ sont utilisées, choisissez un emplacement compatible avec tous les thèmes :
- fiches produit : Bloc à part après la description ;
- catégories, marques, pages CMS : Fin du contenu de la page, compatible avec tous les thèmes ;
- accueil : Fin du contenu de la page si votre thème n’affiche pas Dans les sections de la page d’accueil.
- Enregistrez et rechargez la page.
Les emplacements Sous la liste des produits, thème Classic et Au-dessus de la liste des produits, thème Classic n’existent pas dans tous les thèmes : beaucoup de thèmes du marché les retirent.
La FAQ n’apparaît pas sur la fiche produit
- Votre thème doit afficher le contenu des modules après la description (
displayProductExtraContent). Classic, Hummingbird et le thème adlx le font. Si le vôtre ne le fait pas, essayez Bas de la fiche produit, ou placez le widget (voir Usages avancés). - La portée Fiches produit doit être sur Oui.
Compatibilité par thème
| Thème | Fiche produit | Catégories, marques, CMS |
|---|---|---|
| Classic (PrestaShop 8) | Onglet après Description et Détails du produit | Tous les emplacements |
| Hummingbird (PrestaShop 9) | Section dépliable sous la description | Fin ou Haut du contenu de la page |
| Thème adlx | Onglet ou section, selon la mise en page choisie | Fin ou Haut du contenu de la page |
| Autres thèmes (Cartzilla, Warehouse…) | Bloc à part après la description en général ; sinon Bas de la fiche produit | Fin ou Haut du contenu de la page |
L’accordéon s’affiche sans style
Le CSS d’AnswerKit n’est pas chargé : videz le cache de PrestaShop (le fichier CSS combiné porte encore l’ancienne liste de fichiers). Si votre thème force ses propres styles de listes ou de titres, ajustez les couleurs avec les variables CSS décrites dans Usages avancés.
Le bloc apparaît deux fois
- Vous avez un emplacement choisi et le widget
{widget name='answerkit'}dans le thème : mettez l’emplacement sur Aucun, le thème place le widget lui-même. - Deux modules FAQ affichent la même question : voir les questions fréquentes.
Le test de Google signale deux FAQPage
Un autre module ou le thème écrit aussi un bloc FAQPage. Coupez l’un des deux : dans AnswerKit, Ajouter les données structurées FAQPage sur Non. Voir Données structurées.
L’onglet FAQ du produit reste sur « Chargement… »
Rechargez la fiche produit. Si le problème persiste, videz le cache et vérifiez que le module est à jour : les versions antérieures à 1.4.0 avaient ce défaut sur PrestaShop 9.
Une question affiche son numéro au lieu de son texte dans le back-office
Elle n’a pas de texte dans la langue du back-office. Ouvrez-la et remplissez au moins la langue par défaut, marquée d’une étoile.
L’import CSV refuse le fichier
- Colonnes manquantes : la première ligne doit contenir
item_ref;active;links;lang;question;answer. - Ce n’est pas un fichier CSV texte : dans Excel, Enregistrer sous au format CSV UTF-8 (délimité par des virgules), pas en .xlsx. Le point-virgule et la virgule sont acceptés tous les deux.
- Plus de 5 Mo ou de 20 000 lignes : découpez le fichier.
Désinstaller
La désinstallation supprime toutes les questions, leurs liens et les réglages, et retire les droits d’API du module. Avant de désinstaller :
- Catalogue > FAQ (AnswerKit) > Exporter toutes les questions (CSV) pour garder une copie.
- Modules > Gestionnaire de modules, AnswerKit, menu de l’action, Désinstaller.
Pour masquer les FAQ sans rien perdre, passez plutôt Afficher les FAQ aux visiteurs sur Non, ou désactivez le module. Pour mettre à jour, n’installez jamais après une désinstallation : envoyez simplement le nouveau zip (voir Installation).
Toujours bloqué ?
Écrivez à hello@adlx.studio avec votre version de PrestaShop, votre thème, la version d’AnswerKit (en bas de la page de configuration) et l’adresse d’une page concernée.