3.3 KiB
Mastodonapi 0.9
Mastodonapi ist eine Erweiterung für Datenstrom Yellow, um deine öffentlichen Beiträge (Toots) in dein Blog zu importieren. Sie funktioniert mit Mastodon- und GoToSocial-Instanzen.
Installation
Lade die ZIP-Datei herunter und kopiere sie in deinen system/extensions Ordner. Erfahre mehr über Erweiterungen.
Funktionsweise
Das Plugin arbeitet vollautomatisch. Es prüft im Hintergrund regelmäßig, ob neue Beiträge vorhanden sind.
Wenn du die Seite besuchst, fragt es deine Mastodon-API ab und erstellt automatisch Blog-Beiträge aus deinen Toots. Optional kannst du einen #Hashtag angeben, um nur bestimmte Beiträge zu importieren.
Es gibt drei Möglichkeiten, den Import auszulösen:
Automatisch (Lazy Cron): Sobald ein Besucher deine Website aufruft, prüft das Plugin, ob das Update-Intervall abgelaufen ist und lädt bei Bedarf neue Toots.
Über das Terminal: Du kannst den Import manuell auf dem Server starten mit: php yellow.php mastodonapi
Über den System-Cronjob: Falls dein Host Cronjobs unterstützt, kannst du den Befehl php yellow.php mastodonapi regelmäßig ausführen lassen (z. B. alle 30 Minuten).
Einstellungen
Alle Einstellungen befinden sich in system/extensions/yellow-system.ini:
MastodonapiInstanceUrl = deine Mastodon Instanz-URL (z. B. https://mastodon.social)
MastodonapiAccountId = deine Mastodon User-ID (numerisch, z. B. 1234567890)
Finde die ID eines Mastodon-Accounts: Gib "https://DEINE_INSTANZ_URL/api/v1/accounts/lookup?acct=PROFILNAME" in deinen Browser ein. Finde die ID eines GoToSocial-Accounts (siehe hier)
MastodonapiAccessToken = optional für einen Mastodon-Account, zwingend für einen GoToSocial-Account (siehe hier)
MastodonapiUpdateInterval = Zeitintervall zwischen automatischen Updates in Minuten (Standard: 30).
MastodonapiLimit = Anzahl der Toots, die pro Durchgang abgerufen werden (Standard: 20).
MastodonapiHashtag = leer lassen für alle Beiträge; oder mit #hashtag filtern.
MastodonapiAuthor = Name, unter dem die Blog-Beiträge erscheinen sollen.
MastodonapiTag = Tag für die Blog-Beiträge (Standard: Fediverse).
MastodonapiFolder = Pfad zum Blog-Ordner (Standard: content/2-blog/).
MastodonapiMaxAge = Alter der Toots in Stunden, die noch importiert werden sollen. 0 = alle verfügbaren Toots.
MastodonapiStatus = Seitenstatus, Standardwert ist public
Die folgenden Status-Werte werden unterstützt:
public = Seite ist eine normale Seite
draft = Seite ist nicht sichtbar, Benutzer muss eingeloggt sein, erfordert die Draft-Erweiterung
unlisted = Seite ist nicht sichtbar, kann aber mit dem richtigen Link aufgerufen werden
Entwickler
Simon Rohr