Deutsch English
# 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:
1. **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.
2. **Über das Terminal:** Du kannst den Import manuell auf dem Server starten mit: php yellow.php mastodonapi
3. **Ü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