A Decentralized Social Network https://wiki.friendi.ca/ 2026-05-22T13:57:25+00:00 https://wiki.friendi.ca/ https://wiki.friendi.ca/_media/wiki/logo.png text/html 2022-06-16T16:35:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/api-friendica?rev=1655397358&do=diff Friendica API Overview Friendica provides the following specific endpoints. Authentication is the same as described in Using the APIs. Entities These endpoints uses the Friendica API entities. Endpoints GET api/friendica/events Returns a list of Event entities for the current logged in user. text/html 2022-06-25T06:28:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/settings?rev=1656138492&do=diff Settings If you are the admin of a Friendica node, you have access to the Admin Panel where you can configure your Friendica node. Overview In the main page of the admin panel you will see an information summary about your node. Queues The three numbers shown are respectively: - The retry queue: These outgoing messages couldn’t be received by the remote host, and will be resent at longer intervals before being dropped entirely after 30 days. - The deferred queue: These internal tasks failed… text/html 2022-06-24T14:54:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/accesskeys?rev=1656082448&do=diff Accesskeys reference Access keys are keyboard shortcuts that allow you to easily navigate the user interface. Access keys are currently not available with the Frio theme. The specific key combinations depend on how your browser’s the modifier key setting. For an overview of modifier keys in different browsers, have a lookat text/html 2024-09-30T20:27:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/cofig-for-small-notes?rev=1727728044&do=diff Configuration Guide for small Nodes This guide aims to provide a collection of settings for nodes installed with limited resources. They are actively used on a small (family) node running on a RaspberryPi 4B (8GB ram). But other restricted environments, e.g. a small VPS or shared hosting fall into targeted hardware range. text/html 2022-06-24T15:04:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/groups-and-privacy?rev=1656083061&do=diff Groups and Privacy Groups are merely collections of friends. But Friendica uses these to unlock some very powerful features. Setting Up Groups To create a group, visit your Friendica “Contacts” page and select “Create a new group”. Give the group a name. text/html 2022-06-09T08:51:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/bbcode?rev=1654764686&do=diff Friendica BBCode tags reference Friendica is using the BBCode markup language to format postings and comments. Alternatively the admin of a Friendica node can activate an addon to also support Markdown. How a rich text formatted posting or comment will be displayed in other projects of text/html 2020-09-20T19:19:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/config?rev=1600629582&do=diff Config values that can only be set in config/local.config.php * [Home](help) Friendica's configuration is done in two places: in PHP array configuration files and in the `config` database table. Database config values overwrite the same file config values. text/html 2023-07-27T04:41:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/fulltext_search?rev=1690432881&do=diff Search in Friendica Depending on the settings users of Friendica can perform searches for various things using the /search page (or the search bar in the upper navigation panel). The search is performed on the Friendica node itself, so only the content known to the Friendica node can be found. text/html 2024-10-15T10:57:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/install?rev=1728989873&do=diff Friendica Installation We've tried very hard to ensure that Friendica will run on commodity hosting platforms - such as those used to host Wordpress blogs and Drupal websites. We offer a manual and an automatic installation. But be aware that Friendica is more than a simple web application. text/html 2022-06-25T08:57:30+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/text_comment?rev=1656147450&do=diff Comment, sort and delete posts This article will guide you through the basic interaction possibilities you have on a posting in your network stream. [Screenshot from the interaction possibilities with a postings (in this case an event), taken from the frio theme] Buttons below the Posting * Like / Dislike: With these buttons you can add a like (or dislike) to the posting as quick reaction. The text/html 2022-06-25T09:10:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/account-basics?rev=1656148223&do=diff Account Basics Registration Not all Friendica sites allow open registration. If registration is allowed, you will see a “Register” link immediately below the login prompt on the site’s home page. Following this link will take you to the site registration page. The strength of our network is that lots of different sites are all completely compatible with each other. If the site you’re visting doesn’t allow registration, or you think you might prefer another one, there is a text/html 2025-01-05T18:52:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/api-authentication?rev=1736103163&do=diff Friendica API authentication You can authenticate requests to the Friendica API via two methods: HTTP Basic and OAuth. HTTP Basic is easy to use, but it requires your account password, so it grants complete access to your account. OAuth is significantly more involved, but has the ability to grant limited permissions, so that someone can use the text/html 2024-01-21T14:38:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/channel?rev=1705847906&do=diff Channels Channels were introduced in version 2023.12 to Friendica. They allow users to define rules that are used to filter the content displayed in the channels timeline. Channels can be used as alternative to the usual network stream sorting and the usage of filters. You can define channels in your account settings in the channels section. text/html 2022-06-24T13:37:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/forums?rev=1656077851&do=diff Forums Friendica also lets you create community forums and other types of accounts that can function as discussion forums, celebrity accounts, announcement channels, news reflectors, or organization pages, depending on how you want to interact with others. Management of these pages can be delegated to other accounts, or a parent account can be designated to easily toggle multiple identities. text/html 2022-04-22T05:27:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/initicalconfiguration?rev=1650605237&do=diff First Steps Once you have installed Friendica successfully on your server, you might consider some customizations to make the experience better. Subscribe to Relay Services Finding interesting contacts in a new social network like the Fediverse can be hard. To get potentially interesting content onto your Friendica node without subscribing to random people on different node of the Fediverse, you can subscribe your node to a relay service. These relay services take all public postings from sub… text/html 2022-06-25T05:50:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/move-account?rev=1656136200&do=diff How to move your account between servers This is an experimental feature * Go to “Settings” -> “Export personal data” * Click on “Export account” to save your account data. * Save the file in a secure place! It contains your details, your contacts, groups, and personal settings. It also contains your secret keys to authenticate yourself to your contacts. text/html 2024-01-21T14:17:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/network_filters?rev=1705846641&do=diff Filtering your Network Stream An alternative to use the filters explained on this page is to use channels for selecting the content one wants to be shown. Filter Addons Content Filter / NSFW The content filter addon is a simple filter, that matches words specified by the user to the text of postings in the network stream. If the text includes one of the words, the posting will be collapsed and the word that triggered the filter will be displayed to the user why the posting was collapsed. The… text/html 2022-06-24T15:05:28+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/ssl?rev=1656083128&do=diff Using SSL with Friendica Disclaimer This document has been updated in November 2016. SSL encryption is relevant for security. This means that recommended settings change fast. Keep your setup up to date and do not rely on this document being updated as fast as technologies change! text/html 2022-06-22T06:54:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/themes?rev=1655880862&do=diff Themes To change the look of friendica you have to touch the themes. The current default theme is frio but there are numerous others. Have a look at the community contributed theme repository for some of the themes (and theme customizations) the community has created. In case none of them suits your needs, there are several ways to change a theme. text/html 2022-07-05T14:40:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/abstract?rev=1657032057&do=diff Abstracts Using BBCode for formatting your postings, you can add an abstract, a short summary, to your postings. Especially in the case of Twitter (and other length limited networks to which Friendica exports your postings via the API) Friendica will try to automatically decide which part of the posting is relevant. But often you as the author of a posting knows better. text/html 2022-06-06T10:03:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/account_delegation?rev=1654509807&do=diff Account Delegation For various reasons it may be desire-able to have more then just one account. For instance to give each account different topics, to manage a forum account or a bot that imports external RSS feeds. Account delegation makes handling the different account more easy. text/html 2022-06-25T10:10:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/addons?rev=1656151801&do=diff Friendica Addon development Please see the sample addon ‘randplace’ for a working example of using some of these features. Addons work by intercepting event hooks - which must be registered. Modules work by intercepting specific page requests (by text/html 2022-06-24T13:39:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/addonstoragebackend?rev=1656077997&do=diff Friendica Storage Backend Addon development Storage backends can be added via addons. A storage backend is implemented as a class, and the plugin register the class to make it available to the system. The Storage Backend Class The class must live in text/html 2022-06-16T17:29:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/api-entities?rev=1655400552&do=diff Friendica API entities Activities Attribute Type Nullable like List of Contacts No dislike List of Contacts No attendyes List of Contacts No attendno List of Contacts No attendmaybe List of Contacts No Attachment Attribute text/html 2022-06-16T16:09:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/api-twitter?rev=1655395777&do=diff Twitter API Overview Friendica provides the following endpoints defined in the official Twitter API reference. Authentication is the same as described in Using the APIs. Entities These endpoints use the Friendica API entities. Different behaviour * screen_name: The nick name in Friendica is only unique in each network but not for all networks. The users are searched in the following priority: Friendica, StatusNet/GNU Social, Diaspora, pump.io, Twitter. If no contact was found by this wa… text/html 2022-06-06T07:24:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/bot?rev=1654500266&do=diff How to Create a Bot The task for the bot is to pull in RSS/Atom feeds into the Fediverse. Why? There are many wonderful offers on the Internet whose updates are published via RSS. In order to make them easily accessible to the inhabitants of the Fediverse, so-called bots can provide this content as a teaser. text/html 2022-06-24T13:45:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/composer?rev=1656078320&do=diff Using Composer Friendica uses Composer to manage dependencies libraries and the class autoloader both for libraries and namespaced Friendica classes. It’s a command-line tool that downloads required libraries into the vendor folder and makes any namespaced class in text/html 2022-06-24T14:31:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/connectors?rev=1656081065&do=diff Connectors Connectors allow you to connect with external social networks and services. They are only required for posting to existing accounts on Twitter or GNU Social. There is also a connector for accessing your email INBOX. If the following network connectors are installed on your system, select the following links to visit the appropriate settings page and configure them for your account: text/html 2022-06-24T14:20:28+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/developer?rev=1656080428&do=diff Developer Documentation Collection of articles aimed for Developers * Where to get started to help improve Friendica * Autoloader with Composer * Using Composer * Domain-Driven-Design * How To Move Classes to src * Friendica on GitHub Contact Possibilities If you want to reach out to the development community of Friendica, please join the Developer Forum on the projects forum node. If you need to contact the core team privately you can send a mail to text/html 2022-06-24T14:06:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/developer-domain-driven-design?rev=1656079592&do=diff Domain-Driven-Design Friendica uses class structures inspired by Domain-Driven-Design programming patterns. This page is meant to explain what it means in practical terms for Friendica development. Inspiration * <https://designpatternsphp.readthedocs.io/en/latest/Structural/DependencyInjection/README.html> * <https://designpatternsphp.readthedocs.io/en/latest/Creational/SimpleFactory/README.html> * <https://designpatternsphp.readthedocs.io/en/latest/More/Repository/README.html> * <htt… text/html 2022-06-24T13:48:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/developer-how-to-move-classes-to-src?rev=1656078482&do=diff How To Move Classes to src Friendica uses Composer to manage autoloading. This means that all the PHP class files moved to the src folder will be automatically included when the class it defines is first used in the flow. This is an improvement over the current require usage since files will be included on an actual usage basis instead of the presence of a text/html 2022-08-24T04:39:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/developers-intro?rev=1661315940&do=diff Where to get started to help improve Friendica Do you want to help us improve Friendica? Here we have compiled some hints on how to get started and some tasks to help you choose. A project like Friendica is the sum of many different contributions. Very different skills are required to make good software, not all of them involve coding! text/html 2022-06-24T14:14:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/github?rev=1656080081&do=diff Friendica on GitHub Here is how you can work on the code with us. If you have any questions please write to the Friendica developers’ forum. Introduction to the workflow with our GitHub repository * Install git on the system you will be developing on. text/html 2021-05-24T05:54:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/home?rev=1621835671&do=diff Friendica Documentation and Resources User Manual * General functions - first steps * [Account Basics](help/Account-Basics) * [New User Quick Start](help/Quick-Start-guide) * [Creating posts](help/Text_editor) * [BBCode tag reference](help/BBCode) text/html 2022-06-25T06:39:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/install-ejabberd?rev=1656139189&do=diff ejabberd and prosody XMPP server with synchronized credentials Ejabberd is a chat server that uses XMPP as messaging protocol that you can use with a large amount of clients. In conjunction with the “xmpp” addon it can be used for a web based chat solution for your users. text/html 2022-06-24T14:49:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/installing-connectors?rev=1656082142&do=diff Installing Connectors (Twitter/GNU Social) Friendica uses addons to provide connectivity to some networks, such as Twitter. There is also a addon to post through to an existing account on a GNU Social service. You only need this to post to an already existing GNU Social account, but not to communicate with GNU Social members in general. text/html 2022-06-24T15:49:34+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/smarty3-templates?rev=1656085774&do=diff Friendica Templating Documentation Friendica uses Smarty 3 as PHP templating engine. The main templates are found in /view/templates theme authors may overwrite the default templates by putting a files with the same name into the /view/themes/$themename/templates text/html 2022-06-24T15:41:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/tags-and-mentions?rev=1656085268&do=diff Tags and Mentions Like many other modern social networks, Friendica uses a special notation inside messages to indicate “tags” or contextual links to other entities. Mentions People are tagged by preceding their name with the @ character. You can tag text/html 2020-09-27T17:21:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/translations?rev=1601227284&do=diff Friendica translations Overview The Friendica translation process is based on gettext PO files. Basic worflow: * xgettext is used to collect translation strings across the project in the authoritative PO file located in view/lang/C/messages.po text/html 2022-06-17T07:38:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/update?rev=1655451536&do=diff Updating Friendica When a new version of Friendica is published a release note contains details about the updating process of that version specific. Including known cliffs during the process and cornerstone releases that you should update to before installing the newest release.