Mingle Forum est une extension pour créer un forum avec WordPress qui n’est plus maintenue depuis plusieurs années. Afin d’éviter la perte de vos contenus, la solution la plus viable consiste à migrer vos données sous bbPress.
bbPress fait partie intégrante de l’écosystème WordPress au sens où cette extension est développée par Automattic et qui propulse les forums de supports WordPress.
Ce tutoriel fait suite à un cas client que j’ai récemment eu à traiter. La mission consistait à basculer de Mingle Forum vers une solution viable et c’est finalement bbPress que j’ai retenu comme solution technique. En effet, les extensions trop anciennes finissent par générer des incompatibilités ou des erreurs en bases de données comme ce fut le cas ici générant des instabilités serveur.
Avant de migrer vers bbPress
Une migration reste une étape délicate et il nous faut procéder étapes par étapes afin d’éviter les déconvenues :
- Sauvegardez intégralement votre site et notamment la base de données MySQL ;
- Créez une installation locale de WordPress afin de procéder à l’importation des données indépendamment du site de production ;
- Installez bbPress 2.5 sur la version locale (la version 2.6 n’est pas encore finalisée et l’importation n’a pas fonctionné dans mon cas) ;
À partir de là, nous disposons d’un environnement de test capable d’importer les données du site de production.
Importer les données de Mingle Forum vers bbPress
Le gros avantage de bbPress est qu’il dispose d’outil d’importation en natif. Par chance, Mingle Forum est pris en charge dans les outils mis à notre disposition.
Pour ce faire, rendez-vous dans Outils puis Forums. Ouvrez ensuite l’onglet Importer des forums puis respectez les étapes que voici :
- Dans Choisir une plateforme optez pour Mingle ;
- Spécifiez l’adresse IP ou l’hôte qui héberge la base de données à migrer. Il s’agit généralement de l’URL de votre site Web ;
- Laissez le port de la base sur 3306 sauf si votre hébergeur en utilise un autre ;
- Indiquez à présent les identifiants de connexion à la base de données que vous trouverez facilement dans votre fichier wp-config.php situé à la racine de votre installation WordPress (nom de la base, nom d’utilisateur de la base, mot de passe de la base et préfixe des tables) ;
Nous disposons également de quelques options intéressantes :
- Limiter les lignes : il s’agit du nombre de lignes à traiter en une passe, vous pouvez l’augmenter si votre serveur est suffisamment puissant afin de réduire le temps de migration. Pour ma part, j’ai monté à 500 sans aucun soucis mais j’utilise un serveur dédié en production et un serveur local bien optimisé également ;
- Délai : c’est le nombre de secondes de délai entre chaque traitement de ligne, vous pouvez laisser sur 1 ou augmenter à 3 secondes en cas de soucis ;
- Convertir les utilisateurs : laissez décoché si vous migrez d’une plateforme reposant déjà sur WordPress et que ses utilisateurs ont déjà étaient importés. Dans le cas contraire, il vous faut la cocher afin de récupérer les comptes utilisateurs. Notez que les mots de passe devront probablement être réinitialisés dans le deuxième cas ;
- Recommencer : à cocher si vous souhaitez redémarrer à zéro la migration des données. Comme indiqué, il sera nécessaire de nettoyer les données au préalable. Je préconise de faire une sauvegarde de votre base avant la migration et de la restaurer en cas d’échec pour repartir sur un état sain ;
- Purger les importations précédentes : à cocher avec la case précédent si vous tentez une nouvelle importation de zéro ;
Une fois les réglages finement paramétrés, faites Démarrer pour lancer le processus de migration. Notez que les données d’origine ne seront pas supprimés mais simplement copiés.
En fonction de la quantité de données à migrer, la migration pourra prendre de quelques minutes à plus d’une heure pour les forums très volumineux comme ce fut le cas lors de la migration de PunBB à bbPress pour l’association WPFR.
Vérification post-migration
Une fois les anciennes données correctement importées dans votre installation neuve de bbPress, je vous recommande de vérifier les points suivants :
- Comparez le nombre d’utilisateurs, de forums, de sujets et de réponses entre les deux systèmes de forum pour s’assurer que toutes vos données sont bien importées ;
- Prenez soin de reconstruire la structure du forum si nécessaire, il y a de fortes chances que la structure de Mingle Forum ne soit pas respectée ;
- Nettoyez les contenus qui utilise du BBCode à l’aide de scripts si nécessaire ou bien activez cette option à l’aide d’une extension comme GD bbPress Tools ;
- Assignez les utilisateurs aux rôles qui convient comme participant ou modérateur ;
Je vous invite également à lire les spécifications techniques sur le codex bbPress concernant Mingle Forum et l’importation des données.
