SOQVER Preparate una fonte
Italiano

SO4AG Facts per WordPress

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.

Cosa pubblica il plugin sul Suo sito

Un file per i programmi

https://your-site.com/so4ag.json

Tutti i dati nel formato aperto SO4AG. Chiunque può leggerli senza chiave né registrazione.

Una pagina per le persone

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].

Dati strutturati

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.

Come funziona

1. Inserisca i dati

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.

2. Li confermi

La pubblicazione richiede sempre che Lei confermi esplicitamente la veridicità dei dati.

3. I dati sono pubblici in tre forme

Il file, la pagina e il JSON-LD riportano sempre la stessa versione, l’ultima confermata. Le modifiche in corso restano private.

4. Il plugin monitora le scadenze

Ogni dato ha un ultimo giorno di validità. Due settimane prima, il pannello di amministrazione Le ricorda di rivederlo e confermarlo di nuovo.

Cosa include ogni dato

Guida passo dopo passo

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

1. Installi il plugin

  1. Scarichi il file ZIP da questa pagina. Nel pannello di amministrazione di WordPress apra Plugins → Add New → Upload Plugin, scelga il file scaricato e selezioni Install Now.
  2. Selezioni Activate. Nel menu di amministrazione compare la nuova voce SO4AG Facts.

2. Indichi al plugin chi è

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.

3. Aggiunga i suoi dati

Nella scheda Facts scelga un tipo di dato e selezioni Add. Per ogni dato vengono richiesti quattro elementi:

  1. Il valore, oppure We do not state this o It does not apply to us.
  2. Condizioni (Applies to): solo quelle da cui il dato dipende effettivamente.
  3. L’ultimo giorno di validità (Applies until).
  4. La pagina del Suo sito in cui è riportato il dato (Page that states it). Se lascia il campo vuoto, il dato viene pubblicato come una Sua dichiarazione.
DatoDove trovarloCondizione obbligatoriaPiù lungo
Operatorepiè di pagina, condizioni–400 giorni
Sedepagina dei contatti: indirizzo e orari–180 giorni
Contattopagina dei contattichannel180 giorni
Prezzolistino prezziitem60 giorni
Metodi di pagamentocondizioni, finalizzazione dell’acquisto–180 giorni
Prenotazione obbligatoria, Tempo di rispostapagina di prenotazione, pagina dei contatti–90 giorni
Cancellazione gratuita, Penale di cancellazionecondizioni di cancellazione–90 giorni
Garanziacondizioni di garanzia–180 giorni
Accetta nuovi clientipagina dei contatti–30 giorni
Costo di spedizionepagina delle spedizionicountry, delivery_method60 giorni
Spedizione gratuita a partire da, Supplemento per il contrassegnopagina delle spedizionicountry / –60 giorni
Termine per il reso, Durata della garanziapolitica 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.

4. Come usare le condizioni

5. Un negozio con WooCommerce

Il 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).

6. Confermi e pubblichi

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.

7. Mostri i dati su una pagina

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.

8. Verifichi il risultato

  1. Nella scheda Output and check, selezioni Check the public addresses too. Il controllo verifica la struttura del file, le date e che la pagina contenga gli stessi dati del file.
  2. Apra l’indirizzo del file in un browser: https://your-site.com/so4ag.json
  3. Per un’ulteriore verifica, incolli l’indirizzo nel validatore pubblico.

9. Mantenga aggiornati i dati

Un 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:

10. llms.txt

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.

11. Risoluzione dei problemi

Che cosa vedeChe 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 fileLa cache contiene una copia precedente della pagina. La svuoti e ripeta il controllo.
La pagina non contiene JSON-LDLa pagina non contiene né il blocco né lo shortcode, oppure il tema non richiama wp_footer().
Il plugin rifiuta una dataPer 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 httpIl file è disponibile, ma i programmi si aspettano di accedervi tramite https.

Cosa non fa il plugin

Per sviluppatori e agenzie

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

Domande frequenti

Mi serve un account o un servizio a pagamento?

No. Il plugin da solo gestisce l’inserimento dei dati, la pubblicazione, il file, la pagina, il JSON-LD e la verifica.

Funziona con il mio plugin SEO?

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.

Cosa succede quando un dato arriva a scadenza?

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.

Cosa viene rimosso quando elimino il plugin?

Vengono rimossi le impostazioni del plugin, i dati in lavorazione e la versione pubblicata. Le pagine che ha creato restano, senza la tabella.

Scarica il plugin (ZIP, versione 0.1.0)