# The DecentraliShare app !

Agora is an POC to use ActivityPub ([EN](https://en.wikipedia.org/wiki/ActivityPub)) ([FR](https://fr.wikipedia.org/wiki/ActivityPub)) on top of the [Solid Platform](https://solidproject.org/).

If you want to use Agora, you must configure your POD.

Agora needs HIGH CONTROL to your POD to set authorizations on data created. (Work in progress to limit access the the Agora folder instead of your entire POD).

Although Agora limits its interaction to a specific folder of your POD, if you don't want Agora to access your entire favorite POD, you can register a new POD on one of this providers : 

| Provider | Responsible for Domain Name and Terms | Responsible for Hosting | Location of Hosting |
| -------- | ------------------------------------- | ----------------------- | ------------------- |
| [https://solid.community](https://solid.community) | [Solid Forum](https://forum.solidproject.org/) | | | 
| [https://inrupt.net](https://inrupt.net/) | [Inrupt, Inc.](https://inrupt.com/terms-of-service) | [Amazon](https://aws.amazon.com/) | USA |
| [https://solidweb.org](https://solidweb.org) | [ewingson](https://forum.solidproject.org/t/pod-providers-how-to/1748) | [Hosteurope](https://www.hosteurope.de/) | Germany |
| [https://solid.authing.cn](https://solid.authing.cn) | [Authing](https://authing.cn/)	| [Tencent Cloud](https://cloud.tencent.com/) | 	China |
| [https://solid.open.ac.uk/](https://solid.open.ac.uk/) | [The Open University](http://www.open.ac.uk/) | | |


To conform to ActivityPub, one user (you) must have two folders (inbox & outbox).
We decided to put them in your /public/agora/ folder.

In that /agora/ folders there is an "index.ttl" file that reference "inbox" & "outbox" folders & that is referenced in your publicTypeIndex as a Agora instance.

Some specials authorizations are set to the /inbox/ & /outbox/ folders:

* /inbox/ folder where you receive notifications of other users actions.
    You keep full CONTROL. Authenticated Agent (Everyone with a POD) is a Submitter (they can write but not read).
* /outbox/ folder where activities & objects that you create are stored.
    You keep full CONTROL. Authorizations for data stored in /activities/ & /objects/ sub-folders are set when you create that activities/objects, according to the recipient of that activity (Public, or a specific POD)



To allow Agora to configure your POD, you must accept Agora can "CONTROL" your POD.

This can be done when you login for the first time on an app hosted on https://scenaristeur.github.io/ by checking the last line of the authorization.

![check_Control](https://github.com/scenaristeur/agora/blob/master/doc/checkControl.png)

If you miss it or if you have already logged on a https://scenaristeur.github.io/ app but did not allow "CONTROL" you can add it in the preferences (right menu of your POD) by checking all 4 "Access Modes" like shown below.

![trustedApps](https://github.com/scenaristeur/agora/blob/master/doc/trustedApps.png)

At the end of the configuration, you should see a structure like this one on your POD (this example show you structure & some data in each ) (followers, followning, liked are not ready, WIP).

![agora_folder](https://github.com/scenaristeur/agora/blob/master/doc/agora_folder.png)

If you have any question or suggestion, feel free to ask on [Solid Community Forum](https://forum.solidproject.org/), or on [Agora project repository](https://github.com/scenaristeur/agora/issues).

Last, but not least : if you install Agora on your device, you can use it as a "Share with..." app... ;-)

If all is OK for you, return to [Agora App](https://scenaristeur.github.io/agora) and Login.

If you want to know more, look at the [Data-Structure](https://github.com/scenaristeur/agora/wiki/Data-Structure)

If you want to improve & help, you can [Install & Contribute](https://github.com/scenaristeur/agora/wiki/Install)