gnu-social/modules/TheFreeNetwork
2021-07-16 19:44:38 +01:00
..
scripts [TheFreeNetwork][fix_duplicates.php] Don't die because you couldn't federate an undo follow 2021-07-16 19:44:38 +01:00
EVENTS.txt [TheFreeNetwork] Use config + module settings for initialization and online lookup 2021-07-16 19:44:36 +01:00
README.md [TheFreeNetwork] Add Readme 2021-07-16 19:44:38 +01:00
TheFreeNetworkModule.php [TheFreeNetwork] Small rewrite to the onStartTFNLookup event 2021-07-16 19:44:38 +01:00

TheFreeNetwork allows GNU social to handle more than one Federation protocol simultaneously.

Making this possible essentially consists in not allowing duplication of remote profiles in the profile table, and to ensure that each profile is handled by one and only one federation protocol at a time.

Each newly added federation protocol must support all the already supported functionalities by the other federation protocols, otherwise this module will be moving between FullFeaturedFederationProtocolProfile and LackyFederationProtocolProfile all the time.

You must feed this Module with the list of preferences for each federation protocol, more on that in the following section.

Settings

You can change these settings in config.php with $config['TheFreeNetworkModule'][{setting name}] = {new setting value};.

Default values in parenthesis.

protocols (['ActivityPub' => 'Activitypub_profile', 'OStatus' => 'Ostatus_profile']):

This array follows the following structure:

['{PluginName}' => '{Actor_representation_class_name}', the latter is the class used to represent the remote profile in the context of the federation plugin.

N.B.: Higher Priority/Preference is given to the first entry. I.e., the default value gives preference to ActivityPub over OStatus.

Scripts

./fix_duplicates.php : Run this script if you have duplicated profiles due to federation issues. For example, if both ActivityPub and OStatus created different profile entries for the same remote actor. That's something that shouldn't thank to this module, but if something goes very wrong, there's this script.