Schema Pro

Panoramica

Schema Pro è un modulo PrestaShop progettato per generare automaticamente dati strutturati Schema.org in JSON-LD puliti, completi e compatibili con Google. Mentre il markup nativo di PrestaShop è spesso limitato (e talvolta produce JSON fragile), Schema Pro costruisce il JSON-LD lato PHP con json_encode() per evitare errori di formattazione e garantire coerenza su tutte le pagine. L’obiettivo è semplice: aiutare i motori di ricerca a comprendere meglio i tuoi contenuti e aumentare le probabilità di ottenere risultati arricchiti (prezzo, disponibilità, valutazioni, breadcrumb, FAQ, ecc.), migliorando visibilità e CTR.

Vantaggi principali:

• JSON-LD completo e conforme (e-commerce + pagine contenuto)
• Supporto ProductGroup + varianti (specifica Google 2024)
• Politiche di spedizione e reso (OfferShippingDetails, MerchantReturnPolicy)
• Audit integrato (punteggio, errori, avvisi, export)
• Cache intelligente con invalidazione automatica

Perché questo modulo

I dati strutturati sono una leva SEO concreta per i negozi PrestaShop: aiutano Google a interpretare le pagine prodotto, le categorie, l’identità del brand (Organization/LocalBusiness) e gli elementi di navigazione (BreadcrumbList). Nella pratica, molti shop hanno markup incompleto, duplicato (più moduli) o incoerente (varianti dichiarate male, assenza di identificativi prodotto, mancanza di info su spedizioni/resi). Schema Pro centralizza tutto in un unico markup configurabile e leggibile da Google, migliorando la qualità e riducendo gli errori nei validator.

Funzionalità

Dati strutturati prodotto (Product)

Schema Pro genera uno schema Product arricchito sulle schede prodotto: nome, descrizione, immagini (tutte le immagini, non solo la copertina), SKU/riferimento, brand (produttore), identificativi (EAN/GTIN, MPN, ISBN/UPC se disponibili), categoria, URL, condizione, Offers (prezzo, valuta, disponibilità, venditore, validità del prezzo). L’obiettivo è fornire a Google un segnale chiaro e completo dell’offerta. Il modulo può includere anche valutazioni e recensioni (AggregateRating e Reviews) tramite una fonte recensioni compatibile, rafforzando la fiducia quando i dati sono sufficienti.

Prodotti con varianti (ProductGroup + varianti)

Per prodotti con taglie, colori o altri attributi, Schema Pro può generare un ProductGroup in linea con le raccomandazioni Google (2024). Le varianti sono dichiarate tramite hasVariant, ciascuna con i propri dati (SKU, EAN, prezzo, stock, immagine, URL variante). Il modulo rileva automaticamente gli assi di variazione con variesBy (es. colore, taglia) e permette di limitare il numero di varianti incluse per mantenere un JSON-LD performante e “ragionevole”. Questa funzione è particolarmente utile per moda, accessori, arredamento e cataloghi molto “combinatori”.

Brand e negozio (Organization / LocalBusiness)

Schema Pro genera uno schema Organization (o LocalBusiness, Store, OnlineStore, ecc.) su tutto il sito: nome commerciale, ragione sociale, descrizione, email, telefono, IVA, logo, indirizzo e profili social (sameAs). Per attività con punto vendita, i campi LocalBusiness (orari, coordinate geo, fascia di prezzo) migliorano la coerenza tra shop, presenza locale e risultati Google. Una configurazione corretta rafforza anche la comprensione dell’entità (Knowledge Graph) e la fiducia dell’utente.

WebSite + SearchAction, BreadcrumbList, FAQPage, CollectionPage

Il modulo può aggiungere:

• WebSite + SearchAction (sitelinks search box) per migliorare l’integrazione con Google.
• BreadcrumbList dinamico (prodotto, categoria, CMS, produttore) per breadcrumb coerenti nelle SERP.
• FAQPage tramite un gestore FAQ in back-office, associabile a prodotti, categorie, pagine CMS o URL personalizzati.
• CollectionPage + ItemList sulle categorie, elencando i prodotti della pagina corrente (paginazione rispettata), per aiutare l’indicizzazione dei listing senza sovraccaricare il markup.

Spedizione e resi (OfferShippingDetails, MerchantReturnPolicy)

Schema Pro consente di definire una policy di spedizione e una di reso, poi referenziarle in ogni Offer tramite @id (evita duplicazioni massicce nel JSON-LD). Puoi configurare paesi di destinazione, costi, tempi di preparazione e transito, oltre a finestra di reso, costi, metodo e URL della policy. Queste informazioni aumentano la trasparenza e possono migliorare l’idoneità a risultati arricchiti e superfici Shopping, in base ai criteri Google.

