Use Fediverse Shortcodes in Articles

Overview

Use Fediverse shortcodes to place follow prompts, actor identity, and engagement summaries directly inside article content. This makes articles more self-explanatory and gives readers useful Fediverse context without template changes.

This is useful when the article itself should explain how readers can follow the actor, when you want the author identity visible inside the content, or when you want to surface simple engagement information without editing templates. After you complete this procedure, the raw shortcode text should disappear on the frontend and the rendered Fediverse output should appear instead.

Before you begin

Plugin Content - Fediverse Tags must be enabled.
The article author should have a local actor.
Decide which rendered elements belong inside the article body before editing the text.

Supported tags

{{fediverse:handle}} for actor handle display.
{{fediverse:follow}} for follow action or link output.
{{fediverse:reactions}} for reaction summary output.

Steps

Open Content -> Articles.
Open an article for editing.
Insert one or more Fediverse shortcodes in Intro Text or Full Text.
- {{fediverse:handle}} - Renders the actor handle for the article author.
- {{fediverse:follow}} - Renders follow-oriented output for the actor.
- {{fediverse:reactions}} - Renders the current reaction summary for the article’s federated object.
Save the article.
Open the article on the frontend.
Confirm the shortcode text is replaced by rendered Fediverse output.

Example:

Follow this author: {{fediverse:follow}}
Actor: {{fediverse:handle}}

Check your result

Raw shortcode text is not visible on the frontend.
Rendered output matches the mapped author actor.
The rendered output appears in the article position where you inserted the shortcode.

Troubleshooting

The shortcodes appear as raw text on the frontend

Likely cause: Content - Fediverse Tags is disabled.
Solution: Enable the content shortcode plugin and reload the article.

The shortcode renders, but the output is blank

Likely cause: The article author does not have a local actor, or there is no relevant data yet for that shortcode.
Solution: Confirm the author has a local actor. If you used {{fediverse:reactions}}, also confirm the article already has processed reaction data.

The output shows the wrong actor

Likely cause: The article is assigned to a different Joomla author than the one you expected.
Solution: Reopen the article, confirm the Author field, save it again, and reload the frontend page.