Jump to content

Draft:Pleroma: Difference between revisions

Add detailed information about functionality of Pleroma
(Initial draft of the Pleroma page)
 
(Add detailed information about functionality of Pleroma)
Line 1: Line 1:
{{draft}}
{{draft}}


[[File:Pleroma logo.png|thumb|''Pleroma logo'']][[File:Pleroma FE.png|thumb|''Screenshot of Pleroma-FE''
[[File:Pleroma logo.png|thumb|''Pleroma logo''|200x200px]][[File:Pleroma FE.png|thumb|''Screenshot of Pleroma-FE''
 
{|
{|
|Official homepage
|Official homepage
Line 28: Line 29:
|}
|}
]]
]]
== Features ==
Pleroma's API is built upon Mastodon's and shares thereby many features, over time more and more unique features were added such as:
* Reacting to posts with Unicode emoji
* Making posts formatted as either HTML, BBCode or Markdown
* Chatting with other users (Currently only compatible with other Pleroma instances)
=== Removed limits ===
Different to Mastodon, Pleroma has lifted and increased many limits. These are now customizable by the instance administrators. Configurable limits are:
* '''Profiles'''
** Profile name length (100 characters by default)
** Profile description/biography length (5000 characters by default)
** Profile fields count (10 by default for local instance, 20 by default for remote instances)
*** Name of a profile field can be up to 512 characters long by default
*** Value of a profile field can be up to 2048 characters long by default
** Pinned post count (5 by default)
* '''Posts'''
** Post content warning/subject + text length (5000 characters by default for local instance, 100k characters by default for remote instances until post gets dismissed)
** Poll option count (20 options with 200 characters each by default)
=== Message rewrite facilities (MRFs) ===
Pleroma has a feature called MRF which stands for Message Rewrite Facility, these are pieces of configurable code which can change the federation behavior of Pleroma instances.
Which MRFs are enabled and enforced are generally publicly available under the instance's about page (<code>/about</code>) or over the API (<code>/api/v1/instance</code>, JSON property: <code>pleroma.metadata.federation</code>). Administrators can choose to omit this information.
Further reading: [https://docs-develop.pleroma.social/backend/configuration/cheatsheet/#message-rewrite-facility Configuration Cheat Sheet - Pleroma Documentation # Message rewrite facility]
==== Example of MRFs ====
* '''<code>mrf_steal_emoji</code>''' Saves received custom emojis from entered instances
* '''<code>mrf_follow_bot</code>''' Automatically follows discovered remote users for helping the local instance to federate
* '''<code>mrf_hellthread</code>''' Decreases prominence of hellthreads by unlisting them from the public timeline and not notifying mentioned users.
* '''<code>mrf_hashtag</code>''' Marks posts as NSFW, unlists posts or rejects them completely based on what hashtags they contain.
===== <code>mrf_simple</code> =====
This MRF allows instance administrators to reject activities and content from certain remote instances. Possible configurations are:
* Rejecting of all reports, attachments, avatars, banners or federated deletions
* Marking all attachments of entered instances as NSFW
* Unlisting from the federated timeline (also known as The Whole Known Network)
* Enforce all remote statuses to be followers-only
34

edits