Mastodon — Connect it to MokonyxSocial

Once connected, MokonyxSocial posts your new content to Mastodon as a status (a "toot"), and can include an image. Mastodon posts are usually capped at 500 characters, though some servers allow more or less.

What you need

• A Mastodon account on any server (like mastodon.social).
• The ability to log in to that account and open its settings — you'll create a small "application" there to get a token.
• That's it — there's no special developer sign-up for Mastodon.

Get your credentials

Instance URL — instance_url (required)

This is simply the web address of the Mastodon server your account is on.

1. Look at the address bar when you're logged into Mastodon — the part like https://mastodon.social.
2. Type that into MokonyxSocial exactly as https://your-server (no slash at the end, and don't include your username).

Access token — access_token (required)

This is a secret key that lets MokonyxSocial post for you. You'll make it by creating a little "application" on your own account.

1. Log in to Mastodon in your web browser.
2. Go to Preferences → Development. (Shortcut: type https://your-server/settings/applications in the address bar, replacing your-server with your server's address.)
3. Click New application.
4. Name it something like "MokonyxSocial". You can leave the redirect field as it is.
5. In the list of permissions (scopes), tick write:statuses so it can post, and write:media so it can attach images. You can leave the rest unchecked.
6. Click Submit (or Save changes).
7. Click the application you just made. Near the top you'll see Your access token — copy that and paste it into MokonyxSocial. (Ignore the "Client key" and "Client secret" — you don't need those.)

Set it up in MokonyxSocial

1. In your Joomla admin, go to Components → MokonyxSocial → Services → New.
2. Choose Mastodon.
3. Paste in the credentials from above.
4. Click Send Test to check the connection, then Save & Close and make sure the service is Published.

Verify

• Send Test should confirm your token works and show your account name.
• Publish some content, then open your Mastodon profile — your new post (with any image) should be right there in your timeline.

Troubleshooting

• It says the token is invalid — The token was copied wrong or from the wrong place. Go back to Development, open your application, and re-copy Your access token.
• It connects but won't post — Your application is missing the write:statuses permission. You'll need to create the application again with that box ticked (Mastodon usually won't let you add permissions afterward).
• The image didn't attach — Add the write:media permission, or the image may be too big for your server's limits.
• It can't find your server — Make sure the instance URL is just https://your-server with no extra slash, path, or username.

Notes & limits

• Most Mastodon servers limit posts to 500 characters. If your content is longer, the server will reject it.
• Whether images or videos are allowed (and how large) depends on your server.
• Posting very rapidly can get temporarily slowed by your server.
• If you delete the application in Development, this connection stops working immediately.