Afficher le fil sur votre site

La lecture du fil est gratuite et sans compte, flux compris : afficher les annonces d'un éditeur ou d'un projet sur votre propre site ne demande ni inscription, ni jeton, ni autorisation.

Les annonces sont publiées sous licence CC BY-SA 4.0. Une reprise cite donc le nom de l'éditeur, renvoie vers l'annonce et nomme la licence : l'extension et les flux ci-dessous portent ces trois éléments, les retirer rend la copie non autorisée.

WordPress, en un fichier

Une extension d'un seul fichier, sans dépendance : pas de Composer, pas d'extension tierce, pas de JavaScript. Copiez-la dans wp-content/plugins/dolinews-feed/ et activez-la, ou collez son contenu à la fin du functions.php de votre thème enfant - l'une ou l'autre, jamais les deux.

Télécharger l'extension (dolinews-feed.php)

Le code court s'écrit ensuite dans n'importe quel bloc, widget de texte ou gabarit :

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

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

[dolinews focus="security" dolibarr="22" title="Correctifs de sécurité"]

Le slug de l'éditeur ou du projet se lit dans l'adresse de sa fiche sur ce site. Les attributs disponibles :

editor, project, focus, dolibarr, q - les mêmes filtres que le fil.
maturity - une liste séparée par des virgules, par exemple beta,rc. Sans cet attribut, seules les versions stables sont listées.
locale - la langue de lecture, en locale de contenu : fr_FR, es_ES, de_DE...
limit, layout, summary, title, link_text - la présentation : nombre d'annonces, liste ou cartes, résumé affiché ou non, titre et libellé du lien.
cache - la durée du cache local en secondes, 900 par défaut. La dernière réponse connue est conservée une semaine et sert si ce site devient injoignable.

Les pastilles - plage Dolibarr, maturité et son ancienneté, nature de la publication, langue de l'annonce - sont écrites par le service dans la langue demandée. L'extension n'en traduit aucune et reste correcte dans les dix langues.

Les flux, pour tout le reste

Hors WordPress, les deux flux génériques servent la même chose et acceptent les mêmes filtres en paramètres d'adresse.

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

Le flux RSS se lit par n'importe quel agrégateur. Le flux JSON suit le format JSON Feed, et chaque entrée y porte en plus un membre _dolinews : les valeurs brutes de l'annonce - version, maturité, plage Dolibarr, nature, éditeur, projet - et leurs libellés déjà traduits. C'est ce membre que lit l'extension WordPress, et ce qu'il faut lire pour afficher une annonce ailleurs.

Un dernier point, qui évite une déception : l'API répond aux mêmes questions mais garde un filtre de langue strict, parce que son contrat est figé. Une annonce que personne n'a traduite dans la langue demandée n'y figure pas, là où le flux sert sa version d'origine en signalant sa langue. Pour afficher, prenez le flux ; pour traiter, prenez l'API.

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

Documentation de l'API - Code source du service et de l'extension

Ce que votre site n'affichera pas

Ce service dit ce qui a été annoncé, et quand ; jamais l'état courant d'un module. Une intégration qui écrirait "module compatible avec la version 22" affirmerait ce que personne n'a déclaré : la plage affichée est celle que portait l'annonce, à sa date, et la date est affichée à côté.

Pour la même raison, une maturité n'est jamais montrée sans son ancienneté - personne ne revient dire qu'une version est sortie de sa phase d'essai - et les versions d'essai sont absentes tant qu'on ne les demande pas.