Mostrar el hilo en su sitio web
La lectura del hilo es gratuita y sin cuenta, flujos incluidos: mostrar los anuncios de un editor o de un proyecto en su propio sitio no exige registro, ni token, ni autorización.
Los anuncios se publican bajo licencia CC BY-SA 4.0. Una reutilización cita por tanto el nombre del editor, remite al anuncio y nombra la licencia: la extensión y los flujos de abajo llevan esos tres elementos, y quitarlos hace que la copia no esté autorizada.
WordPress, en un solo archivo
Una extensión de un solo archivo, sin dependencias: sin Composer, sin extensión de terceros, sin JavaScript. Cópiela en wp-content/plugins/dolinews-feed/ y actívela, o pegue su contenido al final del functions.php de su tema hijo - una u otra, nunca las dos.
Descargar la extensión (dolinews-feed.php)
El código corto se escribe luego en cualquier bloque, widget de texto o plantilla:
[dolinews editor="mon-editeur" limit="5"]
[dolinews project="mon-module" limit="3" layout="cards"]
[dolinews focus="security" dolibarr="22" title="Correcciones de seguridad"]El slug del editor o del proyecto se lee en la dirección de su ficha en este sitio. Los atributos disponibles:
editor,project,focus,dolibarr,q- los mismos filtros que el hilo.maturity- una lista separada por comas, por ejemplo beta,rc. Sin este atributo, solo se enumeran las versiones estables.locale- el idioma de lectura, como configuración regional de contenido: fr_FR, es_ES, de_DE...limit,layout,summary,title,link_text- la presentación: número de anuncios, lista o tarjetas, resumen mostrado o no, título y texto del enlace.cache- la duración de la caché local en segundos, 900 por omisión. La última respuesta conocida se conserva una semana y se sirve si este sitio deja de responder.
Las pastillas - rango de Dolibarr, madurez y su antigüedad, naturaleza de la publicación, idioma del anuncio - las escribe el servicio en el idioma solicitado. La extensión no traduce ninguna y sigue siendo correcta en los diez idiomas.
Los flujos, para todo lo demás
Fuera de WordPress, los dos flujos genéricos sirven lo mismo y aceptan los mismos filtros como parámetros de dirección.
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[]=betaEl flujo RSS lo lee cualquier agregador. El flujo JSON sigue el formato JSON Feed, y cada entrada lleva además un miembro _dolinews: los valores brutos del anuncio - versión, madurez, rango de Dolibarr, naturaleza, editor, proyecto - y sus etiquetas ya traducidas. Ese miembro es el que lee la extensión de WordPress, y el que hay que leer para mostrar un anuncio en otro sitio.
Un último punto, que evita una decepción: la API responde a las mismas preguntas pero mantiene un filtro de idioma estricto, porque su contrato está congelado. Un anuncio que nadie ha traducido al idioma solicitado no aparece en ella, mientras que el flujo sirve su versión original indicando su idioma. Para mostrar, tome el flujo; para procesar, tome la API.
https://dolinews.com/api/v1/articles?editor=mon-editeur&per_page=10Documentación de la API - Código fuente del servicio y de la extensión
Lo que su sitio no mostrará
Este servicio dice lo que se ha anunciado, y cuándo; nunca el estado actual de un módulo. Una integración que escribiera "módulo compatible con la versión 22" afirmaría lo que nadie ha declarado: el rango mostrado es el que llevaba el anuncio, en su fecha, y la fecha se muestra al lado.
Por la misma razón, una madurez nunca se muestra sin su antigüedad - nadie vuelve para decir que una versión ha salido de su fase de pruebas - y las versiones de prueba están ausentes mientras no se pidan.