Audit integrato e performance (cache)

La sezione Audit scansiona il catalogo (prodotti, categorie, organizzazione) e segnala i dati mancanti (immagini, prezzo, EAN/GTIN, brand, SKU, descrizioni, ecc.) con un punteggio e una classificazione (errore, avviso, info). Per le performance, Schema Pro include una cache del JSON-LD con invalidazione automatica quando cambiano dati rilevanti (prodotto, categoria, CMS, recensioni, configurazione), mantenendo il sito veloce anche con grandi cataloghi.

Requisiti

Schema Pro è pensato per versioni moderne di PrestaShop e uno stack server aggiornato, per garantire compatibilità e prestazioni.

• PrestaShop: minimo 8.0.0 (compatibile con 8.x e 9.x)
• PHP: minimo 8.1 (compatibile 8.1–8.4 a seconda della configurazione)
• MySQL 5.7+ o MariaDB 10.3+
• HTTPS consigliato (best practice SEO e sicurezza)

Non è necessario alcun CRON: il JSON-LD viene generato al volo e la cache (se attivata) migliora i tempi di risposta in produzione.

Installazione

Installazione da back-office (consigliata)

1. Vai su Moduli > Gestore moduli
2. Clicca Carica un modulo
3. Seleziona l’archivio ZIP del modulo (es. wepresta_schema_pro.zip)
4. Attendi il completamento dell’installazione
5. Clicca Configura

Installazione via FTP

1. Decomprimi l’archivio
2. Carica la cartella del modulo in /modules/
3. Nel back-office, cerca il modulo
4. Clicca Installa, poi Configura

Cosa fa l’installazione

Il modulo crea le sue tabelle (FAQ, mapping attributi, cache), registra gli hook (iniezione front, invalidazione cache), aggiunge la voce menu in back-office e può disattivare il markup nativo PrestaShop per evitare duplicati. Dopo l’installazione, è consigliato configurare l’Organizzazione e attivare i tipi di schema necessari prima di lanciare un audit.

Avvio rapido

Per ottenere un markup pulito in meno di 10 minuti:

1. Installa il modulo e apri Configura
2. In General, abilita almeno: Product, Organization, WebSite, BreadcrumbList
3. Abilita la disattivazione del markup nativo se non usi un altro generatore JSON-LD
4. In Organization, inserisci: nome, logo, email, telefono, indirizzo, profili social
5. In Products, abilita ProductGroup se hai varianti e verifica il mapping (Colore → color, Taglia → size)
6. (Opzionale) Aggiungi policy di spedizione e reso per arricchire le Offers
7. Esegui un Audit e correggi i dati mancanti (immagini, EAN, brand, descrizioni)
8. Testa una pagina prodotto con Google Rich Results Test e verifica che non ci siano duplicati

Configurazione

Scheda General

Raccoglie le impostazioni globali: attivazione dei tipi di schema, disattivazione dei dati strutturati nativi PrestaShop (per evitare duplicazioni) e attivazione della cache. Durante la fase di setup è spesso meglio lasciare la cache disattivata per vedere subito le modifiche. Una volta stabilizzata la configurazione, attiva la cache in produzione per ridurre il costo di generazione.

Scheda Organization

Scegli il tipo di entità (Organization, OnlineStore, LocalBusiness, Store, ecc.) e compila le informazioni essenziali: nome, ragione sociale, descrizione, logo, IVA, indirizzo completo e URL dei profili social. Per LocalBusiness, aggiungi se possibile orari, coordinate geo e fascia di prezzo. I campi vuoti non vengono inviati nel JSON-LD (meglio ometterli che pubblicare valori vuoti).

Scheda Products

Abilita ProductGroup se il catalogo contiene varianti, imposta un limite di varianti se necessario e configura la condizione predefinita. Verifica la fonte recensioni e imposta una soglia minima per evitare AggregateRating “debole” (best practice comune). Poi configura il mapping degli attributi PrestaShop verso proprietà Schema.org (colore, taglia, materiale, pattern, genere) per alimentare variesBy e arricchire le varianti.

Scheda FAQ

Crea coppie Domanda/Risposta nel back-office e associale a prodotti, categorie, pagine CMS o URL personalizzati. Le FAQ sono multilingua e ordinabili. Lo schema FAQPage viene generato solo quando esistono FAQ attive per la pagina corrente, per evitare markup inutile. Le domande devono essere naturali e utili: Google spesso ignora FAQ “artificiali”.

