A Decentralized Social Network https://wiki.friendi.ca/ 2026-04-13T17:18:23+00:00 https://wiki.friendi.ca/ https://wiki.friendi.ca/_media/wiki/logo.png 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-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-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: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-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: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-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-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 2024-10-15T22:11:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/api?rev=1729030302&do=diff Friendica API Friendica offers multiple API endpoints to interface with third-party applications: * Twitter * Mastodon * Friendica-specific * GNU Social Usage HTTP Method API endpoints can restrict the HTTP method used to request them. Using an invalid method results in HTTP error 405 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-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-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-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-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-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-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 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-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 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-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-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-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 2024-03-31T17:39:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/admin?rev=1711906760&do=diff Friendica Administration Most of the administrative work--basic settings, user management etc.--of a Friendica node is done in the Admin Panel (example.com/admin) of the node. Some of the administrative features, mostly new ones, have not made it into the panel yet, but they are available with the command line interface of Friendica, which is provided by 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-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-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-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-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-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-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-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 2024-01-21T14:17:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/user?rev=1705846678&do=diff User Documentation A collection of useful tips and tutorials for users of Friendica. * Abstracts - How to use abstracts in Friendica (or how to apply a content warning to your postings) * Image Descriptions - How to add an description to the images your are posting * Setting up TOTP/2FA security for your Friendica account * Bot - How to create a bot to publish contents of a RSS feed in the Fediverse * Scheduler - Publish Content on a selected date * Account Delegation - Manage mul… 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-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 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 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-25T05:48:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/start?rev=1656136097&do=diff Documentation User Docs Help for users of Friendica Admin Docs Documentation for Admins of Friendica Nodes Developer Docs Developer Documentation text/html 2023-03-26T18:34:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/tools?rev=1679855686&do=diff Admin Tools Friendica Tools In Friendicas bin/ directory is a build in command called console, that provides the following commands: addon Addon management cache Manage node cache config Edit site config contact Contact management createdoxygen Generate Doxygen headers dbstructure Do database updates docbloxerrorchecker Check the file tree for DocBlox errors extract Generate translation str… 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. text/html 2022-10-17T05:30:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/vagrant?rev=1665984600&do=diff Vagrant for Friendica Developers Getting started Vagrant is a virtualization solution for developers. No need to setup up a webserver, database etc. before actually starting. Vagrant creates a virtual machine for you that you can just run inside VirtualBox and start to work directly on Friendica.