Skip to content

Setup module

indigoxela edited this page Apr 21, 2023 · 7 revisions

After installation the module needs to be configured.

First you have to set up a Mastodon Application with an access token:

mastodon-app-setup

Application name can be anything you want, it will get displayed next to the date.

Required permissions:

  • read:accounts
  • read:statuses
  • write:statuses

Save, then open again and copy "Your access token".

Now switch to your Backdrop CMS site, logged in as admin:

module-settings

Instance URL and Access token are required and should be self-explaining.

If you actually want the module to do something, choose a "Content type for toots", the rest is optional.

Hint: when still testing, it might make sense to switch the "Toot visibility" setting to unlisted or private.

You might want to make sure, the token actually works. To do so switch to the "Verify credentials" tab. Hit the "Check" button. You should get a success message:

verify-token

In case of problems the next step depends on the error. The reason can be anything, like a typo in the URL, or or an outdated token. Or possibly your Backdrop install isn't able to do HTTP request. Or possibly a problem with your instance.

The error displayed should help to narrow down the root cause and fix it.

If everything went fine, you can start to post on your site and automatically on your Mastodon instance (the whole Fediverse, actually).

This is what a result might look like:

status-post

The first content line is the node title, followed by the shortened body text (the configured "Field for additional text"), followed by hashtags converted from Backdrop taxonomy terms, followed by the link to your node.

If you want a card as link (a fancy formatted link), you have to setup metatags on your Backdrop site.

Clone this wiki locally