Mostrare il flusso sul vostro sito

La lettura del flusso è gratuita e senza account, flussi compresi: mostrare gli annunci di un editore o di un progetto sul vostro sito non richiede né iscrizione, né token, né autorizzazione.

Gli annunci sono pubblicati con licenza CC BY-SA 4.0. Una ripresa cita quindi il nome dell'editore, rimanda all'annuncio e nomina la licenza: l'estensione e i flussi qui sotto portano questi tre elementi, e rimuoverli rende la copia non autorizzata.

Un'estensione di un solo file, senza dipendenze: niente Composer, nessuna estensione di terze parti, nessun JavaScript. Copiatela in wp-content/plugins/dolinews-feed/ e attivatela, oppure incollate il suo contenuto alla fine del functions.php del vostro tema figlio - l'una o l'altra, mai entrambe.

Lo shortcode si scrive poi in qualsiasi blocco, widget di testo o modello:

Lo slug dell'editore o del progetto si legge nell'indirizzo della sua scheda su questo sito. Gli attributi disponibili:

• editor, project, focus, dolibarr, q - gli stessi filtri del flusso.
• maturity - un elenco separato da virgole, per esempio beta,rc. Senza questo attributo sono elencate solo le versioni stabili.
• locale - la lingua di lettura, come locale di contenuto: fr_FR, es_ES, de_DE...
• limit, layout, summary, title, link_text - la presentazione: numero di annunci, elenco o schede, riassunto mostrato o no, titolo e testo del collegamento.
• cache - la durata della cache locale in secondi, 900 per impostazione predefinita. L'ultima risposta conosciuta è conservata per una settimana ed è servita se questo sito diventa irraggiungibile.

Le pastiglie - intervallo Dolibarr, maturità e la sua anzianità, natura della pubblicazione, lingua dell'annuncio - sono scritte dal servizio nella lingua richiesta. L'estensione non ne traduce nessuna e resta corretta nelle dieci lingue.

Fuori da WordPress, i due flussi generici servono la stessa cosa e accettano gli stessi filtri come parametri di indirizzo.

Il flusso RSS si legge con qualsiasi aggregatore. Il flusso JSON segue il formato JSON Feed, e ogni voce porta in più un membro _dolinews: i valori grezzi dell'annuncio - versione, maturità, intervallo Dolibarr, natura, editore, progetto - e le loro etichette già tradotte. È questo membro che legge l'estensione WordPress, ed è quello da leggere per mostrare un annuncio altrove.

Un ultimo punto, che evita una delusione: l'API risponde alle stesse domande ma mantiene un filtro di lingua stretto, perché il suo contratto è fissato. Un annuncio che nessuno ha tradotto nella lingua richiesta non vi compare, mentre il flusso serve la sua versione d'origine segnalandone la lingua. Per mostrare, prendete il flusso; per elaborare, prendete l'API.

Questo servizio dice ciò che è stato annunciato, e quando; mai lo stato attuale di un modulo. Un'integrazione che scrivesse "modulo compatibile con la versione 22" affermerebbe ciò che nessuno ha dichiarato: l'intervallo mostrato è quello che portava l'annuncio, alla sua data, e la data è mostrata accanto.

Per la stessa ragione, una maturità non è mai mostrata senza la sua anzianità - nessuno torna a dire che una versione è uscita dalla fase di prova - e le versioni di prova sono assenti finché non vengono chieste.