Afișarea fluxului pe propriul site

Citirea fluxului este gratuită și fără cont, fluxurile incluse: afișarea anunțurilor unui editor sau ale unui proiect pe propriul site nu necesită înscriere, token sau autorizație.

Anunțurile sunt publicate sub licența CC BY-SA 4.0. O preluare citează deci numele editorului, trimite la anunț și numește licența: extensia și fluxurile de mai jos conțin aceste trei elemente, iar eliminarea lor face copia neautorizată.

WordPress, într-un singur fișier

O extensie într-un singur fișier, fără dependențe: fără Composer, fără extensii terțe, fără JavaScript. Copiați-o în wp-content/plugins/dolinews-feed/ și activați-o, sau lipiți conținutul la sfârșitul fișierului functions.php al temei copil - una sau alta, niciodată ambele.

Descărcați extensia (dolinews-feed.php)

Codul scurt se scrie apoi în orice bloc, widget de text sau șablon:

[dolinews editor="mon-editeur" limit="5"]

[dolinews project="mon-module" limit="3" layout="cards"]

[dolinews focus="security" dolibarr="22" title="Corecții de securitate"]

Slug-ul editorului sau al proiectului se citește în adresa fișei sale de pe acest site. Atributele disponibile:

editor, project, focus, dolibarr, q - aceleași filtre ca fluxul.
maturity - o listă separată prin virgule, de exemplu beta,rc. Fără acest atribut, sunt listate numai versiunile stabile.
locale - limba de citire, ca locală de conținut: fr_FR, es_ES, de_DE...
limit, layout, summary, title, link_text - prezentarea: numărul de anunțuri, listă sau carduri, rezumat afișat sau nu, titlu și text al legăturii.
cache - durata memoriei cache locale în secunde, 900 implicit. Ultimul răspuns cunoscut este păstrat o săptămână și este servit dacă acest site devine inaccesibil.

Etichetele - intervalul Dolibarr, maturitatea și vechimea ei, natura publicării, limba anunțului - sunt scrise de serviciu în limba cerută. Extensia nu traduce niciuna și rămâne corectă în cele zece limbi.

Fluxurile, pentru tot restul

În afara WordPress, cele două fluxuri generice servesc același lucru și acceptă aceleași filtre ca parametri de adresă.

https://dolinews.com/feeds.xml?editor=mon-editeur

https://dolinews.com/feeds.json?project=mon-module&focus=security

https://dolinews.com/feeds.xml?dolibarr=22&maturity[]=beta

Fluxul RSS este citit de orice agregator. Fluxul JSON urmează formatul JSON Feed, iar fiecare intrare poartă în plus un membru _dolinews: valorile brute ale anunțului - versiune, maturitate, interval Dolibarr, natură, editor, proiect - și etichetele lor deja traduse. Acest membru îl citește extensia WordPress și el trebuie citit pentru a afișa un anunț în altă parte.

Un ultim punct, care evită o dezamăgire: API-ul răspunde la aceleași întrebări, dar păstrează un filtru de limbă strict, pentru că contractul său este fixat. Un anunț pe care nimeni nu l-a tradus în limba cerută nu apare în el, în timp ce fluxul servește versiunea de origine semnalând limba ei. Pentru afișare, luați fluxul; pentru prelucrare, luați API-ul.

https://dolinews.com/api/v1/articles?editor=mon-editeur&per_page=10

Documentația API - Codul sursă al serviciului și al extensiei

Ce nu va afișa site-ul dumneavoastră

Acest serviciu spune ce a fost anunțat și când; niciodată starea curentă a unui modul. O integrare care ar scrie "modul compatibil cu versiunea 22" ar afirma ceea ce nimeni nu a declarat: intervalul afișat este cel pe care îl purta anunțul, la data sa, iar data este afișată alături.

Din același motiv, o maturitate nu este niciodată arătată fără vechimea sa - nimeni nu revine să spună că o versiune a ieșit din faza de încercare - iar versiunile de încercare lipsesc atât timp cât nu sunt cerute.