Générateur de FAQ Schema.org — Documentation

Présentation

DfFaqSchema ajoute des blocs de questions-réponses éditables sur les fiches produits, les pages de catégories et les layouts Shopping Experiences de Shopware 6. Chaque bloc est rendu sous forme d’accordéon Bootstrap et accompagné d’un balisage Schema.org FAQPage en JSON-LD, injecté automatiquement dans la page. Le plugin est compatible Shopware 6.5, 6.6 et 6.7 et ne nécessite aucune modification de votre thème.

Installation

Via l’administration

1. Ouvrez Extensions puis Mes extensions et téléversez le fichier ZIP du plugin.
2. Cliquez sur Installer, puis activez le plugin.

Via la console

bin/console plugin:refresh
bin/console plugin:install --activate DfFaqSchema
bin/console cache:clear

Compilation de l’administration

Le module d’administration et l’élément CMS nécessitent une compilation unique des assets :

./bin/build-administration.sh

Configuration

Ouvrez Extensions, Mes extensions, puis la configuration de DfFaqSchema. Deux options sont disponibles, réglables globalement ou par canal de vente :

• Afficher les FAQ sur les fiches produits : active l’accordéon et le JSON-LD sur les pages produits (activé par défaut).
• Afficher les FAQ sur les pages de catégories : active l’accordéon et le JSON-LD sur les pages de navigation (activé par défaut).

Créer des entrées FAQ

Ouvrez Contenus puis FAQ Schema.org. Le listing affiche toutes les entrées avec leur question, leur assignation, leur position et leur statut.

Champs d’une entrée

• Question : le texte de la question (champ traduit).
• Réponse : la réponse en texte enrichi via l’éditeur intégré (champ traduit).
• Position : l’ordre d’affichage dans l’accordéon, croissant.
• Actif : seules les entrées actives sont affichées et balisées.
• Assignation : produit, catégorie ou page CMS. Le sélecteur de type affiche le champ de recherche correspondant.

Traduire une entrée

Utilisez le sélecteur de langue en haut de la page de détail pour basculer de langue, puis saisissez la question et la réponse traduites. Chaque vitrine affiche les contenus de sa langue et le JSON-LD suit automatiquement.

Affichage produit et catégorie

Les entrées assignées à un produit s’affichent sous le contenu principal de la fiche produit. Les entrées assignées à une catégorie s’affichent sous le listing de la page de navigation. Dans les deux cas, le JSON-LD FAQPage correspondant est injecté dans l’en-tête du document. La première question de l’accordéon est ouverte par défaut.

Élément CMS pour les Shopping Experiences

1. Créez vos entrées dans le module sans les assigner à un produit ou une catégorie (assignation page CMS).
2. Ouvrez Contenus puis Expériences d’achat et éditez un layout.
3. Ajoutez un bloc de texte, puis remplacez son élément par l’élément FAQ (Schema.org).
4. Dans la configuration de l’élément, sélectionnez les entrées à afficher.

L’accordéon et son JSON-LD sont rendus à l’emplacement exact de l’élément. Vous pouvez utiliser plusieurs éléments FAQ sur un même layout.

Balisage JSON-LD et validation

Le plugin génère un objet FAQPage contenant une entité Question par entrée affichée, avec la réponse en HTML dans le champ text de l’entité Answer, ce que Google accepte. Le balisage ne couvre que le contenu réellement visible sur la page, conformément aux consignes rich results.

Pour valider une page, utilisez le test des résultats enrichis de Google : collez l’URL de votre fiche produit et vérifiez que l’élément FAQ est détecté sans erreur.

Dépannage

• Le menu FAQ Schema.org n’apparaît pas : exécutez la compilation de l’administration puis videz le cache du navigateur.
• L’accordéon ne s’affiche pas sur une fiche produit : vérifiez que l’entrée est active, qu’elle est bien assignée à ce produit et que l’option d’affichage produit est activée pour le canal de vente concerné.
• Le JSON-LD est absent : le balisage n’est généré que si au moins une entrée active est affichée sur la page. Vérifiez le code source de la page en recherchant application/ld+json.
• L’élément CMS n’affiche rien : vérifiez que des entrées ont été sélectionnées dans la configuration de l’élément et qu’elles sont actives.

Désinstallation

La désinstallation supprime les tables du plugin et sa configuration. Cochez l’option de conservation des données lors de la désinstallation pour préserver vos questions-réponses en vue d’une réinstallation.