.. note::

   Cette documentation est en cours de redaction. Pour toutes questions n'hésitez pas à nous envoyer un email sur `community@risefor.org <community@risefor.org/>`_
   ou à ouvrir un ticket `directement sur git <https://git.risefor.org/installation/>`_

**********************
6. Fédérer votre instance 
**********************


La fédération à 2 aspects, d'un coté l'affichage de contenu d'autres sites sur le votre, de l'autre afficher vos actions sur d'autres instances.


.. contents:: Table des matières
   :local:
   :depth: 2



.. admonition:: Pour faciliter la compréhension

    Dans les exemples de cette page nous utiliserons le nom de domaine ``agir.risefor.org`` comme domaine "source".
    
    Dans votre cas veuillez adapter, en fonction de la situation, avec votre nom de domaine



==============
Modification des configurations
==============

Si vous avez utilisé la version par default du ficher ``settings.py`` la fédération n'est peut etre pas active.

Quand vous activez la fédération, nous vous conseillons de modifier la configuration dans le fichier settings, pour ce faire :

1. Ouvrez le fichier ``settings.py`` situé dans le dossier ``server`` (``/united4earth/server/settings.py``)
2. Recherchez le terme ``FEDERATION_ACTIVE`` et assurez vous qu'il soit suivi de ``TRUE``, comme ceci

.. code-block:: python

    FEDERATION_ACTIVE = True

Cette modification permettra notamment d'afficher le nom du site source des actions :)

==============
Afficher les actions d'autres instances sur la votre
==============

Pour afficher des actions sur votre instance vous devez ajouter une source de données via l'admin.
Voici le processus :

1. Connectez vous à la section "Admin"
2. Cliquez sur "Ldp sources", présent dans la section "Djangoldp"
3. Cliquez sur le bouton "Ajouter ldp source"

Sur le formulaire 2 champs nous intéressent, "Urlid" et "Federation".

- Urlid : Ici vous ajouté la source de données. Par exemple, pour ajouter les actions de Risefor, vous mettez ``https://agir.risefor.org/active-actions/``
- Federation: Ce champs concerne le type de données à fédérer. Dans le cas présent nous ajoutons une source d'action, donc vous ajoutez ``actiongroups``

4. Sauvegardez et redemarrez le serveur. Si vous êtes en production, n'oubliez pas de vider le cache.

Rafraichissez le site et vous devriez voir les actions de l'instance que vous venez d'ajouter !


==============
Afficher vos actions sur d'autres instances
==============

Pour afficher vos actions sur une autre instance vous devez contactez les personnes administrants l'instance. Risefor étant un outil décentralisé, chaque instance a le controle sur sa donnée, et donc les sources qu'iels affichent.

Lors de votre contact, n'oubliez pas de leur partager le nom de domaine de votre instance, suivi de ``/active-actions/``, sans ca iels ne pourront pas vous ajouter.


==============
Afficher vos actions sur agir.risefor.org
==============

Si vous souhaitez que vos actions soient visible sur le site de Risefor `contactez nous <https://agir.risefor.org/contact>`_ avec le lien et une description de votre instance. 

Nous ferons le nécessaire :)