Documentation

Configuration

Configuration Guide

Step 1: Create a Mastodon Access Token

  1. Register an account on https://social.5th.ro
  2. Go to Preferences → Development
  3. Click New Application
  4. Fill in the application details:
    • Application name: 5th Social Bot
    • Website: Your WordPress site URL
    • Redirect URI: Leave empty
    • Scopes: Check write:statuses and read:accounts
  5. Click Submit
  6. Copy the Your access token value

Step 2: Configure the Plugin

  1. Go to Settings → 5th Social Bot in WordPress admin
  2. Paste your access token in the Mastodon Access Token field (field is blurred for security, with show/hide toggle)
  3. The username will be automatically retrieved from the token
  4. Configure other settings as needed:
    • Enable auto-posting for posts and/or pages
    • Set post template (default: {text}\n{tags}\n{url})
    • Use the emoji picker (over 2000 Unicode emojis available)
    • Choose status visibility (public, unlisted, private, direct)
    • Set post language (default: Romanian, ISO 639-1/639-2)
    • Enable Debug Mode for detailed logging (optional)
  5. Click Save Settings
  6. Use the Send test post to Mastodon button to verify configuration

Template Placeholders

The post template supports the following placeholders:

  • {text} - excerpt/preview of content (automatically trimmed to 500 characters)
  • {tags} - hashtags generated from WordPress tags (spaces and special characters removed, # prefix added)
  • {readmore_text} - short call-to-action text (you can add multiple variants, one per line, randomly chosen)
  • {url} - permalink to post or page

Newlines support: You can write the template on multiple lines in the textarea, or use \n in the template (converted to real newlines).

Automatic trimming: If the post exceeds 500 characters (Mastodon limit), the plugin tries to shorten only the {text} part first, then uses a minimal variant …. {readmore_text} {url} if needed.

Step 3: Profile Verification (Optional)

  1. Enable Profile Verification in settings
  2. Go to your Mastodon account Preferences → Public profile → Verification
  3. Add your WordPress site domain to the whitelist
  4. The plugin will automatically add the verification code to your site header