====== Administration de Pleroma sur Yunohost – Cheat Sheet ======

===== Documentation officielle de Pleroma =====


https://docs-develop.pleroma.social

===== Gestion des utilisateurs =====

[[https://docs-develop.pleroma.social/backend/administration/CLI_tasks/user/]]

==== Créer un utilisateur ====

<code>
cd /var/www/pleroma/pleroma
MIX_ENV=prod mix pleroma.user new <username> <emailL>
</code>


Différentes options peuvent être ajoutées lors de la création d’un compte :

  *     ''--name <name>'' – the user’s display name
  *     ''--bio <bio>'' – the user’s bio
  *     ''--password <password>'' – the user’s password
  *     ''--moderator/--no-moderator'' – whether the user should be a moderator
  *     ''--admin/--no-admin'' – whether the user should be an admin
  *     ''-y, --assume-yes/--no-assume-yes'' – whether to assume yes to all questions

==== Désactiver un utilisateur ====

<code>
cd /var/www/pleroma/pleroma
sudo MIX_ENV=prod mix pleroma.user toggle_activated <username>
</code>

==== Supprimer un utilisateur ====

<code>
cd /var/www/pleroma/pleroma
sudo MIX_ENV=prod mix pleroma.user toggle_activated <username>
</code>
==== 
Supprimer les interactions d’un utilisateur (ne fonctionne pas chez moi ??) ====

<code>
cd /var/www/pleroma/pleroma
sudo MIX_ENV=prod mix pleroma.user toggle_activated <username>
</code>



==== Redémarrer pleroma ====

''sudo systemctl restart pleroma''

===== Version 2.X.X =====

Fichier de config : ''/etc/pleroma/config.exs''

Répertoire des emoji : ''/home/yunohost.app/pleroma/static/emoji/'' 

Répertoire des emojis personalisées : ''/home/yunohost.app/pleroma/static/emoji/custom''

(le fichier texte emoji.txt vient se placer dans ce même dossier)

Répertoire uploads : ''/home/yunohost.app/pleroma/uploads'' 

==== Personalisation du frontend de l'instance :  ====

Lors des mises à jour, Yunohost ajoute un nouveau dossier dans ''/var/www/pleroma/pleroma/lib/'', ce qui fait que les personalisations faites pour le frontend de l'instance sautent à chaque fois. Pour restaurer les personalisations, procéder comme suit : 

Se rendre dans le répertoire /home/admin où sont stockés les différents fichiers : 

<code>
cd /home/admin/
</code>

Copier les différents fichiers dans les répertoires où ils doivent se trouver (remplacer ''pleroma-2.4.2-8-gb34f0a6e-release-2-4-2'' par le répertoire de la nouvelle version de Pleroma : 

<code>
cp favicon.png /var/www/pleroma/pleroma/lib/pleroma-2.4.2-8-gb34f0a6e-release-2-4-2/priv/static/favicon.png
cp logo-blobbrocco-rogne.png /var/www/pleroma/pleroma/lib/pleroma-2.4.2-8-gb34f0a6e-release-2-4-2/priv/static/static/logo-blobbrocco-rogne.png
cp terms-of-service.html /var/www/pleroma/pleroma/lib/pleroma-2.4.2-8-gb34f0a6e-release-2-4-2/priv/static/static/terms-of-service.html
cp logo-blobbrocco-rogne.png /var/www/pleroma/pleroma/lib/pleroma-2.4.2-8-gb34f0a6e-release-2-4-2/priv/static/images/logo-blobbrocco-rogne.png
cp Brocoli-Wallpaper.jpg /var/www/pleroma/pleroma/lib/pleroma-2.4.2-8-gb34f0a6e-release-2-4-2/priv/static/images/Brocoli-Wallpaper.jpg
cp nsfw.74818f9_new.png /var/www/pleroma/pleroma/lib/pleroma-2.4.2-8-gb34f0a6e-release-2-4-2/priv/static/images/nsfw.74818f9_new.png
</code>


==== Mascotte ====

Par défaut : ''pleroma_fox_tan''

Dans Yunohost, image dans : ''var/www/pleroma/pleroma/lib/pleroma-2.0.5-stable/priv/static/images/''

<code>
config :pleroma, :assets,
  mascots: [
    pleroma_fox_tan: %{
      url: "/images/pleroma-fox-tan-smol.png",
      mime_type: "image/png"
    },
    pleroma_fox_tan_shy: %{
      url: "/images/pleroma-fox-tan-shy.png",
      mime_type: "image/png"
    }
  ],
</code>

{{tag>[linux yunohost pleroma]}}