Un plugin gratuito che pubblica i dati della Sua attività sul Suo sito, così che gli assistenti AI e gli altri programmi possano usarli correttamente e capire cosa si applica, a chi e fino a quando. Prezzi, orari, pagamenti, spedizioni, cancellazioni e garanzie.
Scarica il plugin (ZIP, versione 0.1.0) Legga la guida
Gratuito, senza account né funzionalità a pagamento. Compatibile con WooCommerce. WordPress 6.4 o successivo, PHP 7.4 o successivo. Licenza GPL-2.0-or-later.
https://your-site.com/so4ag.json
Tutti i dati nel formato aperto SO4AG. Chiunque può leggerli senza chiave né registrazione.
Una tabella «Dati e condizioni» inseribile in qualsiasi pagina. Per ogni dato mostra il valore, a chi si applica e fino a quando.
Si inserisce con un blocco o con lo shortcode [so4ag_facts].
Gli stessi dati in formato JSON-LD (schema.org) nel codice della pagina, per i motori di ricerca e gli strumenti che già leggono JSON-LD.
Dal pannello di amministrazione di WordPress. Con WooCommerce basta un pulsante per iniziare. Il plugin suggerisce i costi di spedizione e i metodi di pagamento in base alle impostazioni del Suo negozio.
La pubblicazione richiede sempre che Lei confermi esplicitamente la veridicità dei dati.
Il file, la pagina e il JSON-LD riportano sempre la stessa versione, l’ultima confermata. Le modifiche in corso restano private.
Ogni dato ha un ultimo giorno di validità. Due settimane prima, il pannello di amministrazione Le ricorda di rivederlo e confermarlo di nuovo.
I nomi delle schede e dei pulsanti qui sotto corrispondono a quelli visualizzati nel plugin.
Indice: 1. Installazione · 2. La Sua attività · 3. Aggiunta dei dati · 4. Condizioni · 5. WooCommerce · 6. Pubblicazione · 7. La pagina · 8. Verifica · 9. Aggiornamento dei dati · 10. llms.txt · 11. Risoluzione dei problemi
Nella scheda Business verifichi il nome della Sua attività, scelga il tipo di attività e, se lo desidera, aggiunga gli identificativi di registrazione (uno schema e un valore, ad esempio ein e il Suo EIN, oppure vat e un numero di partita IVA). Il recapito per le rettifiche è facoltativo e pubblico.
Nella scheda Facts scelga un tipo di dato e selezioni Add. Per ogni dato vengono richiesti quattro elementi:
| Dato | Dove trovarlo | Condizione obbligatoria | Più lungo |
|---|---|---|---|
| Operatore | piè di pagina, condizioni | – | 400 giorni |
| Sede | pagina dei contatti: indirizzo e orari | – | 180 giorni |
| Contatto | pagina dei contatti | channel | 180 giorni |
| Prezzo | listino prezzi | item | 60 giorni |
| Metodi di pagamento | condizioni, finalizzazione dell’acquisto | – | 180 giorni |
| Prenotazione obbligatoria, Tempo di risposta | pagina di prenotazione, pagina dei contatti | – | 90 giorni |
| Cancellazione gratuita, Penale di cancellazione | condizioni di cancellazione | – | 90 giorni |
| Garanzia | condizioni di garanzia | – | 180 giorni |
| Accetta nuovi clienti | pagina dei contatti | – | 30 giorni |
| Costo di spedizione | pagina delle spedizioni | country, delivery_method | 60 giorni |
| Spedizione gratuita a partire da, Supplemento per il contrassegno | pagina delle spedizioni | country / – | 60 giorni |
| Termine per il reso, Durata della garanzia | politica di reso, condizioni | – | 180 giorni |
Il plugin offre 25 dati per qualsiasi attività e 10 per un negozio online. «Durata massima» indica il periodo più lungo per cui si può confermare un dato in una sola volta. Il plugin non accetta date successive a tale limite.
customer: business vale solo per le aziende. Un programma che cerca il prezzo per un privato non lo userà.any indica esplicitamente «vale per qualsiasi valore».item). Per un programma, «pulizia dei denti» e «pulizia» sono due cose diverse.Mo-Fr 09:00-18:00; Sa 09:00-12:00Il pulsante Suggest from the shop legge le impostazioni del Suo negozio e prepara i seguenti suggerimenti:
Per ogni suggerimento, scelga Accept, Complete o Dismiss. I suggerimenti non sono pubblici. Il plugin segnala in una nota ciò che non riesce a leggere dalle impostazioni (un prezzo calcolato con una formula, la spedizione gratuita solo con un codice promozionale, i corrieri gestiti da altri plugin).
La scheda Confirm and publish mostra quali dati saranno pubblici e che cosa è cambiato dall’ultima volta. Spunti la casella per confermare che i dati sono corretti alla data odierna e selezioni Confirm and publish. Da quel momento, ogni modifica resterà privata fino alla conferma successiva.
Per ritirare i dati dalla pubblicazione, usi Withdraw nella stessa scheda. I dati di lavoro vengono conservati.
Nella scheda Output and check, selezioni Create a draft page "Facts and terms", controlli la pagina, la pubblichi e aggiunga un link nel piè di pagina del sito. Per inserire i dati in una Sua pagina, aggiunga il blocco Facts and terms o lo shortcode:
[so4ag_facts]
[so4ag_facts heading="no"]
[so4ag_facts level="h3"]
Il plugin non aggiunge link o badge al sito e non modifica il contenuto generato dagli altri plugin. Il JSON-LD compare solo nelle pagine in cui inserisce i dati.
https://your-site.com/so4ag.jsonUn dato scaduto rimane nel file, ma i programmi lo trattano come dato storico e la tabella lo segnala. Il pannello di amministrazione la avvisa 14 giorni prima della scadenza. Una frequenza ragionevole per gli aggiornamenti:
Il plugin può rispondere all’indirizzo /llms.txt con un breve file che rimanda ai Suoi dati. La funzione è disattivata per impostazione predefinita e può attivarla nella scheda Output and check. Se il sito dispone già di un file llms.txt, il plugin lo lascia intatto e mostra le righe che può aggiungere manualmente.
| Che cosa vede | Che cosa fare |
|---|---|
/so4ag.json restituisce «non trovato» | Il server web non ha inoltrato a WordPress la richiesta per quell’indirizzo. Attivi i permalink leggibili (Settings → Permalinks) o chieda al Suo provider di hosting di inoltrare a WordPress le richieste per i file mancanti. Nel frattempo, può usare l’indirizzo /?so4ag_facts=json. |
| Il controllo segnala che la pagina contiene dati diversi da quelli del file | La cache contiene una copia precedente della pagina. La svuoti e ripeta il controllo. |
| La pagina non contiene JSON-LD | La pagina non contiene né il blocco né lo shortcode, oppure il tema non richiama wp_footer(). |
| Il plugin rifiuta una data | Per ogni tipo di dato c’è un periodo massimo per cui si può confermarne la validità. Scelga una data più vicina e confermi di nuovo il dato in seguito. |
| Il sito usa http | Il file è disponibile, ma i programmi si aspettano di accedervi tramite https. |
Si occupa di creare o gestire siti per i Suoi clienti? La configurazione dei dati è un lavoro che fattura direttamente. Poiché i dati hanno una validità limitata, occorre che qualcuno li riveda regolarmente. Se un cliente attiva anche il monitoraggio offerto da SOQVER, il programma partner Le riconosce una quota di quell’abbonamento. L’account e i dati appartengono al cliente.
Programma partner Il formato e gli strumenti per sviluppatori
Il codice sorgente del plugin è incluso nel pacchetto con licenza GPL-2.0-or-later. SO4AG è un formato aperto ancora in fase di bozza. La specifica, il validatore e gli strumenti di lettura sono gratuiti. Specifica · GitHub
No. Il plugin da solo gestisce l’inserimento dei dati, la pubblicazione, il file, la pagina, il JSON-LD e la verifica.
Sì. Il plugin non modifica ciò che generano gli altri plugin. Aggiunge il proprio blocco JSON-LD solo alle pagine in cui inserisce i dati.
Il dato rimane nel file, ma i programmi lo considerano un dato storico e la tabella lo segnala come non più valido. Lo riveda, imposti una nuova data e lo confermi di nuovo.
Vengono rimossi le impostazioni del plugin, i dati in lavorazione e la versione pubblicata. Le pagine che ha creato restano, senza la tabella.