Scheda Audit

L’audit identifica errori bloccanti (es. prodotto senza immagine, prezzo a zero), avvisi (EAN/GTIN mancante, assenza di brand, descrizioni troppo corte) e informazioni (nessuna recensione, ProductGroup disattivato, ecc.). Usalo per prioritizzare le correzioni, esporta il report se serve e rilancia una scansione per misurare il miglioramento del punteggio.

Multistore e multilingua

Schema Pro supporta il multistore: ogni shop può avere una configurazione propria (tipi attivi, organizzazione, policy spedizione/resi, FAQ, cache). In contesto multistore, seleziona prima lo shop nel selettore di contesto PrestaShop prima di modificare i parametri. Il multilingua è nativo: il JSON-LD è generato nella lingua del visitatore (prodotti, categorie, FAQ, organizzazione), evitando segnali incoerenti (es. FAQ in francese su una pagina inglese).

Compatibilità

Versioni PrestaShop

• PrestaShop 8.0.x: compatibile
• PrestaShop 8.1.x: compatibile
• PrestaShop 8.2.x: compatibile
• PrestaShop 9.0.x: compatibile

Versioni PHP

• PHP 8.1: compatibile
• PHP 8.2: compatibile
• PHP 8.3: compatibile
• PHP 8.4: compatibile

Database

• MySQL 5.7+
• MySQL 8.0
• MariaDB 10.3+

FAQ

Il modulo rallenta il negozio?

No. Il JSON-LD è iniettato nel <head> e resta leggero. Con la cache attiva, l’impatto tipico è circa 1–2 ms per pagina. Senza cache l’impatto dipende dalla complessità del prodotto (varianti, recensioni) ma è generalmente trascurabile. L’invalidazione automatica evita dati obsoleti mantenendo il front-office veloce.

Posso usarlo con un altro modulo SEO?

Sì, ma bisogna evitare duplicati. Se un altro modulo genera anche JSON-LD Product/Organization/Breadcrumb/FAQ, Google può ignorare o peggiorare l’interpretazione. Best practice: disattivare la parte “dati strutturati” nell’altro modulo, oppure attivare la disattivazione del markup nativo e assicurarsi che resti attivo un solo generatore JSON-LD.

I dati strutturati garantiscono rich snippets?

No. Aumentano molto le probabilità, ma Google decide. Uno shop con markup valido, completo, senza duplicazioni e dati prodotto solidi (immagini, prezzo, stock, identificativi, recensioni reali) massimizza l’idoneità e spesso migliora il CTR anche senza risultati arricchiti garantiti.

Risoluzione problemi

Nessun JSON-LD visibile

• Verifica che il modulo sia installato e attivo
• Abilita almeno un tipo di schema in General
• Controlla che l’hook di iniezione front sia presente (es. displayHeader)
• Svuota la cache PrestaShop (Smarty) e, se serve, la cache del modulo

Duplicati di schema

• Attiva la disattivazione del markup nativo se necessario
• Disattiva generatori JSON-LD concorrenti
• Ricontrolla il sorgente pagina e ripeti il test con Google Rich Results Test

Errori nei validator Google

• Aggiungi almeno un’immagine per prodotto
• Verifica prezzo/valuta/disponibilità
• Usa l’audit per correggere EAN/GTIN, brand, SKU, descrizioni
• Controlla la configurazione spedizione/resi se attivata

Changelog

Versione 1.0.0

• Generazione JSON-LD completa: Product, ProductGroup, Organization/LocalBusiness, WebSite, BreadcrumbList, FAQPage, CollectionPage
• Supporto ProductGroup + varianti (hasVariant, variesBy, productGroupID)
• Policy spedizione (OfferShippingDetails) e resi (MerchantReturnPolicy) referenziate via @id
• Mapping attributi PrestaShop verso proprietà Schema.org
• Audit integrato con scoring ed export CSV
• Cache intelligente con invalidazione automatica
• Back-office moderno (controller Symfony), supporto multistore e multilingua

Supporto

Il supporto è disponibile tramite la tua area cliente / canale di supporto WePresta. Per velocizzare la diagnosi, fornisci:

• Versioni PrestaShop e PHP
• URL interessata + output Rich Results Test
• Sorgente pagina (cerca application/ld+json)
• Report audit esportato (CSV)
• Log PrestaShop se disponibili

Licenza

Distribuito sotto Academic Free License (AFL 3.0).
Copyright © WePresta (ADAMAS GROUP SA). Tutti i diritti riservati.