Installer un plugin Discourse

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.

 

 

Ajouter son plugin à la configuration de Discourse

Une fois connecté à votre serveur, entrez 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.

 

 

Mettre à jour Discourse

Connectez-vous à 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 !

 

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 (voir guide : Le Safe Mode, pour trouver la source d’un problème)

 

(image de présentation : freepik.com – modifiée)

Auteur de l’article : Steven

Webmaster depuis 2003, j'ai œuvré en particulier sur des forums tournant sur phpBB avant de prendre le virage plus moderne avec Discourse en 2013 sur les conseils de mon associé sur iunctis.fr où je gère l'aspect technique. Ayant pas mal galéré au début, je propose des guides et mes services pour aider les débutants.

4 commentaires sur “Installer un plugin Discourse

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *