Installer un mod sur votre forum

[Abraham]

Bonsoir,
 
Aujourd'hui nous allons voir comment installer un "mod" pour votre forum fluxBB. Il faut savoir avant tout que l'installation d'un mod se fait en trois étapes. En premier lieu, vous devez télécharger le mod sur le site officiel de FluxBB (ils sont un minimum contrôlé et passé au peigne fin afin d'éviter tout problème), ensuite vous devrez uploader vos fichiers sur votre FTP et vous rendre sur une page, et dans un dernier temps, il sera nécessaire de modifier quelques fichiers de votre forum.
 
TELECHARGEMENT

Dans cet exemple, nous utiliserons un mod simple : FluxToolBar  qui permet d'installer une barre d'outils pour personnaliser vos messages. Rendez-vous sur cette page et télécharger le mod.

Par la suite, extrayez l'archive vers votre bureau par exemple.

Vous devriez avoir un fichier readme.txt ainsi qu'un dossier files. Le contenu du dossier files doit être envoyé à la racine de votre forum sur votre FTP. Conservez précieusement le fichier readme.txt sur votre espace de travail. Voilà, vous avez correctement télécharger le mod et vous l'avez préparé sur votre FTP.

INSTALLATION

Rendez-vous sur la page install_mod.php sur votre forum. En réalité, cette étape configure votre base de données pour qu'elle puisse accuellir le mod. La plus part d'entre eux ont besoin d'une configuration du côté de la base de données. Cliquez sur Install. L'installation devrait se dérouler sans encombre et vous devriez rencontrer un message vous informant du succès de l'information.

Une fois que c'est fait, vous pouvez supprimer le fichier install_mod.php de votre dossier FTP.

CONFIGURATION

Cette étape est généralement la plus difficile. Ouvrez le fichier readme.txt avec un IDE (je conseille Notepad++ ou bien Sublime Text 2), enfin généralement avec celui avec lequel vous développez en PHP. Vous devriez tomber sur quelque chose de la sorte :

Ceci sont les informations préliminaires. Je vous conseille de les lire attentivement pour être au courant de comment va se dérouler la configuration.

L'idée, à présent, et de suivre attentivement le processus décrit sur ce fichier readme.txt
A chaque changement, le fichier va vous informer de :

• Le fichier à modifier
• La ligne approximative
• Le type de changement (s'il faut carrément modifier, ajouter, supprimer ...)
• La position du changement (si c'est avant la ligne, après, ou sur la ligne en cas de modification)

Par exemple :

Ici, on nous informe que l'on doit trouver le texte suivant ( FIND ) :

<?php endif; ?>						<label class="required"><strong><?php echo $lang_common['Message'] ?> <span><?php echo $lang_common['Required'] ?></span></strong><br />
						<textarea name="req_message" rows="20" cols="95" tabindex="<?php echo $cur_index++ ?>"><?php echo isset($_POST['req_message']) ? pun_htmlspecialchars($orig_message) : (isset($quote) ? $quote : ''); ?></textarea><br /></label>

et que l'on doit le remplacer intégralement (REPLACE WITH) par le code qui suit :

<?php endif; ?>						<label class="required"><strong><?php echo $lang_common['Message'] ?> <span><?php echo $lang_common['Required'] ?></span></strong><br />
						<textarea id="req_message" name="req_message" rows="20" cols="95" tabindex="<?php echo $cur_index++ ?>"><?php echo isset($_POST['req_message']) ? pun_htmlspecialchars($orig_message) : (isset($quote) ? $quote : ''); ?></textarea><br /></label>
<?php /* FluxToolBar */
if (file_exists(FORUM_CACHE_DIR.'cache_fluxtoolbar_form.php'))
	include FORUM_CACHE_DIR.'cache_fluxtoolbar_form.php';
else
{
	require_once PUN_ROOT.'include/cache_fluxtoolbar.php';
	generate_ftb_cache('form');
	require FORUM_CACHE_DIR.'cache_fluxtoolbar_form.php';
}
?>

La difficulté de l'opération est d'être vraiment très minutieux. Il ne faut pas omettre ne serait qu'un seul caractère, sinon vous ferez planter l'intégralité de votre forum.

Une fois que vous avez réalisé toutes les instructions, il faudra envoyer sur votre FTP tous les fichiers préalablement modifiés, et le tour est jouer !
Généralement, il est nécessaire de se rendre sur le panel administration pour activer votre mod sur le forum, mais ce n'est pas toujours le cas.

REMARQUES ANNEXES

• Je vous conseille de faire une sauvegarder de votre forum (fichiers + SQL) avant chaque installation de mod, en tout cas au début afin de ne pas avoir de mauvaises surprises en cas d'erreur.
• Prenez votre temps : n'essayez pas d'aller vite car vous serez dégouter si vous voyez que votre forum plante à l'arrivée.
• Chaque mod de FluxBB.org possède un topic propre à ce mod où sont répértoriées les questions / informations. N'hésitez pas à vous y rendre en cas de doute.

Dans un prochain chapitre, nous verrons comment inclure votre forum dans un site, par exemple.

[Azad]

Bon tutoriel pour les initiés de FluxBB, bien pédagogue.

L'ajout d'image facilite la compréhension, tout comme les remarques annexes.
Il faudrait aussi faire un petit tutoriel pour la sauvegarde d'un forum (SQL / FTP), mais sinon très bon boulot.

+3 Rep.

[vfrz]

Bravo à toi !

[Abraham]

Ouai, je peux le faire, si tu veux

Merci à vous deux

[Soulalex]

Bon tutoriel