nodebb-plugin-facebook-post

Plugin NodeBB 4.x : publie automatiquement les nouveaux topics sur une Page Facebook fixe (association), avec images (uploads du forum) et tag de lieu (Facebook Place ID).

Fonctionnement

• L’utilisateur (si autorisé) voit dans le composer :
  • une checkbox : “Publier ce nouveau topic sur Facebook”
  • un champ optionnel : “Lieu (Facebook Place ID)”
• Le plugin ne publie que le 1er post d’un topic (pas les réponses).
• Les images sont extraites du contenu (Markdown/HTML) et filtrées sur le domaine du forum (uploads NodeBB).
• Publication Facebook :
  • upload des photos en published=false
  • création du post /feed avec attached_media[]
  • ajout du paramètre place si un Place ID est fourni

Variables d’environnement (OBLIGATOIRES)

• NODEBB_FB_PAGE_ID : l’ID de la Page Facebook (celle de l’association)
• NODEBB_FB_PAGE_ACCESS_TOKEN : token d’accès de la Page
• NODEBB_FB_GRAPH_VERSION : optionnel (défaut v25.0)
• NODEBB_FB_ALLOWED_GROUPS : liste de groupes NodeBB autorisés (séparés par virgules)
  • ex: Staff,Communication

Exemple :

export NODEBB_FB_PAGE_ID="1234567890"
export NODEBB_FB_PAGE_ACCESS_TOKEN="EAAB..."
export NODEBB_FB_GRAPH_VERSION="v25.0"
export NODEBB_FB_ALLOWED_GROUPS="Staff,Communication"

⚠️ Après modification des variables d’environnement, redémarre NodeBB.

Installation

1. Copier le dossier du plugin dans node_modules/nodebb-plugin-facebook-post (ou publier via git/npm, au choix).
2. Rebuild & restart :

./nodebb build
./nodebb restart

3. ACP → Plugins → activer “Facebook Post”.
4. ACP → Plugins → Facebook Post : activer + régler options.

Notes

• Le plugin enregistre fbPostedId et fbPostedAt dans le post pour éviter les doubles publications.
• Si une image n’est pas accessible publiquement (permissions/catégorie privée), Facebook ne pourra pas la récupérer via url=.