A Decentralized Social Network https://wiki.friendi.ca/ 2026-05-24T07:30:08+00:00 https://wiki.friendi.ca/ https://wiki.friendi.ca/_media/wiki/logo.png 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-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-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 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-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 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-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-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: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-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-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-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-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 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 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-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-11-26T09:16:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/verify_homepage?rev=1669454169&do=diff Homepage Verification If you want to verify that the website you put into the Homepage field of your Friendica profile really belongs to you, you can do so using the rel-me microformat. Which basically is a machine read-able link to an URL in the internet that is also me 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-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-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-16T16:43:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/api-mastodon?rev=1655397803&do=diff Mastodon API Overview Friendica provides the following endpoints defined in the official Mastodon API reference. Authentication is the same as described in Using the APIs. Clients Supported apps For supported apps please have a look at the FAQ Unsupported apps Android * Fedilab Automatically uses the legacy 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 2020-11-25T17:49:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/bugs-and-issues?rev=1606326557&do=diff Bugs and Issues If your server has a support page, you should report any bugs/issues you encounter there first. Reporting to your support page before reporting to the developers makes their job easier, as they don't have to deal with bug reports that might not have anything to do with them. Reducing the workload in this way helps us get new features faster. You can also contact 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: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-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-05-03T19:50:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/image_description?rev=1651607429&do=diff Image Descriptions - How to add an description to the images your are posting You can easily add an image description (or ALT text) to an image in your postings. The text will be displayed when the image is hovered with the mouse cursor, and is used by screen readers. 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-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-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 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 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 2021-11-11T13:31:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/thefediverse?rev=1636637516&do=diff The Fediverse What is it The word fediverse is a combination of the words Federation, like federated nations, and Universe. It indicates that there is no single entity controlling the whole network. There are lots of diverse places like planets in a universe or like villages on a planet. Each may have different cultures, languages, interests, etc. but they are connected via a communication protocol (Activity Pub/OStatus) so that they can interact. 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