Feditoot – Embed Latest Post from Mastodon

Description

Feditoot adds a shortcode that fetches the most recent public post from a Mastodon account and displays it using the instance’s official embed script — the same output you get from Mastodon’s “Get embed code” feature.

This plugin is not affiliated with Mastodon.

No account ID lookup required. Just use the familiar @user@instance format.

Features:

  • Simple shortcode: [feditoot acct="@user@instance.social"]
  • Uses the official Mastodon embed.js for native-looking embeds
  • Configurable caching to reduce API calls
  • Optional filtering of replies and reblogs
  • Works with any Mastodon-compatible instance

How it differs from other plugins:

  • Unlike feed plugins that show multiple posts and require a numeric account ID, this plugin embeds only the latest post and accepts @user@domain directly.
  • Unlike single-post embed plugins that need a specific status URL, this plugin always shows the newest matching post.

Installation

  1. Upload the feditoot folder to /wp-content/plugins/.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Add the shortcode to any post, page, or widget that supports shortcodes.

Shortcode example:

[feditoot acct="@user@instance.social"]

FAQ

What format should `acct` use?

Use your Mastodon handle: user@instance.domain. A leading @ is optional.

Examples:

  • acct="@alice@mastodon.social"
  • acct="alice@mastodon.social"

How does caching work?

By default, the latest post URL is cached for 10 minutes. Change this with cache_minutes="30" (minimum 1 minute). Clear cache by waiting for expiry or deactivating/reactivating the plugin.

What if no posts are found?

The shortcode outputs nothing visible on the page (an HTML comment is left for debugging). This can happen if the account has no public posts, or if all posts are filtered out by exclude_replies or exclude_reblogs.

Does this work with private or followers-only posts?

No. Only public posts accessible via the instance API are embedded.

My instance does not support `/api/v1/accounts/lookup`

Most modern Mastodon instances support account lookup. If yours does not, this plugin cannot resolve the account. Check with your instance administrator.

Does my server need outbound HTTPS?

Yes. WordPress must be able to reach the Mastodon instance API over HTTPS.

Is this an official Mastodon plugin?

No. Feditoot is an independent WordPress plugin and is not affiliated with Mastodon.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Feditoot – Embed Latest Post from Mastodon” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • Initial release.
  • Shortcode [feditoot] with acct, cache_minutes, exclude_replies, and exclude_reblogs attributes.
  • Transient caching and uninstall cleanup.