TootPress

plugin banner

TootPress copies your toots from Mastodon to WordPress.

Author:Marco Hitschler (profile at wordpress.org)
WordPress version required:6.1
WordPress version tested:6.5.2
Plugin version:0.3
Added to WordPress repository:31-03-2023
Last updated:24-04-2024
Rating, %:86
Rated by:3
Plugin URI:
Total downloads:978
Active installs:20+
plugin download
Click to start download

TootPress copies your toots from Mastodon to WordPress continuously. The toots can be displayed chronologically in the blog, making your timeline accessible to other people outside of Mastodon. In addition, you regain ownership of your own data back.

Features

  • Copy your toots back
  • Copy your tooted images back
  • Display your toots on the blog
  • Retrieve your complete timeline
  • Languague: English, German (only FrontEnd)

Live Demo

Here!

Setup Manual

  1. Install the Plugin in WordPress
  2. Create an Application on your Mastodon Instance to get API Access (under Settings/Development)
  3. Restrict the Authorization of the created Application to Read (all data)
  4. Maintain Mastodon Instance and Access Token in the TootPress Settings
  5. Retrieve your Account ID (in WordPress under Tools/Toots)
  6. Maintain the Account ID in the TootPress Settings
  7. Create a new WordPress Page and add the Page to your Menu
  8. Maintain the Page ID in the TootPress Settings (you find the Page ID in URL of the Browser when editing the Page in WordPress)
  9. Run Mastodon API Request once (in WordPress under Tools/Toots)
  10. Activate Steady Fetch
  11. That’s it!

Instructions for Use

  • You find TootPress in WordPress in the area of Settings and Tools
  • Steady Fetch activates the automatic and regular load of new toots
  • First API Request will copy your last 40 toots
  • New toots will be loaded every 15 minutes (customizable)
  • You can load your complete timeline into WordPress with the eponymous function
  • Loading your complete timeline can take several hours depending of the amount of toots
  • 480 toots are loaded per hour as maximum
  • You can run a Mastodon API Request everytime at your own with the eponymous function
  • There is no prescribed order for the execution of Steady Fetch, Complete Timeline or manual requests
  • If problems occur, TootPress provides a Healthy Check

Further Information

Supported Toot Objects

Following toot objects are supported.

  • Text
  • Images
  • Galleries
  • URLs
  • Hashtags
  • Mentions

Not supported Toot Objects

Following toot objects are not supported.

  • Audio
  • Video
  • Poll
  • Emojis
  • Teaser

Excluded Toot Types

Following toot types are excluded from the data transfer.

  • Boosts
  • Replys
  • Private Toots

Architecture

Data storage and process logic is separated from the WordPress Framework. The toots are not saved in the table wp_posts. And TootPress is not registering a custom post type for the toots as well.

CSS classes

TootPress comes with basic CSS Styles. For best fit it is required to add additional styles in your theme. All TootPress UI elements can be addressed with individual CSS selectors. Please use the browser development tools to find the right classes.

Data & Files

TootPress creates 2 folders within the WordPress Uploads Directory.

  • tootpress-mastodonapidata = Archive of the received Mastodon API data
  • tootpress-images = Toot Image Folder

wpCrons

  • Steady Fetch (every 15 minutes, customizable)
  • Load Complete Timeline (every 5 minutes)

TootPress API

WordPress Action: tootpress_toots_update (fired on toot update)

Related Links

Screenshots
FAQ
ChangeLog