Plugin that provides a shortcode to easily integrate mastodon feeds into wordpress pages.
Plugin that provides an [include-mastodon-feed] shortcode to easily integrate mastodon feeds into wordpress pages. Supports personal and tag feeds.
Account and post images are lazy loaded if preserveImageAspectRatio is set to true (default: false).
The plugin is written in PHP and generates native JavaScript to fetch and render the mastodon feed. No special libraries needed.
FAQ
How do I find my account ID?
Please feel free to use this handy lookup tool
To look your ID up manually there are several ways.
As an instance admin you can easily read your user ID in the admin backend.
As regular user you can try an API v2 search to find your ID.
API v2 notes:
* Change example.org to your instance
* Replace username with your handle.
Use the following URL to get your ID:
https://example.org/api/v2/search?q=username@example.org&resolve=false&limit=5
Known Issues / Todo
- integrate i18n into translate.wordpress.org instead of text constants
- re-build plugin as custom gutenberg block
ChangeLog
1.16.0
- fix: local instance video urls
- feat: added audio media support
- feat: added excludeTags shortcode attribute – Exclude statuses that are tagged, posts containing any one of the given tags (comma separated list) will be excluded. Note: can lead to empty status list as the filtering is handled client-side. Mastodon API does not support this parameter natively. (thank you @zambunny)
1.15.1
1.15.0
- feat: now supports video attachments
1.14.0
- accessibility: add HTML lang attribute for even better screen reader support (thank you @oldrup@mastodon.green)
1.13.1
- fix: removed unnecessary, broken aria-label functionality
1.13
Special release for Global Accessibility Awareness Day
in collaboration with @oldrup@mastodon.green
Happy Accesssibility Day
- accessibility (fix): image alt attributes – initial implementation was faulty
- accessibility: added alt text to image / gifv attachments
- accessibility: added alt text to avatar images
- accessibility: added alt text to preview card media
- accessibility: added descriptive aria-labels
- accessibility: increased default text / background color contrast
- accessibility: switched from DIV to semantic OL / LI structure
1.12
- accessibility: added image alt attribute (thank you @oldrup@mastodon.green)
1.11
- now favoring preview_url (smaler size) instead of remote_url (full size) for image previews (thank you @oldrup@mastodon.green)
1.10
- added image lazy loading for account and post images – post image lazy loading only works with preserveImageAspectRatio set to true (thank you @oldrup@mastodon.green)
1.9.11
- fixed typo (thank you @hjek)
- cleaned up code after 1.9.10 release
1.9.10
- fixed XSS vulnerability: removed support for date-options as shortcode attribute completely – to mitigate an XSS vulnerability where authenticated attackers with contributor permission could insert malicious JavaScript (still can be set as constant in PHP code)
1.9.9
- fixed esc_url context that previously broke the URL for the Mastodon API JS ajax request (thank you @beach@illo.social)
1.9.8
- fix broken date-locale and date-options parameters (thank you @crusy@chaos.social)
- improved string excaping for text parameters and added url escaping
- removed unnecessary output buffering
- fix license SPDX Identifier
1.9.7
- fix option to either display smaller image media attachment previews (default) or large image versions (thank you @beach@illo.social)
1.9.6
- fixed XSS vulnerability where authenticated attackers with contributor permissions could insert malicious JavaScript
1.9.5
- added option to either display smaller image media attachment previews (default) or large image versions (thank you @beach@illo.social)
- added option to point image media attachment links to either status (default) or image
1.9.4
- added option to hide status meta information and date/time (thank you @PaulKingtiger@dice.camp)
- added tag support – you can now embed tag feeds (thank you @martin@openedtech.social)
- added option to show embedded images in original aspect ratio (thank you @beach@illo.social)
- fix: correctly inject repeating emojis in display names and status texts (thank you @kanigsson@discuss.systems)
1.9.3
- fix: improved excludeConversationStarters detection (did not work correctly)
- fix: undid last refactor to load JS inline with markup instead footer to fix problem with JS that was added to footer even if shortcode was not visibly rendered
1.9.2
- fix: style for embedded videos / GIFs
- refactor: play gifv on mouseover
- refactor: load markup related javascript in footer instead of embedding it directly with the html markup
1.9.1
- refactor: show meaningful message if no statuses are available
- fix: broken excludeConversationStarters logic
1.9.0
- added option to exclude conversation starters (posts that start with a user mention)
1.8.1
- fix: boolean param validation was wonky
- fix: stop links from overflowing (thanks to https://github.com/moan0s for contributing)
- refactoring: improved styling of embedded images
1.8.0
- added option to show/hide preview cards
- refactoring: introducing plugin namespace
- refactoring: improved debug console output
1.7.0
- bumped tested wordpress version to 6.2
- added option to customize permalink text (before and after date/time)
- added option to customize text indicating edited posts
1.6.0
- image attachments are now clickable (link to original status)
1.5.0
- added option to show only statuses with specific tag
- added option to set link target to make links open in new tab
- added option to set maximum number of statuses
1.4.2
- fixed styling issue with emojis in account display name
1.4.1
- fixed styling issue with boosted account links
1.4.0
- removed “view on instance” link and made date info clickable instead
- added custom date locale and format option
- fixed emoji and inline link styling issues in content blocks
- fixed an issue with gifv media attachments
- refactored option sanitizing and filtering
1.3.1
- updated documentation that plugin constants for setting custom default options have to be defined in
wp-config.php, as the previous config.php file gets removed with every automatic plugin update
- removed
config.php support
1.3.0
- added new feed options: excludeReplies, onlyPinned, onlyMedia
1.2.0
- fixed broken JavaScript if post included media attachments other than images
- fixed custom “view on instance” option
- added option for custom content warning button text
- added option to exclude boosted statuses
- added support for gifv media attachments
1.1.0
- added support for more custom text overrides (loading, boosted, view on instnace)
- switched to showing static avatars, animated avatars only on hover
1.0.1
- escaped options when echoing them
- secured local file inclusion
- changed versioning to semantic versioning – now including patch number
1.0
