52 lines
3.1 KiB
Markdown
52 lines
3.1 KiB
Markdown
<p align="right"><a href="https://git.thepipes.ch/simon/yellow-mastodonapi/src/branch/main/readme-de.md">Deutsch</a> <a href="https://git.thepipes.ch/simon/yellow-mastodonapi/src/branch/main/readme.md">English</a></p>
|
|
|
|
# Mastodonapi 0.9.9
|
|
|
|
Import your toots into your blog. Tested with <a href="https://comam.es/what-is-snac">Snac</a>.
|
|
|
|
## Installation
|
|
|
|
<a href="https://git.thepipes.ch/simon/yellow-mastodonapi/archive/main.zip">Download ZIP file</a> and copy it into your `system/extensions` folder. <a target="blank_" href="https://github.com/annaesvensson/yellow-update">Learn more about extensions</a>.
|
|
|
|
## How to
|
|
|
|
The plugin works fully automatically. It regularly checks in the background if there are new posts.
|
|
|
|
When you visit the site, it queries your Mastodon API and automatically creates blog posts from your Toots. Optionally, you can specify a #Hashtag to import only certain posts.
|
|
|
|
There are three ways to trigger the import:
|
|
|
|
1. **Automatic (Lazy Cron):** As soon as a visitor accesses your website, the plugin checks if the update interval has expired and loads new Toots if necessary.
|
|
2. **From the terminal:** You can manually start the import on the server with: `php yellow.php mastodonapi`
|
|
3. **From the system cronjob:** If your host supports cronjobs, you can have the command `php yellow.php mastodonapi` run regularly (e.g. every 30 minutes).
|
|
|
|
## Settings
|
|
|
|
All settings are in `system/extensions/yellow-system.ini`:
|
|
|
|
`MastodonapiInstanceUrl` = your Mastodon instance URL (e.g. https://mastodon.social)
|
|
`MastodonapiAccountId` = your Mastodon user ID (numeric, e.g. 1234567890)
|
|
|
|
*Find the ID of a Snac or Mastodon account: Enter "https://YOUR_INSTANCE_URL/api/v1/accounts/lookup?acct=PROFILNAME" in your browser.*
|
|
*Find the ID of a GoToSocial account <a href="https://git.thepipes.ch/simon/yellow-mastodonapi/src/branch/main/help-en.md">(see here)</a>*
|
|
|
|
`MastodonapiAccessToken` = optional for a Mastodon account, mandatory for a GoToSocial account <a href="https://git.thepipes.ch/simon/yellow-mastodonapi/src/branch/main/help-en.md">(How do I get a token?)</a>
|
|
`MastodonapiUpdateInterval` = time interval between automatic updates in minutes (default: 30)
|
|
`MastodonapiLimit` = number of Toots retrieved per run (default: 20)
|
|
`MastodonapiHashtag` = leave blank for all posts; or filter with #hashtag
|
|
`MastodonapiAuthor` = name under which the blog posts should appear
|
|
`MastodonapiTag` = tag for the blog posts (default: Fediverse)
|
|
`MastodonapiFolder` = path to the blog folder (default: content/2-blog/)
|
|
`MastodonapiMaxAge` = age of Toots in hours that should still be imported. 0 = all available Toots
|
|
`MastodonapiStatus` = page status, default value is public
|
|
|
|
The following status values are supported:
|
|
|
|
`public` = page is a normal page
|
|
`draft` = page is not visible, user needs to log in, requires <a target="blank_" href="https://github.com/annaesvensson/yellow-draft">draft extension</a>
|
|
`unlisted` = page is not visible, but can be accessed with the correct link
|
|
|
|
## Developer
|
|
|
|
Simon Rohr
|
|
*Fediverse: <a href="https://snac.thepipes.ch/simon">@simon@snac.thepipes.ch</a>*
|