ALLE DE EN
Im Orbit☄ Steam Themen Linux-KernelHome AssistantUbuntuKDE PlasmaFirefoxRaspberry PiSteamFedoraGNOMEBlenderLibreOfficeNextcloudLinux MintPHPThunderbirdopenSUSE Alle Themen →

Für Blogs

PlanetFOSS für dein WordPress-Blog

Ein freies Plugin zeigt deinen Lesern, worüber die Linux- und Open-Source-Nachrichten gerade berichten: eine Themenkarte unter deinen Beiträgen und eine Nachrichtenliste für die Seitenleiste. Es passt sich deinem Theme an und lädt nichts von Dritten.

Herunterladen · 0.2.2 GPL 2.0 oder neuer · WordPress 6.6+ · PHP 8.1+ Ohne WordPress: die Schnittstelle →

Twenty Twenty-Five mit Themenkarte unter einem Beitrag und den Linux-Nachrichten in der Seitenleiste
Im WordPress-Standardtheme Twenty Twenty-Five: Themenkarte unter dem Beitrag, Linux-Nachrichten in der Seitenleiste.

Was es zeigt

  1. 1

    Themenkarte

    Unter einem Beitrag mit dem Schlagwort „KDE Plasma“: das PlanetFOSS-Thema mit kurzer Einleitung, Meldungen und Quellen der letzten 30 Tage, Tagesverlauf, den größten Versionen und einem Link zu allen Meldungen.

  2. 2

    Linux-Nachrichten

    Für die Seitenleiste: die Themen mit den meisten Meldungen der letzten 24 Stunden und der letzten 7 Tage, jeweils mit kleinem Sieben-Tage-Verlauf, dazu der Wochenrückblick.

  3. 3

    Ohne Einrichtung

    Schlagwörter und Kategorien werden automatisch PlanetFOSS-Themen zugeordnet. Ist dein Blog eine PlanetFOSS-Quelle, gilt zuerst dessen eigene Einordnung deiner Beiträge.

  4. 4

    Ohne Tracking

    Dein Server holt die Daten alle 30 Minuten. Deine Leser laden nichts von planetfoss.net – kein Skript, keine Schrift, kein Cookie. Links nennen deine Website als Kampagne (utm_source), damit PlanetFOSS sagen kann, wie viele Leser von dir kamen – nie etwas über den Leser.

Passt zu deinem Theme

Schrift, Text- und Linkfarbe kommen vom Theme, Größen stehen in em, und jede Regel nutzt genau eine Klasse – dein eigenes CSS gewinnt. Schnelle Anpassungen gehen über CSS-Variablen, der Blockstil „Schlicht“ nimmt den Kasten weg, und das Stylesheet lässt sich ganz abschalten.

/* Beispiel: eigene Akzentfarbe, in der Seitenleiste ohne Kasten */
.planetfoss { --planetfoss-accent: #e95420; }
.sidebar .planetfoss { --planetfoss-border: 0; --planetfoss-surface: transparent; --planetfoss-pad: 0; }
.planetfoss__h { font-family: var(--my-heading-font); }

Einbauen

  1. ZIP unter Plugins → Neues Plugin hinzufügen → Plugin hochladen einspielen und aktivieren.
  2. Unter Einstellungen → PlanetFOSS steht, ob der erste Abruf geklappt hat.
  3. Block-Themes: Block „PlanetFOSS-Thema“ im Template für Einzelbeiträge unter den Inhalt, „PlanetFOSS Linux-Nachrichten“ in eine Seitenleiste. Klassische Themes: Widget „PlanetFOSS Linux-Nachrichten“ und die Option „Karte unter Beiträgen“.
  4. Shortcodes für Page-Builder: [planetfoss_topic], [planetfoss_news layout="columns"]

Für Entwickler: die Schnittstelle

Das Plugin ist nur ein Weg zu den Daten. Jede andere Website, App oder jedes Newsletter-Werkzeug kann dasselbe JSON abrufen – kostenlos, ohne Anmeldung, unter der Lizenz weiter unten.

GET https://planetfoss.net/api/verbund/v1/themen.json?lang=de
curl 'https://planetfoss.net/api/verbund/v1/themen.json?lang=de&site=example.org'
lang
de oder en: Sprache der Einleitungen und Links (Standard de).
site
Freiwillig: Hostname deiner Website. Ist sie eine PlanetFOSS-Quelle, enthält posts die Themen, die PlanetFOSS deinen Beiträgen gegeben hat.
topics
Jedes Thema mit mindestens zwei Meldungen in 30 Tagen, nach Schlüssel: label, url, feed, intro, n (Meldungen), sources, de/en, days (30 Tageswerte, älteste zuerst), versions.
now, top7
Themen mit den meisten Meldungen der letzten 24 Stunden (n24, sources24) und der letzten 7 Tage (n, sources), jeweils mit status (supernova, komet, nachgluehen) und days7.
week
Supernovas der letzten 7 Tage, Links zu Wochenrückblick und Logbuch.
license, terms_url
Lizenz (CC BY 4.0) und die Bedingungen unten.

Nur, was PlanetFOSS selbst erzeugt: keine Schlagzeilen oder Texte der Quellen. Die Antwort wird alle paar Minuten erneuert und zehn Minuten zwischengespeichert; ruf sie höchstens alle zehn Minuten ab. Ohne Schlüssel gilt eine Grenze von einigen Abrufen pro Stunde und Server (HTTP 429 mit Retry-After). Innerhalb von v1 kommen nur Felder dazu; was bricht, bekommt eine neue Adresse.

Lizenz und Nutzungsbedingungen

Die Daten des Exports – Themennamen, Einleitungen, Zählungen und Verläufe – stehen unter Creative Commons Namensnennung 4.0 International (CC BY 4.0). Du darfst sie nutzen, verändern und weitergeben, auch kommerziell, solange du:

  • PlanetFOSS als Quelle mit Link auf planetfoss.net (oder die Themenseite) nennst,
  • die Lizenz CC BY 4.0 mit Link angibst und
  • kenntlich machst, wenn du die Daten verändert hast.

Das Plugin erledigt das von selbst. Nicht umfasst sind die Beiträge der Quellen, auf die PlanetFOSS verlinkt, und das PlanetFOSS-Logo.

Nutzung der Schnittstelle

  • Kostenlos und ohne Anmeldung. Ohne Schlüssel gilt eine Grenze von einigen Abrufen pro Stunde und Server (das Plugin braucht zwei).
  • Die Antwort ändert sich höchstens alle zehn Minuten – bitte nicht öfter abrufen.
  • Eine Verfügbarkeit ist nicht zugesagt. PlanetFOSS kann den Export ändern (neue Fassungen bekommen eine eigene Adresse) und Server sperren, die die Schnittstelle überlasten.
  • Was dein Server sendet: Sprache, Hostname deiner Website und ihre Adresse im User-Agent – nichts über deine Leser. PlanetFOSS zählt Abrufe je Host; für die Grenze speichert es einen nicht umkehrbaren Hash der Server-IP höchstens zwei Stunden. Klicks aus den Kästen zählen wir je Website als Tagessumme; Website-Namen bleiben 90 Tage. Frag uns, wie viele Leser von dir kamen. Datenschutz