Beskrivning

Plugin that provides an [include-mastodon-feed] shortcode to easily integrate mastodon feeds into wordpress pages. Supports personal and tag feeds.

Tillägget är skrivet i PHP och skapar JavaScript för att hämta och visa Mastodon-flödet. Inga speciella bibliotek behövs.

Installation

Upload the ”include-mastodon-feed” directory to the ”/wp-content/plugins/” directory.
Activate the plugin through the ”Plugins” menu in WordPress.
Insert shortcode into any page.

Shortcode example

[include-mastodon-feed instance="YOUR-INSTANCE" account="YOUR-ACCOUNT-ID"]

Shortcode attributes

instance (required)
Domain name of the instance without https:// (e.g. example.org)
account (required)
The account ID (a long number – see FAQ on how to get it)
tag
Use tag instead of account if you want to embed a tag feed instead of a personal feed
limit
Maximum number of statuses (Default: 20)
excludeReplies
Exclude replies to other accounts (Default: false)
excludeConversationStarters
Exclude statuses that start with a user mention (Default: false)
excludeBoosts
Exclude boosted statuses (Default: false)
onlyPinned
Show only pinned statuses (Default: false)
onlyMedia
Show only statuses containing media (Default: false)
preserveImageAspectRatio
Preserve image aspect ratio (Default: false)
imageSize
Load small sized preview images or full size high quality images (Default: preview, full)
imageLink
Link image to status or image (Default: status, image)
tagged
Show only statuses that are tagged with given tag name (Default: false)
No leading #, case insensitive, e.g.: tagged=”tagname”
linkTarget
Target for all links e.g. new tab would be ”_blank” (Default: _self)
showPreviewCards
Show preview cards (Default: true)
hideStatusMeta
Hide status meta information, automatically also hides date and time (Default: false)
hideDateTime
Hide date and time from status meta information (Default: false)
darkmode
Enable dark mode (Default: false)
text-loading
Loading text (Default: Loading Mastodon feed…)
text-noStatuses
Text if no statuses are available (Default: No statuses available)
text-boosted
Text indicating boosted statuses (Default: boosted 🚀)
text-viewOnInstance
View status on instance link text (Default: view on instance)
text-showContent
Text for content warning buttons (Default: Show content)
text-permalinkPre
Text before post permalink (date & time) (Default: on)
text-permalinkPost
Text after post permalink (date & time) (Default: )
text-edited
Text indicating edited posts (Default: (edited))
date-locale
Locale for date string, used in toLocaleString() (Default: en-US)

Additional customizations

You can define several plugin constants to set custom default options that will be applied site-wide (e.g. date options can only be set as php constant to mitigate an XSS vulnerability).

Open your wp-config.php file
Sök efter raden /* Add any custom values between this line and the "stop editing" line. */
Define the options you want to override between the line from step #2 and /* That's all, stop editing! Happy publishing. */

See the included config-example.php file for a full list of supported settings.

Vanliga frågor

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

improve support for video and audio media attachment types
integrera i18n med translate.wordpress.org istället för textkonstanter
re-build plugin as custom gutenberg block

Recensioner

pkingtiger 7 maj 2024 2 svar

Does what you need it to do in a simple way and can be customised with simple CSS to match the look and feel of your site.I would love to see some config options on how things are displayed:* Show / hide date & time at the top of each toot.* More placement options for the avatar.

kenfortune 17 april 2024 1 svar

Love this plugin! Very easy to adjust the shortcode to customise the feed contents (eg. to exclude replies or boosts, to only show posts with images or with a certain tag etc). And if you are happy adding custom CSS to your wordpress, also fairly simple to get things looking just the way you want them. So happy this plugin exists.

angelynng 22 december 2023

Simple. Works. Phew!

Daniel 11 november 2023

thanks a lot! Works charming …

alrsl 26 juli 2023

Simple installation, perfect description, user ID in seconds, minimal customization. This plugin just does what it should do.

westerngeomancy 12 juli 2023

The instructions look a bit intimidating to start with, but it’s actually pretty simple to install and configure. The FAQ tells you how to find your account number, and there are plenty of shortcode options to customise the feed.

Läs alla 13 betyg

Bidragsgivare och utvecklare

”Include Mastodon Feed” är programvara med öppen källkod. Följande personer har bidragit till detta tillägg.

Wolfgang

”Include Mastodon Feed” har översatts till 2 språk. Tack till översättarna för deras bidrag.

Översätt ”Include Mastodon Feed” till ditt språk.

Intresserad av programutveckling?

Läs programkoden, kika på SVN-filförvaret eller prenumerera på utvecklarloggen via RSS.

Ändringslogg

1.9.11

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

omfaktorering: visa meningsfulla meddelanden om inga statusuppdateringar är tillgängliga
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

lade till inställning för att visa/dölja förhandsvisningskort
omfaktorering: introducera namnrymd för tillägget
omfaktorering: förbättra utdata på felsökningskonsolen

1.7.0

höjde WordPress-versionen till 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
lade till inställning för att ange maximalt antal statusuppdateringar

1.4.2

fixade stilproblem med emojis i kontots visningsnamn

1.4.1

fixade stilproblem med boostade kontolänkar

1.4.0

removed ”view on instance” link and made date info clickable instead
added custom date locale and format option
fixade stilproblem för emoji och inbäddade länkar i innehållsblock
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
tog bort stöd för config.php

1.3.0

lade till nya flödes-inställningar: excludeReplies, onlyPinned, onlyMedia

1.2.0

fixade trasig JavaScript om inlägg innehåller andra mediabilagor än bilder
fixed custom ”view on instance” option
lade till inställning för att skräddasy texten på innehållsvarningsknappen
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)
ändrade till att visa statiska avatarer, animerade avatarer endast vid hovring

1.0.1

escaped options when echoing them
säkrade inkludering av lokala filer
ändrade versionering till semantiska versionsnummer – innehåller nu ett patchnummer

1.0

Första utgåvan