A Decentralized Social Network https://wiki.friendi.ca/ 2026-05-24T04:01:13+00:00 https://wiki.friendi.ca/ https://wiki.friendi.ca/_media/wiki/logo.png 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-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 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-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-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-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:58:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/message-flow?rev=1656082701&do=diff Friendica Message Flow This page documents some of the details of how messages get from one person to another in the Friendica network. There are multiple paths, using multiple protocols and message formats. Those attempting to understand these message flows should become familiar with (at the minimum) the 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-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-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-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 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 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-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-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 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 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 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 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 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-05-15T09:11:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/two-factor-authentication?rev=1652605861&do=diff Two-Factor Authentication General * A two-factor authentication (2FA) can be configured using a mobile app. Then a Time-based One-Time Password (TOTP) application can be used, that automatically generates an authentication code. That code changes after a certain period of time. text/html 2022-06-24T13:43:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/autoloader?rev=1656078181&do=diff Autoloader with 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-11-04T15:42:34+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/database?rev=1667576554&do=diff Database Tables Table Description 2fa_app_specific_passwordTwo-factor app-specific _password 2fa_recovery_codes Two-factor authentication recovery codes text/html 2022-07-18T09:13:40+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/improve-performance?rev=1658135620&do=diff How to improve the performance of a Friendica site Feel free to ask in the Friendica support forum if you need some clarification about the following instructions or if you need help in any other way. System configuration Please go to /admin/site/ on your system and change the following values: text/html 2022-06-24T15:37:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/making-friends?rev=1656085055&do=diff Making Friends Friendship in Friendica can sometimes take on different meaning. But let’s keep it simple; you want to be friends with somebody. How do you do it? The Directories Friendica has two different kinds of “address book”. The directory of the Friendica server you are registered on and a global directory to which your and other Friendica servers submit account information. text/html 2020-10-05T23:21:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/text_editor?rev=1601940087&do=diff Creating posts * [Home](help) Here you can find an overview of the different ways to create and edit your post. One click on the Pencil & Paper icon in the top right of your Home or Network page, or the “Share” text box, and the post editor shows up. Below are examples of the post editor in 3 of Friendica's common themes: 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-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 2022-06-16T16:37:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/api-gnu-social?rev=1655397449&do=diff GNU Social API Overview Friendica provides the following endpoints defined in the official GNU Social Twitter-like API reference. Authentication is the same as described in Using the APIs. Entities These endpoints use the Friendica API entities. Implemented endpoints * GET api/account/rate_limit_status * POST api/account/update_profile_image text/html 2022-06-25T06:59:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/chats?rev=1656140349&do=diff Chats There are two possibilities to use chat on your friendica site * IRC Chat * XMPP/Jabber IRC-Chat Addon After activating the addon, you can find the chat at example.com/irc (if your Friendica nodes domain name is example.com). Note: you can use this chat without any login at your site so that everyone could use it. 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 2021-01-12T18:31:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/events?rev=1610476289&do=diff Events A special form of postings are events. The events you and your contacts share can be found at /events on your node. To get there go to your wall and follow the tab “events” Depending on the theme you are using, there might be an additional link from the navigation menu to this page. 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 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-05-02T09:29:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/post_to_lemmy_from_friendica?rev=1651483758&do=diff How to post to Lemmy from your Friendica account What is Lemmy To quote the Lemmy project " Lemmy is similar to sites like Reddit, Lobste.rs, or Hacker News: you subscribe to forums you're interested in, post links and discussions, then vote, and comment on them. Behind the scenes, it is very different; anyone can easily run a server, and all these servers are federated (think email), and connected to the same universe, called the Fediverse. text/html 2022-06-24T15:42:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/remove-account?rev=1656085372&do=diff Remove Account We don't like to see people leave Friendica, but if you need to remove your account, you should visit the URL http://example.com/removeme with your web browser. You will need to be logged in at the time. You will be asked for your password to confirm the request. If this matches your stored password, your account will immediately be marked as deleted. There is no grace period, this action cannot be reverted. Most of your content and user data will be deleted shortly in the bac… 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-10-19T12:09:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/tests?rev=1603109359&do=diff Themes [Home] You can run unit tests with [PHPUnit]: bash phpunit Some tests require access to a MySQL database. You can specify the database credentials in environment variables: bash USER=database_user PASS=database_password DB=database_name phpunit Warning: This will empty all the tables! Never use this on a production database.