Installer un plugin sur Discourse

discourse

#1

Sommaire :

  1. Se connecter au serveur
  2. Ajouter son plugin à la configuration de Discourse
  3. Mettre à jour Discourse
  4. Vous rencontrez un problème ?


1. Se connecter au serveur


Utilisez l’application Terminal sur MAC ou le logiciel Putty sur Windows pour vous connecter à votre serveur avec l’adresse IP de celui-ci, votre identifiant root et mot de passe.

  • MAC : entrez la commande ssh root@00.00.00.00 (remplacez 00.00.00.00 par l’ip de votre serveur) puis entrez le mot de passe quand il vous le sera demandé

  • PC : exécutez putty.exe, dans Host Name (or IP Address) inscrivez l’ip de votre serveur et dans Connection type : SSH, cliquez ensuite sur Open. Un terminal s’ouvrira, entrez d’abord votre pseudo root puis le mot de passe.

Voir le guide Comment utiliser putty.exe pour mieux connaître le fonctionnement du programme et du terminal.


2. Ajouter son plugin à la configuration de Discourse


Une fois connecté à votre serveur, tapez les commandes suivantes :

cd /var/discourse
nano containers/app.yml

Le fichier de configuration de Discourse s’ouvre alors, il fait généralement une centaine de lignes. autour de la ligne 80 vous aurez le code suivant :

## Plugins go here
## see https://meta.discourse.org/t/19157 for details
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git

Juste après la ligne mentionnant docker_manager.git, ajoutez une ligne similaire puis le lien de votre plugin. Par exemple, pour installer la Discourse Formatting Toolbar il vous faudra ajouter le code :

          - git clone https://github.com/iunctis/discourse-formatting-toolbar.git

Ce qui donne au final :

## Plugins go here
## see https://meta.discourse.org/t/19157 for details
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/iunctis/discourse-formatting-toolbar.git

Vous pouvez ajouter plusieurs plugins de cette façon, comme ceci :

## Plugins go here
## see https://meta.discourse.org/t/19157 for details
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/iunctis/discourse-formatting-toolbar.git
          - git clone https://github.com/discourse/discourse-spoiler-alert.git
          - git clone https://github.com/iunctis/discourse-affiliate.git

Sauvegardez les modifications en suivant les instructions de nano (sur windows il faut faire CTRL+X puis Y et Entrée). Le plugin est ajouté à la configuration, il reste une étape à franchir : mettre à jour Discourse.


3. Mettre à jour Discourse


Soyez connectés à votre serveur et entrez les commandes suivantes :

cd /var/discourse
git pull
./launcher rebuild app

Discourse va alors se “reconstruire”, cette étape peut prendre de 5 à 15 minutes, votre forum Discourse sera inaccessible durant cette mise à jour.

Quand vous pouvez à nouveau taper une commande, vous pouvez lancer un petit nettoyage avec la commande :

./launcher cleanup app

Puis quitter le terminal. Votre forum sera à nouveau disponible et le plugin sera ajouté à Discourse !


4. Vous rencontrez un problème ?


  • Sur certaines versions d’Ubuntu fournies avec votre serveur, l’éditeur de texte nano n’est pas installé par défaut, vous pouvez l’installer simplement en vous connectant à votre serveur : sudo apt-get install nano

  • Si vous rencontrez une erreur FAILED TO BOOTSTRAP durant la mise à jour de Discourse, Il peut y avoir plusieurs causes :

  • Une erreur de syntaxe dans le fichier de configuration de Discourse, copiez/collez le contenu du fichier app.yml dans ce YALM Validator : http://codebeautify.org/yaml-validator. Ce site vous indiquera si vous avez commis une erreur.

  • Il est aussi possible que le plugin soit en cause. Êtes-vous sûrs qu’il est compatible avec votre version de Discourse ? Demandez conseil à l’auteur du plugin.

  • L’installation semble s’être bien déroulée mais votre forum a un comportement anormal ? Essayez le mode sans échec (safe-mode) de Discourse : http://adresse-de-votre-forum/safe-mode. Pour iunctis, le safe-mode est à l’adresse suivante : https://iunctis.fr/safe-mode


Formatting Toolbar : options de mise en forme
Suivre @iunctisFR sur Twitter - Programme Partenaire amazon.fr : Amazon Prime - Amazon Prime Video - Amazon Audible