40 lines
2.2 KiB
Markdown
40 lines
2.2 KiB
Markdown
<p align="right"><a href="https://codeberg.org/simonpipe/yellow-mastodonapi/src/branch/main/readme.md">Deutsch</a> <a href="https://codeberg.org/simonpipe/yellow-mastodonapi/src/branch/main/readme-en.md">English</a></p>
|
||
|
||
# MastodonAPI
|
||
|
||
Ein Plug-in, um deine öffentlichen Toots via Mastodon-API in deinen Yellow Blog zu importieren.
|
||
|
||
## Installation
|
||
|
||
1. ZIP-Datei herunterladen
|
||
2. In das Verzeichnis `/system/extensions` kopieren
|
||
3. Deine Website neu laden – das Plug-in ist nun installiert
|
||
|
||
## Benutzung
|
||
|
||
Das Plug-in wird über einen individuellen **Webhook** aufgerufen.
|
||
Beim Aufruf fragt es deine Mastodon-API ab und erstellt aus deinen Toots automatisch Blogbeiträge.
|
||
Optional kannst du einen **#Hashtag** angeben, um nur bestimmte Beiträge zu importieren.
|
||
|
||
## Einstellungen
|
||
|
||
Alle Einstellungen findest du in `system/extensions/yellow-system.ini`:
|
||
|
||
- **MastodonapiInstanceUrl** – URL deiner Mastodon-Instanz (z. B. `https://mastodon.social`)
|
||
- **MastodonapiAccountId** – deine Mastodon-User-ID (numerisch, z. B. `1234567890`)
|
||
- ID bei einem Mastodon-Account finden: Gib im Browser "https://INSTANZURL/api/v1/accounts/lookup?acct=PROFILNAME" ein.
|
||
- ID bei einem GoToSocial-Accoutn finden <a href="https://codeberg.org/simonpipe/yellow-mastodonapi/src/branch/main/gotoso-de.md">(Hilfe)</a>
|
||
- **MastodonapiAccessToken** - Bei einem Mastodon Konto optional, bei einem GoToSocial Konto Pflicht <a href="https://codeberg.org/simonpipe/yellow-mastodonapi/src/branch/main/gotoso-de.md">(Hilfe)</a>
|
||
- **MastodonapiLimit** - Standartwert ist 20
|
||
- **MastodonapiHashtag** – leer lassen = alle öffentlichen Beiträge importieren; mit `#hashtag` = nur Beiträge mit diesem Tag
|
||
- **MastodonapiAuthor** – Name, unter dem die Blogposts erscheinen sollen
|
||
- **MastodonapiTag** – Tag, mit dem die Blogposts im Blog versehen werden
|
||
- **MastodonapiFolder** – Pfad zum Blog-Ordner (z. B. `content/1-blog/`)
|
||
- **MastodonapiTriggerPath** – Webhook-Pfad, z. B. `/mastodonapi-webhook-CHANGE_THIS_SECRET_KEY`
|
||
*(Unbedingt anpassen! Wer diesen Link kennt, kann das Plug-in starten.)*
|
||
|
||
💡 Du kannst den Webhook auch per Cronjob regelmäßig aufrufen (z. B. stündlich).
|
||
|
||
## Entwickler
|
||
|
||
Simon Pipe
|