Den Feed auf Ihrer Website anzeigen

Das Lesen des Feeds ist kostenlos und ohne Konto, Feeds eingeschlossen: die Ankündigungen eines Herausgebers oder eines Projekts auf Ihrer eigenen Website anzuzeigen verlangt keine Anmeldung, kein Token und keine Genehmigung.

Die Ankündigungen werden unter der Lizenz CC BY-SA 4.0 veröffentlicht. Eine Übernahme nennt daher den Namen des Herausgebers, verweist auf die Ankündigung und nennt die Lizenz: die Erweiterung und die Feeds unten tragen diese drei Angaben, und sie zu entfernen macht die Kopie unzulässig.

Eine Erweiterung aus einer einzigen Datei, ohne Abhängigkeit: kein Composer, keine fremde Erweiterung, kein JavaScript. Kopieren Sie sie nach wp-content/plugins/dolinews-feed/ und aktivieren Sie sie, oder fügen Sie ihren Inhalt am Ende der functions.php Ihres Child-Themes ein - das eine oder das andere, niemals beides.

Der Shortcode kommt anschließend in jeden Block, jedes Text-Widget oder jede Vorlage:

Der Slug eines Herausgebers oder eines Projekts steht in der Adresse seiner Seite auf dieser Website. Die verfügbaren Attribute:

• editor, project, focus, dolibarr, q - dieselben Filter wie im Feed.
• maturity - eine durch Kommas getrennte Liste, etwa beta,rc. Ohne dieses Attribut werden nur stabile Versionen aufgeführt.
• locale - die Lesesprache, als Inhaltsgebietsschema: fr_FR, es_ES, de_DE...
• limit, layout, summary, title, link_text - die Darstellung: Anzahl der Ankündigungen, Liste oder Karten, Zusammenfassung angezeigt oder nicht, Titel und Linktext.
• cache - die Dauer des lokalen Zwischenspeichers in Sekunden, standardmäßig 900. Die letzte bekannte Antwort wird eine Woche aufbewahrt und ausgeliefert, wenn diese Website nicht erreichbar ist.

Die Kennzeichen - Dolibarr-Bereich, Reifegrad und dessen Alter, Art der Veröffentlichung, Sprache der Ankündigung - werden vom Dienst in der angeforderten Sprache geschrieben. Die Erweiterung übersetzt keines davon und bleibt in allen zehn Sprachen richtig.

Außerhalb von WordPress liefern die beiden allgemeinen Feeds dasselbe und nehmen dieselben Filter als Adressparameter.

Der RSS-Feed wird von jedem Aggregator gelesen. Der JSON-Feed folgt dem Format JSON Feed, und jeder Eintrag trägt zusätzlich ein Element _dolinews: die Rohwerte der Ankündigung - Version, Reifegrad, Dolibarr-Bereich, Art, Herausgeber, Projekt - und deren bereits übersetzte Bezeichnungen. Dieses Element liest die WordPress-Erweiterung, und es ist das, was man lesen muss, um eine Ankündigung anderswo anzuzeigen.

Ein letzter Punkt, der eine Enttäuschung erspart: die API antwortet auf dieselben Fragen, behält aber einen strengen Sprachfilter, weil ihr Vertrag festgeschrieben ist. Eine Ankündigung, die niemand in die angeforderte Sprache übersetzt hat, fehlt dort, während der Feed die Originalfassung ausliefert und deren Sprache nennt. Zum Anzeigen nehmen Sie den Feed, zum Verarbeiten die API.

Dieser Dienst sagt, was angekündigt wurde und wann; niemals den aktuellen Zustand eines Moduls. Eine Integration, die "Modul kompatibel mit Version 22" schriebe, würde behaupten, was niemand erklärt hat: der angezeigte Bereich ist der, den die Ankündigung an ihrem Datum trug, und das Datum steht daneben.

Aus demselben Grund wird ein Reifegrad nie ohne sein Alter angezeigt - niemand kommt zurück, um zu sagen, dass eine Version ihre Testphase verlassen hat - und Testversionen fehlen, solange sie nicht angefordert werden.