Face au succès du tutoriel sur l’installation du forum Simple Press, je vous propose la même chose mais en utilisant bbPress – le script de chez Automattic, l’entreprise derrière WordPress.

Mise à jour du 07/09/2011 : la version 2.0 de bbPress est sortie : installation comme n’importe quel plugin WordPress, utilisation de shortcodes, compatibilité avec les thèmes existants, intégration dans le back office de WordPress avec des custom post types sont autant de nouvelles fonctionnalités à découvrir dans le tutoriel sur l’intégration d’un forum dans un blog WordPress.

Présentation

Le site officiel de bbPress ressemble à celui de WordPress.org

Avantages de bbPress

Le principal avantage de bbPress réside dans son extrême légèreté : seulement 617 ko !

Très performant, ce script n’offre pas moins de bonnes capacités d’extensions. Certes, il n’existe pas autant de plugins que pour WordPress – ni même une communauté aussi active, mais les outils sont pour autant de qualité.

Principes de l’intégration avec WordPress

Vous pourriez très bien installer bbPress en quelques minutes… ou vous pourriez aussi vous dire la chose suivante : je dispose d’un blog ou d’un site sous WordPress qui est un script de chez Automattic ! bbPress est également créé par Automattic alors pourquoi ne pas les unir ?

C’est là tout le principe de l’intégration qui aura pour effet de :

• Partager la même base de données : utiliser une seule et unique base pour bbPress et WordPress ;
• Connexion unique : utilisez vos identifiants pour vous connecter aussi bien dans WordPress que sous bbPress. Les cookies étant les mêmes, vous serez donc connectés sur les 2 sites avec le même identifiant ;
• Processus d’inscription : quand un utilisateur s’enregistre sur votre forum bbPress, il est automatiquement ajouté dans la liste des utilisateurs de WordPress. Vous pourrez donc définir le rôle par défaut appliqué à chaque nouveau compté créé ;

Installer bbPress

Commencez donc par télécharger l’archive ZIP à partir du lien suivant :

bbPress 1.0

La gestion d'un forum par les créateurs de WordPress.

Taille : 602,5 KiB  •  Date : 16 octobre 2010 •  Hits : 1 397

Une fois téléchargé, décompressez l’archive dans le dossier de votre choix puis téléversez le tout dans un dossier de votre serveur FTP.

Par exemple, si votre blog WordPress est présent à la racine de votre domaine, créez un nouveau dossier que vous nommerez forum – ou autre, puis déposez à l’intérieur de celui-ci le contenu de bbPress.

Téléchargez maintenant les fichiers de traduction française de bbPress :

bbPress, fichiers de traduction française

bbPress est disponible en français.

Taille : 77,1 KiB  •  Date : 16 octobre 2010 •  Hits : 1 575

Déposez ces 2 fichiers à l’intérieur du dossier my-languages que vous devrez créer s’il n’existe pas.

Lançons à présent le processus d’installation à proprement parler. Il suffit d’ouvrir le navigateur de votre choix puis de saisir l’URL de votre site + le nom du dossier contenant bbPress : http://VOTRESITE/forum/

Processus d’installation de bbPress

Étape préliminaire – Bienvenue sur l’utilitaire d’installation de bbPress

Cette étape préliminaire consiste à choisir la langue d’installation. Sélectionnez donc fr_FR puis cliquez sur le bouton Aller à la deuxième étape après que bbPress ait basculé dans la langue de Molière.

Choix de la langue de bbPress

Étape n°1 – Configuration de la base de données

C’est ici que nous allons lier bbPress à la base de données. Rappelons que celle-ci n’a pas besoin d’être créées car nous souhaitons utiliser celle de WordPress.

Il vous faut donc récupérer les informations suivantes :

• Nom de la base de données ;
• Utilisateur de la base de données ;
• Mot de passe de la base de données ;

Toutes ces informations peuvent être obtenues auprès de votre hébergeur ou en éditant le fichier wp-config.php situé à la racine de votre installation WordPress.

Lien entre la base de données et bbPress

Lorsque vos paramètres sont correctement saisis, faites Enregistrer le fichier de configuration de la base de données.

L’utilitaire d’installation de bbPress vous confirme alors que les réglages ont bien été enregistrés.

Création du fichier bb-config.php

Cliquez donc sur Aller à la deuxième étape.

Étape n°2 – Intégration à WordPress

C’est ici que nous allons configurer l’intégration de bbPress à WordPress.

Cochez donc dans un premier temps la case Ajouter les paramètres d’intégration.

D’autres cases à cocher s’affichent ensuite. Cochez donc :

• Ajouter les paramètres d’intégration du cookie pour l’identification unique ;
• Ajouter les paramètres de la base utilisateur de l’intégration pour gérer les utilisateurs depuis WordPress ;

Pour chacune des 2 cases, des champs supplémentaires sont à remplir et autant dire que la liste est longue.

Cookies

Pour obtenir de l’aide quand à la récupération des clés de sécurité, cliquez sur l’icône en forme de point d’interrogation.

Je ne fais donc que reprendre ici les informations fournies par l’aide contextuelle.

