Script de mise à jour de page d'accueil ForumActif

Un court article pour partager une méthode bien pratique pour mettre à jour la page d'acceuil d'un forum ForumActif :

Logo de l'association L'Auberge des Rêveurs

Contexte

Une association de jeux de rôle a mis en place un site ForumActif. Cet hébergeur inclus dans ses forums phpBB la possibilité de créer des pages HTML statiques, et de les utiliser comme page d'accueil :

Capture d'écran du module d'administration des pages HTML

J'ai donc développé une page d'accueil assez simple mais un peu plus attractive / lisible que celle "de base" des sites ForumActif.

Le code est herbergé sur FramaGit : https://framagit.org/auberge-des-reveurs/website-homepage/ (❤️ Gitlab & FramaSoft)

Et tout le contenu du site (images, CSS, JS...) est hebergé via des Gitlab Pages : https://auberge-des-reveurs.frama.io/website-homepage/

Néanmoins, l'activation / mise à jour de la page d'accueil statique sur ForumActif doit se faire manuellement, via l'interface d'administration du forum. Hors, je souhaitais que la page d'accueil du site soit mise à jour automatiquement, à chaque commit sur le repository git, via la pipeline Gitlab CI qui déployait déjà le site en Gitlab Pages.

Solution

J'ai développé un court script Bash employant curl & python qui permet de :

  1. s'authentifier sur le forum, et ainsi récupérer un cookie sid et un token tid
  2. uploader une nouvelle version de la page statique (index.html)

Le script est ici : set_phpbb_html_homepage.sh

Et la pipeline est décrite ici : .gitlab-ci.yml

J'espère que ça pourra être utile à d'autres administrateurs de sites ForumActif 😋