- poprawiono regex-y do czyszczenia mark-upu Json LD z plików modułów
Funzionalità principali del modulo
Un unico grafo JSON-LD e controllo delle entità pubblicate
- Un unico documento JSON-LD. Il modulo compone i dati abilitati in un unico grafo Schema.org con
@contexte@graph, invece di creare un frammento JSON separato per ogni tipo di dato. - Collegamenti tramite
@id. Le entità possono fare riferimento tra loro, ad esempio l’offerta del prodotto all’organizzazione, e la pagina al sito web e ai breadcrumb. - Generazione lato PHP. Il JSON viene costruito dalla classe del modulo e codificato tramite
json_encode(); il template riceve il markup già pronto. - Rendering dopo la preparazione della pagina. Il modulo utilizza
displayFooterper avere accesso ai dati dell’elenco prodotti visibile e alle domande FAQ passate a Smarty. - Interruttori indipendenti. Organization, LocalBusiness, Product, BreadcrumbList, WebSite, WebPage, CheckoutPage, ContactPage, SearchResultsPage, Article, CollectionPage e FAQPage vengono abilitati in modo indipendente.
Organization, OnlineStore e dati commerciali
- Tipo di organizzazione. È possibile configurare l’entità come
OnlineStore,OnlineBusiness,Organization,CorporationoppureStore. - Fonte dei dati aziendali. Nome, indirizzo e contatti possono utilizzare le impostazioni del negozio PrestaShop oppure i valori inseriti manualmente nel modulo.
- Identificazione del soggetto. Il modulo supporta tra l’altro ragione sociale, nomi alternativi, descrizione, logo, immagini, indirizzo, e-mail, telefono, profili
sameAs, partita IVA, VAT ID, codice ISO 6523, GLN e data di fondazione — se i dati vengono completati. - Punti di contatto. Nella configurazione avanzata è possibile aggiungere canali di contatto ripetibili con tipo di contatto, telefono, e-mail, lingue e area di servizio.
- Condizioni commerciali. All’organizzazione può essere assegnata la configurazione delle politiche di reso, dei servizi di consegna e dei livelli del programma fedeltà. I dati vengono pubblicati esclusivamente quando l’amministratore fornisce valori completi e veritieri.
LocalBusiness per punti vendita fisici e servizio locale
- Un punto o più filiali. I campi di base creano un’entità LocalBusiness predefinita, mentre l’elenco ripetibile delle filiali consente di pubblicare entità separate con identificatori stabili.
- Indirizzo e dati locali. Per ogni sede è possibile indicare tipo di attività, nome, marchio, indirizzo, telefono, e-mail, indirizzo del sito, codice filiale, fascia di prezzo, area servita, pagamenti accettati e valute.
- Coordinate e mappa. Sono disponibili campi per latitudine e longitudine, indirizzo della mappa e indirizzi delle immagini.
- Orari standard e speciali. Il modulo supporta gli orari di apertura per giorni della settimana e righe con intervallo di date per orari stagionali o eccezionali.
- Validazione dell’indirizzo. Per una sede attiva configurata manualmente sono richiesti dati di indirizzo completi: via, città, CAP e codice paese ISO a due lettere.
Prodotto, offerta e varianti
- Product oppure ProductGroup. Un prodotto senza varianti disponibili riceve l’entità
Product; un prodotto con combinazioni disponibili può essere descritto comeProductGroupcon entitàhasVariant. - Dati prelevati da PrestaShop. Il modulo utilizza nome, descrizione, categoria, immagini, riferimento SKU, MPN, EAN-13, UPC, produttore, peso, dimensioni, prezzo, valuta, disponibilità e condizione del prodotto — quando disponibili e applicabili.
- Offerte dipendenti dalla possibilità di acquisto. L’entità
Offerviene aggiunta solo quando il catalogo non è in modalità catalogo, il prodotto può essere ordinato e il prezzo è visibile nella pagina prodotto. - Varianti con indirizzo proprio. Ogni variante pubblicata riceve un collegamento alla combinazione PrestaShop; quando il generatore URL restituisce un unico indirizzo canonico, il modulo aggiunge il parametro
id_product_attribute. - Mappatura delle caratteristiche della variante. I gruppi di attributi possono essere assegnati a proprietà come colore o taglia, mentre gli altri assi delle varianti vengono passati come
additionalPropertycon il nome pubblico dell’attributo. - Dati che estendono il prodotto. La configurazione avanzata consente di mappare le caratteristiche del prodotto su proprietà, materiale, motivo, certificazioni e dati energetici. Il modulo trasmette anche il prezzo unitario, quando i dati di unità e coefficiente del prodotto consentono di calcolarlo.
- GTIN e immagini. Il builder verifica la correttezza della lunghezza e della cifra di controllo del GTIN, e i dati delle immagini del prodotto includono le immagini disponibili del prodotto, non solo la copertina.
- Limite del numero di varianti. Il limite predefinito è di 100 combinazioni per negozio, mentre il limite tecnico assoluto è 250. Superato questo valore, il modulo non costruisce un
ProductGroupesteso con tutte le varianti, per non gonfiare la risposta della pagina. - Consegna e resi. È possibile trasmettere i dettagli di spedizione e la politica di reso a livello di organizzazione oppure abilitare una sovrascrittura separata per le offerte del prodotto.
Pagine, contenuti ed elementi visibili del negozio
- BreadcrumbList. Il modulo costruisce i breadcrumb dalla navigazione visibile e, quando non sono disponibili, applica la gestione delle pagine prodotto, categoria, produttore, fornitore, CMS e delle pagine blog riconosciute.
- WebSite nella home page. L’entità
WebSiteviene pubblicata per la home page del negozio dopo la sua attivazione. - WebPage e pagine speciali. Il modulo crea
WebPagecon un tipo selezionato in base al controller corrente, e interruttori separati gestisconoCheckoutPage,ContactPageeSearchResultsPage. - Article. L’integrazione riguarda i post di
ph_simpleblogesmartblog; può trasmettere titolo, descrizione, immagine, date e autore visibile nella pagina. - CollectionPage. Per gli elenchi di categorie, produttore, fornitore, novità, promozioni e bestseller, il modulo costruisce un elenco dei prodotti visibili. Il limite degli elementi è configurabile da 1 a 200, predefinito 50.
- FAQPage con contenuti visibili all’utente. Domande e risposte vengono prelevate esclusivamente dai dati passati dalla pagina attualmente renderizzata con le chiavi
pd_faqs,product_faqsoppurefaqs.
Pannello amministrativo e manutenzione dei dati
- Area di lavoro e anteprima. Il pannello del modulo raggruppa le impostazioni degli schemi e include un’anteprima del JSON-LD generato in base alla configurazione corrente.
- Controllo del salvataggio. Il modulo valida tra l’altro i dati richiesti dell’organizzazione manuale, e-mail, codici paese, indirizzi HTTP(S), intervalli numerici, orari, righe ripetibili e configurazione di consegna e resi.
- Multistore. La configurazione viene salvata nel contesto del negozio; ogni negozio può pubblicare i propri dati aziendali, di localizzazione e commerciali.
- Rimozione del vecchio JSON-LD. Gli strumenti del modulo possono eseguire un backup e rimuovere i vecchi frammenti JSON-LD rilevati dai file del tema o dei moduli, quindi ripristinare i dati selezionati dall’archivio.
Importanza per SEO e GEO — senza promesse infondate
Il JSON-LD trasmette ai motori di ricerca e ai sistemi che elaborano i dati informazioni strutturate sul negozio, sull’azienda, sui prodotti, sulle sedi e sui contenuti visibili. Per GEO è importante la coerenza di nomi, indirizzi, contatti, aree di servizio e profili con i dati reali dell’impresa; il modulo non li completa al posto dell’amministratore né ne verifica la veridicità oltre alla validazione del formato. I dati strutturati non sostituiscono la qualità della pagina, la disponibilità dei contenuti, l’indicizzazione, la politica del motore di ricerca né la configurazione di Google Search Console. Il risultato deve essere verificato sulla pagina pubblicata del negozio specifico dopo aver abilitato le entità appropriate e completato i dati.
Importanti limiti di funzionamento
- Il modulo non invia dati a Google, non segnala indirizzi all’indice e non forza i risultati avanzati.
- Non gestisce il contenuto FAQ. Il file
faq.jsonè materiale per l’importazione di domande e risposte; il modulo Schema.org stesso non lo legge direttamente durante la generazione della pagina. FAQPage,CollectionPageeArticledipendono dai dati effettivamente disponibili nella pagina corrente e dalle integrazioni supportate.- Un tema o modulo personalizzato che non richiama
displayFooteroppure non passa i dati visibili a Smarty richiede una verifica nel negozio specifico. - La versione 1.3.6 dichiara compatibilità con PrestaShop 1.7.0.0–9.99.99; l’ambiente PHP deve allo stesso tempo soddisfare i requisiti della versione di PrestaShop utilizzata.
Link alla demo del modulo:
Demo pannello amministrativo:
https://moduly-prestashop.eu/znaczniki-rozszerzone/admin-dev
Demo front office:
https://moduly-prestashop.eu/znaczniki-rozszerzone
Verifica del corretto funzionamento dei dati strutturati:
https://validator.schema.org