# Installer Mangane pour Pleroma sur Yunohost
Mangane est une interface utilisateur alternative pour [Pleroma](https://pleroma.social/), [Akkoma](https://akkoma.social/) et Mastodon qui se veut plus aisée à prendre en main et plus accessible que l’interface par défaut de l’application (Pleroma FE).
Mangane ajoute aussi quelques fonctionnalités à Pleroma/Akkoma, parmis lesquelles:
- Programmation de publication des status (existe maintenant aussi avec Mastodon).
[Mangane](https://github.com/BDX-town/Mangane) est une divergence (`fork`) de l’interface Soapbox, créée pour l’instance Pleroma bordelaise [BDX-Town](https://bdx.town/). C’est un logiciel libre distribué sous licence AGPL (GNU Affero General Public License) version 3 ou suivantes.
### Prérequis
Normalement Pleroma permet d’installer facilement des modules supplémentaires depuis l’interface d’administration (Pleroma BE) ou à la ligne de commandes.
Dans le cas d’une installation de Pleroma avec Yunohost cela ne fonctionne cependant _pas_ directement (voir [#215](https://github.com/YunoHost-Apps/pleroma_ynh/issues/215)), ni depuis l’interface d’administration, ni en CLI. Le problème vient du fait que le package Pleroma pour Yunohost adapte l’emplacement des composants de l’application dans le système de fichiers...
Mais ces modifications ne sont _pas_ actuellement correctement reportées en base de données, et peu ou pas documentées.
> Note : Il faut aussi avoir en tête, lorsque l’on lit la documentation officielle de Pleroma/Akkoma ou de Mangane, que Yunohost installe Pleroma à partir de la version dite OTP (et non à partir des sources), ce qui est recommandé. Les commandes CLI ne sont par contre pas les mêmes
### Installation en mode graphique
**1-** Se connecter à l’interface d’administration.
**2-** Corriger l’emplacement du répertoire statique (menu `Setting` sous menu `Instance`) qui contient l’ensemble des fichiers spécifiques à notre instance de Pleroma.
```
/home/yunohost.app/pleroma/static
```
**3-** Aller à la section de configuration des interfaces publiques (menu `Setting`sous menu `Frontend`) qui propose plusieurs options par défaut, mais _pas_ Mangane.
Choisir donc l’option d’installer une « autre interface » (_Install another frontend_) et compléter le formulaire avec les informations suivantes:
Champ « Name »
```
mangane
```
Champ « Reference »
```
dist
```
Champ « Build URL »
```
https://github.com/BDX-town/Mangane/releases/latest/download/static.zip
```
Champ « Build directory »
```
dist
```
Un peu plus bas dans la même page (section `Frontends/Primary`) il faut maintenant activer Mangane comme interface par défaut:
Champ « Primary »
```
mangane
```
Champ « Reference »
```
dist
```
Enregistrer ! C’est fait !
Le changement prend effet immédiatement, actualisez simplement l’onglet ou la fenêtre du navigateur. Il n’est normalement pas nécessaire de redémarrer Pleroma/Akkoma.
### Installation avec la ligne de commande
Remarque préliminaires: le commandes pour `pleroma_ctl` doivent être passées en tant qu’utilisateur `pleroma` ce qui impose une syntaxe une peu particulière à celle-ci (voir dans la [documentation](https://docs-develop.pleroma.social/backend/administration/CLI_tasks/config/#transfering-the-config-tofrom-the-database) de Pleroma).
**1-** Tout d’abord, corriger là aussi le bug des paramètres erronés de configuration stockés en base de données.
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl config migrate_to_db"
```
**2-** Télécharger et installer l’archive ZIP de Mangane.
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl frontend install mangane --ref dist --build-url https://github.com/BDX-town/Mangane/releases/latest/download/static.zip"
```
C’est installé !
Il faudra alors modifier le champ primary dans l'interface d'administration, comme avec la méthode graphique.
Le changement prend effet immédiatement, il suffit d’actualiser l’onglet ou la fenêtre du navigateur. Il n’est normalement pas nécessaire de redémarrer Pleroma/Akkoma.
> Note : partiellement testé IRL (c’est en cours). Donc attention quand même.
### Problèmes connus
- Si l’on est connecté à l’interface d’admin de Yunohost il n’est pas possible de se connecter en même temps à son compte Pleroma.
- La programmation de publication différée des status (pouets) ne fonctionne pas avec Pleroma ([référence](https://github.com/BDX-town/Mangane/issues/106)). C’est un bug au niveau de Pleroma, cela fonctionne correctement avec Akkoma.
### Pleroma Vanilla vs Pleroma avec Yunohost
Les différences entre une installation _vanilla_ de Pleroma et l’installation avec le package de Yunohost :
https://pad.tmprs.net/s/JhBnk5kRe#
---
23/01/2023 -- En relecture
- Ajout de `sudo` aux commande
- Correction du lien vers le document sur les particularités de l’installation de Pleroma avec l’application YNH.
- Important: correction du chemin d’accès à `pleroma_ctl` et de l’appel se celle-ci, pour l’installation en CLI.
- Ajout d'une section sur les bugs et problèmes