Lors de l’installation du nouveau logiciel de forums sur Roumazeilles.net (bbPress) [il s’agissait uniquement d’une évaluation qui ne sera pas prolongée pour le moment], j’ai noté les actions détaillées que j’ai dû suivre pour obtenir une configuration convenable et complètement opérationnelle. Comme bbPress n’est documenté que de manière assez spartiate, cela pourra peut-être aider quelqu’un d’autre.
Cible
Le premier objectif était d’installer deux jeux de forums (en français et en anglais) dans leurs URLs respectives.
Leur emplacement avait une influence sur le reste parce que je souhaitais conserver une excellente intégration avec les deux blogs à base de WordPress. Il est vivement conseillé d’installer les forums à l’intérieur même du blog correspondant.
Voilà comment j’ai fait.
Configuration
La principale préoccupation a été de choisir le bon emplacement. Le package est préparé pour être installé dans un sous-répertoire bbpress
dans le répertoire wordpress
; j’ai donc dû le renommer après décompression (une fois pour chaque language).
Le fichier config.php
est rempli en fonction de ces éléments :
php
// ** MySQL settings ** //
define('BBDB_NAME', 'roumazeilles'); // The name of the database
define('BBDB_USER', '*********'); // Your MySQL username
define('BBDB_PASSWORD', '**********'); // ...and password
define('BBDB_HOST', 'localhost'); // 99% chance you won't need to change this value
// Change the prefix if you want to have multiple forums in a single database.
$bb_table_prefix = 'frbb_'; // Only letters, numbers and underscores please!
// If your bbPress URL is http://bbpress.example.com/forums/ , the examples would be correct.
// Adjust the domain and path to suit your actual URL.
// Just the domain name; no directories or path. There should be no trailing slash here.
$bb->domain = 'http://www.roumazeilles.net'; // Example: 'http://bbpress.example.com'
// There should be both a leading and trailing slash here. '/' is fine if the site is in root.
$bb->path = '/news/fr/wordpress/forum/'; // Example: '/forums/'
// What are you going to call me?
$bb->name = 'Roumazeilles.net - Forums francophones';
// This must be set before running the install script.
$bb->admin_email = 'wp_fr_@roumazeilles.net';
// Set to true if you want pretty permalinks.
$bb->mod_rewrite = true;
// The number of topics that show on each page.
$bb->page_topics = 30;
// A user can edit a post for this many minutes after submitting.
$bb->edit_lock = 60;
// Your timezone offset. Example: -7 for Pacific Daylight Time.
$bb->gmt_offset = 0;
// Change this to localize bbPress. A corresponding MO file for the
// chosen language must be installed to bb-includes/languages.
// For example, install de.mo to bb-includes/languages and set BBLANG to 'de'
// to enable German language support.
define('BBLANG', 'fr');
// Your Akismet Key. You do not need a key to run bbPress, but if you want to take advantage
// of Akismet's powerful spam blocking, you'll need one. You can get an Akismet key at
// http://wordpress.com/api-keys/
$bb->akismet_key = '1234567890'; // Example: '1234567890'
// The rest is only useful if you are integrating bbPress with WordPress.
// If you're not, just leave the rest as it is.
$bb->wp_table_prefix = 'fr_'; // WordPress table prefix. Example: 'wp_';
$bb->wp_home = 'https://www.roumazeilles.net/news/fr/wordpress'; // WordPress - Options->General: Blog address (URL) // No trailing slash. Example: 'http://example.com'
$bb->wp_siteurl = 'https://www.roumazeilles.net/news/fr/wordpress'; // WordPress - Options->General: WordPress address (URL) // No trailing slash. Example: 'http://example.com'
/* Stop editing */
if ( !defined('BBPATH') )
define('BBPATH', dirname(__FILE__) . '/' );
require_once( BBPATH . 'bb-settings.php' );
?>
Pour avoir un accés plus direct j’ai également corrigé légèrement le fichier .htaccess
du site pour qu’il contienne les lignes de redirection suivantes qui donnent les raccourcis plus symapthiques utilisés un peu partout.
redirect 301 /forum/en https://www.roumazeilles.net/news/en/wordpress/forum/ redirect 301 /forum/fr https://www.roumazeilles.net/news/fr/wordpress/forum/
Etapes supplémentaires
Droits d’accés
J’ai aussi dû modifier les droits d’accés à certains répertoires sur le serveur web.
chmod 644 ./forum/
(peut-être pas critique)
mkdir ./forum/bb-cache/
chmod 644 ./forum/bb-cache/
(nécessaire pour la mise à jour des options de gestion du site)
Thème
bbPress utilise des thèmes de présentation qui sont très similaires à ceux de WordPress. C’est bien pour réduire le volume de travail (et pour éviter d’avoir à apprendre une nouvelle organisation) quand on désire obtenir une présentation homogène et cohérente avec celle d’un thème WordPress existant.
Néanmoins, c’est vraiment pénible d’avoir à préparer autant de fichier que ce que bbPress attend (j’espère bien que cela sera simplifié dans le futur). Quoi qu’il en soit, je ne peux que me féliciter d’utiliser DreamWeaver 3.x dont l’implémentation des templates est très puissante. Par ailleurs, comme une grande partie de mes pages réside véritablement dans le fichier CSS, cela a finalement été une tâche relativement moins ardue. Mais c’est encore trop pour un logiciel fini. Au moins, si vous ne faites rien, le thème Kakumei prend automatiquement en charge vos forums. C’est mieux que rien.
Internationalisation
Ici, souvenons-nous que mon site web est partagé entre l’anglais et le français. Il n’y avait aucune raison pour que les forums ne suivent pas le même chemin. L’installation en anglais est parfaitement standard, bien sûr. Pour le français, j’ai dû procéder à la traduction d’un fichier spéaré (répondant au doux nom de bbpress.pot
) qui fournit tous les textes à traduire.
J’en ai installé un dans le répertoire language
. C’est tout. La traduction n’a rien d’officiel, mais ça me va.
Dernières réflexions
Au bout du compte, après une assez longue phase de test sur un site web dissimulé, j’ai pu installer les forums assez facilement (ça pourrait être mieux, mais bbPress est encore en cours de développement. Ce n’ets donc pas si mal). La documentation est réduite à presque rien, mais la communauté est active et participe bien.
Une chose qui m’a posé problème est que bbPress fait attention à mettre le maximum de choses en cache. Pendant les essais, à chaque changement, il faut penser à vider le cache ou recharger la page du site et non pas du cache. A défaut, vous avez vite l’impression qu’aucune de vos actions ne sert à quoi que ce soit. Enervant, même si les excuses liées à la performance sont compréhensibles.