A Decentralized Social Network https://wiki.friendi.ca/ 2026-05-22T06:13:33+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-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-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-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-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-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 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-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-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-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-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-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 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 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-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 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-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 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 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-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. 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-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-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: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 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-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: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 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. 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 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 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 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 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 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-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 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 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-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-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-05-04T06:04:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.friendi.ca/docs/scheduler?rev=1651644279&do=diff Scheduler - time controlled publishing Why is this useful? For different reasons it might be useful no to publish something the moment you've written it. For example, you might want to post a reminder for an event you've just created. Or you want to ensure a bigger audience (to be awake) so you don't publish the posting far after midnight when you finally finished writing it, but rather during the next morning. 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-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