51 lines
3.2 KiB
Markdown
51 lines
3.2 KiB
Markdown
<p align="right"><a href="https://codeberg.org/simonpipe/yellow-mastodonapi/src/branch/main/readme-de.md">Deutsch</a> <a href="https://codeberg.org/simonpipe/yellow-mastodonapi/src/branch/main/readme.md">English</a></p>
|
|
|
|
# Mastodonapi 0.9.6
|
|
|
|
Importiere deine Toots von Mastodon- und GoToSocial-Instanzen in deinen Blog.
|
|
|
|
## Installation
|
|
|
|
<a href="https://codeberg.org/simonpipe/yellow-mastodonapi/archive/main.zip">Lade die ZIP-Datei herunter</a> und kopiere sie in deinen system/extensions Ordner. <a target="blank_" href="https://github.com/annaesvensson/yellow-update">Erfahre mehr über Erweiterungen</a>.
|
|
|
|
## 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 <a href="https://codeberg.org/simonpipe/yellow-mastodonapi/src/branch/main/help-gotoso-de.md">(siehe hier)</a>*
|
|
|
|
`MastodonapiAccessToken` = optional für einen Mastodon-Account, zwingend für einen GoToSocial-Account <a href="https://codeberg.org/simonpipe/yellow-mastodonapi/src/branch/main/help-gotoso-de.md">(siehe hier)</a>
|
|
`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 <a target="blank_" href="https://github.com/annaesvensson/yellow-draft">Draft-Erweiterung</a>
|
|
`unlisted` = Seite ist nicht sichtbar, kann aber mit dem richtigen Link aufgerufen werden
|
|
|
|
## Entwickler
|
|
|
|
Simon Rohr
|