Deux endroits stratégiques contiennent ces fameuses clés : la page d’administration secrète de WordPress – de la forme http://VOTRESITE/forum/wp-admin/options.php et le fichier wp-config.php.

N.B : seules les clés contenus dans le fichier wp-config sont réellement utiles. Les autres seront ajoutés automatiquement en principe.

• Adresse de WordPress (URL) : l’adresse Web de votre installation WordPress ;
• Adresse du blog (URL) : l’adresse de votre blog / site ;
• Clef secrète du cookie de WordPress « auth » : cette valeur doit correspondre à la valeur de la constante nommée « AUTH_KEY », contenue dans le fichier wp-config.php de WordPress. Cette dernière remplacera la clef secrète du cookie « auth » de bbPress fixée à la première étape ;
• Clef secrète du cookie de WordPress « auth » : ceci doit correspondre à la valeur du paramètre de WordPress, nomme « auth_salt » de votre instance WordPress. Chercher l’option « auth_salt » dans cette page de l’administration de WordPress. Si vous laissez cette valeur vide, l’utilitaire d’installation tentera de récupérer cette valeur depuis les paramètres d’intégration de WordPress ;
• Clef secrète du cookie de WordPress « secure auth » : cette valeur doit correspondre à la valeur de la constante nommée « SECURE_AUTH_KEY », contenue dans le fichier wp-config.php de WordPress. Cette dernière remplacera la clef secrète du cookie « secure auth » de bbPress fixée à la première étape ;
• Clef secrète du cookie de WordPress « secure auth » : ceci doit correspondre à la valeur du paramètre de WordPress, nomme « secure_auth_salt » de votre instance WordPress. Chercher l’option « secure_auth_salt » dans cette page de l’administration de WordPress. Si vous laissez cette valeur vide, l’utilitaire d’installation tentera de récupérer cette valeur depuis les paramètres d’intégration de WordPress. Parfois cette valeur n’est pas définie dans WordPress, si c’est le cas laisser cette valeur vide ;
• Clef secrète du cookie de WordPress « logged in » : cette valeur doit correspondre à la valeur de la constante nommée « LOGGED_IN_KEY », contenue dans le fichier wp-config.php de WordPress. Cette dernière remplacera la clef secrète du cookie « logged in » de bbPress fixée à la première étape ;
• Clef secrète du cookie de WordPress « logged in » : ceci doit correspondre à la valeur du paramètre de WordPress, nomme « logged_in_sal » de votre instance WordPress. Chercher l’option « logged_in_sal » dans cette page de l’administration de WordPress. Si vous laissez cette valeur vide, l’utilitaire d’installation tentera de récupérer cette valeur depuis les paramètres d’intégration de WordPress ;

Base de données utilisateur

Indiquez le préfixe de votre base de données hébergeant les données de WordPress. Par défaut, il s’agit du préfixe wp_

Si vous utilisez le mode multisite de WordPress – anciennement WordPress Mu, indiquez l’ID du blog principal.

Lorsque tous les champs sont correctement remplis, cliquez sur Enregistrer les paramètres d’intégration à WordPress.

Passage à la trosième étape de l’installation de bbPress

Pour continuer, cliquez sur le bouton Aller à la troisième étape.

Étape n°3 – Réglages du site

Cette dernière partie est une véritable… partie de plaisir !

Remplissez les champs suivants :

• Nom du site : le titre du forum bbPress ;
• Adresse du site (URL) : l’URL du forum automatiquement détectée à ne pas modifier ;
• Identifiant du super administrateur : généralement admin (admin) ;
• Nom du premier forum : le titre du premier forum de bbPress;

Votre forum bbPress est pratiquement opérationnel

Pour valider, faites Enregistrer les réglages du site.

Et là, dans un ultime moment de vérification, cliquez joyeusement sur Compléter l’installation.

Il y a fort à parier que des erreurs d’installation surviennent – notamment si vous n’avez pas rempli toutes les clés.

Toutefois, cela n’empêche en rien le bon fonctionnement de bbPress. Ouvrez donc l’URL du forum et connectez-vous avec votre identifiant / mot de passe de votre administration WordPress.

En cliquant sur le lien Admin, vous retrouverez une interface d’administration très ressemblante à celle de WordPress.

Dans le module Utilisateurs, vous retrouverez les comptes présent sous WordPress.

Les utilisateurs WordPress sont liés à ceux de bbPress

Il ne vous reste plus qu’à trouver un thème sympa et ajouter des extensions pour améliorer votre forum.

Vous goûtez à présent aux joies de l’intégration entre bbPress et WordPress ! Et vous, chers lecteurs, fans de bbPress ?

Crédits photos : Stuck in Customs

A propos de l'auteur

Aurélien Denis est le fondateur du projet WordPress Channel proposant tutoriels et podcasts librement téléchargeables. En 2010, il fonde Neticpro, une agence Web spécialisée WordPress. Il est aussi co-fondateur du site Protuts.net (tutoriels PC/Mac/Linux) et community manager pour l’Imagine Cup 2011/2012, une compétition mondiale organisée par Microsoft. Voir tous les tutoriels de Aurélien Denis →