Generatore di FAQ Schema.org — Documentazione

Panoramica

DfFaqSchema aggiunge blocchi di domande e risposte modificabili alle schede prodotto, alle pagine di categoria e ai layout delle Shopping Experiences in Shopware 6. Ogni blocco viene reso come accordion Bootstrap accompagnato dal markup Schema.org FAQPage in JSON-LD, iniettato automaticamente nella pagina. Il plugin supporta Shopware 6.5, 6.6 e 6.7 e non richiede alcuna modifica al tuo tema.

Installazione

Dall’amministrazione

1. Apri Estensioni, poi Le mie estensioni, e carica il file ZIP del plugin.
2. Fai clic su Installa, poi attiva il plugin.

Dalla console

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

Compilazione dell’amministrazione

Il modulo di amministrazione e l’elemento CMS richiedono una compilazione unica degli asset:

./bin/build-administration.sh

Configurazione

Apri Estensioni, Le mie estensioni, poi la configurazione di DfFaqSchema. Sono disponibili due opzioni, globali o per canale di vendita:

• Mostra le FAQ sulle schede prodotto: attiva l’accordion e il JSON-LD sulle pagine prodotto (attivo per impostazione predefinita).
• Mostra le FAQ sulle pagine di categoria: attiva l’accordion e il JSON-LD sulle pagine di navigazione (attivo per impostazione predefinita).

Creare voci FAQ

Apri Contenuti, poi FAQ Schema.org. L’elenco mostra tutte le voci con domanda, assegnazione, posizione e stato.

Campi di una voce

• Domanda: il testo della domanda (campo tradotto).
• Risposta: la risposta in testo formattato tramite l’editor integrato (campo tradotto).
• Posizione: l’ordine di visualizzazione nell’accordion, crescente.
• Attivo: solo le voci attive vengono visualizzate e marcate.
• Assegnazione: prodotto, categoria o pagina CMS. Il selettore di tipo mostra il campo di ricerca corrispondente.

Tradurre una voce

Usa il selettore di lingua in alto nella pagina di dettaglio per cambiare lingua, poi inserisci la domanda e la risposta tradotte. Ogni lingua dello storefront mostra i propri contenuti e il JSON-LD si adegua automaticamente.

Visualizzazione su prodotto e categoria

Le voci assegnate a un prodotto compaiono sotto il contenuto principale della scheda prodotto. Le voci assegnate a una categoria compaiono sotto l’elenco della pagina di navigazione. In entrambi i casi il JSON-LD FAQPage corrispondente viene iniettato nell’head del documento. La prima domanda dell’accordion è aperta per impostazione predefinita.

Elemento CMS per le Shopping Experiences

1. Crea le tue voci nel modulo senza assegnarle a un prodotto o una categoria (assegnazione pagina CMS).
2. Apri Contenuti, poi Shopping Experiences, e modifica un layout.
3. Aggiungi un blocco di testo, poi sostituisci il suo elemento con l’elemento FAQ (Schema.org).
4. Nella configurazione dell’elemento, seleziona le voci da mostrare.

L’accordion e il suo JSON-LD vengono resi esattamente dove posizioni l’elemento. Puoi usare più elementi FAQ sullo stesso layout.

Markup JSON-LD e validazione

Il plugin genera un oggetto FAQPage con un’entità Question per ogni voce visualizzata, con la risposta in HTML nel campo text dell’entità Answer, formato che Google accetta. Il markup copre solo il contenuto realmente visibile sulla pagina, in linea con le linee guida sui rich results.

Per validare una pagina, usa il test dei risultati multimediali di Google: incolla l’URL della tua scheda prodotto e verifica che l’elemento FAQ venga rilevato senza errori.

Risoluzione dei problemi

• La voce di menu FAQ Schema.org non compare: esegui la compilazione dell’amministrazione e svuota la cache del browser.
• L’accordion non compare su una scheda prodotto: verifica che la voce sia attiva, assegnata a quel prodotto e che l’opzione di visualizzazione prodotto sia attiva per il canale di vendita interessato.
• Il JSON-LD è assente: il markup viene generato solo se almeno una voce attiva è visualizzata sulla pagina. Cerca application/ld+json nel codice sorgente della pagina.
• L’elemento CMS non mostra nulla: verifica che nella configurazione dell’elemento siano state selezionate delle voci e che siano attive.

Disinstallazione

La disinstallazione rimuove le tabelle del plugin e la sua configurazione. Seleziona l’opzione di conservazione dei dati durante la disinstallazione per preservare le tue domande e risposte in vista di una reinstallazione.