Note : nous avions perdu précédemment ce tutoriel ; un énorme merci à Alain Verwee de nous en avoir envoyé une copie !
Ce document se veut être simplement la traduction et une adaptation du “lisez-moi” écrit par Kindred, lisible sur ce message. Nous n'avons aucunement testé ce guide d'installation, et nous ne supporterons aucun problème lié à cette intégration. En cas de problème :
<span style="color: red;"><strong>NOTEZ BIEN</strong> qu'il y a désormais DEUX versions du pont SMF-Mambo.</span></p>
<ul style="color: red;">
<li> Celui appelé <tt>MOS_SMF_BRIDGEv3.19a_stable.zip</tt> est à utiliser avec SMF 1.0.5.</li>
<li> Celui titré <tt>MOS_SMF_BRIDGEv3.19a_SMF1.1b3.zip</tt> est à utiliser avec SMF 1.1 Beta 3 (Publique).</li>
</ul>
<p style="color: red;">Ces ponts ne fonctionneront qu'avec la version de SMF pour laquelle ils ont été écrits ! Veuillez vous assurer que vous utilisez bien la bonne version du <i>bridge</i> avant d'en commencer l'installation !</span>
Notez aussi qu'il existe deux bridges maintenus à ce jour. Nous vous recommandons fortement de préférer celui écrit, maintenu et supporté par Theodore Hildebrandt, alias Orstio.
Voici une liste de ce que vous aurez besoin pour compléter l'intégration de SMF dans Mambo.
/* * Ceci sont les instructions d'installation et autres notes pour * le pont SMF pour Mambo Open Source v4.5.1 & 4.5.2 * Version 3.01 Stable pour SMF 1.0.1+ créé en janvier 2005 * Créé par Theodore Hildebrandt alias Orstio * http://www.gnu.org/copyleft/gpl.html GNU/GPL * everyt9@everything-science.com * www.everything-science.com */
Il devrait être noté, avant de commencer l'installation de ce pont, que ces instructions assument que vous avez déjà installé avec succès et faites fonctionner, indépendemment l'un de l'autre, Mambo OpenSource et SMF.
Pour plus de simplicité, si vous ne savez pas exactement ce que vous faites:
D'abord, décompressez l'archive .zip du pont SMF-Mambo sur votre ordinateur. Ceci créera quelques nouveaux fichiers et sous-dossiers.
Après l'extraction, rendez-vous dans le dossier Login et décompressez l'archive Login.zip dans ce même dossier. Ceci extraira ces nouveaux fichiers:
Maintenant que vous avez à votre disposition tous les fichiers utiles, vous pouvez vous connecter à votre compte FTP chez votre hébergeur et commencer l'installation.
En utilisant votre client FTP ou votre interface WebFTP, transférez le fichier MOS_SMF.php du dossier local /Login dans le répertoire /Sources de votre forum SMF.
Installez les composantes de SMF dans Mambo.
Maintenant, dans SMF, rendez-vous dans votre Centre d'administration > Gestionnaire de paquets. Pour vous rendre dans votre Centre d'administration, un bouton “Admin” se trouve dans le menu d'entête, entre “Recherche” et “Profil”.
Cliquez sur le lien [Récupérer des nouveaux paquets]. À l'aide de l'outil “Transférer un Paquet”, transférez le paquet mambo.tar.gz et installez-le. (Ceci fixe les appels à obExit(); afin que tout soit bien intégré dans une même page.)
Installez, dans Mambo, la composante d'inscription de SMF.
Ceci utilise les options d'inscription par défaut réglées dans votre Mambo admin> Global Configuration, comme toute inscription dans Mambo.
Installez le module «smf_login».
Modifiez le fichier index.php de votre thème de Mambo.
<?php
global $sc, $context;
if (!defined('SMF')){
require ($mosConfig_absolute_path."/administrator/components/com_smf/config.smf.php");
require ($smf_path."SSI.php");
}
$sc = &$context['session_id'];
$_SESSION['USER_AGENT'] = $_SERVER['HTTP_USER_AGENT'];
?>
Il n'est plus nécessaire d'appliquer des modifications au thème par défaut (les modifications nécessaires à la bonne intégration de SMF dans Mambo sont fait automatiquement à l'installation du bridge). Quiconque a déjà précédemment effectué une modification de thème n'a pas non plus à re-modifier son thème.
⇒ Si (et SEULEMENT si) vous faites fonctionner Mambo et SMF dans des bases de données séparées et/ou vous ne souhaitez pas intégrer SMF et Mambo dans une même page, effectuez cette étape.
Si vous faites fonctionner SMF indépendemment de Mambo, si vous utilisez une version précédente du pont SMF-Mambo ou utilisez un thème autre que celui par défaut, les modifications suivantes doivent encore être appliquées:
action=login2 pour exécuter plutôt action=mambo_loginaction=logout pour exécuter plutôt action=mambo_logout$txt['welcome_guest'] dans les fichiers /Themes/default/languages/index.[langues].php pour qu'elle corresponde à celle-ci:$txt['welcome_guest'] = 'Bienvenue, <b>' . $txt[28] . '</b>. Veuillez vous connecter ou <a href="'. $GLOBALS['mosConfig_live_site'] .'/index.php?option=com_smf_registration&task=register">vous enregistrer</a>.';
Configurez la composante SMF dans votre Mambo Admin.
Notez que si vous faitez fonctionner Mambo et SMF sur une même base de données, la partie BASE_DE_DONNÉES_[MAMBO/SMF] n'est pas requise. (Bien que cela ne causerait aucun problème et peut prévenir l'apparition de problèmes futurs si c'est présent.)
Choisissez si vous voulez utiliser un forum intégré, imbriqué dans Mambo, ou de le faire apparaître sur une page indépendante. Il devrait être noté qu'il existe trois états possibles de présenter votre intégration SMF-Mambo:
Le pont est livré avec une variable $forum_version configurée par défaut à “SMF 1.0.x pour Mambo”. Si vous cliquez sur le lien “update” dans la configuration des composantes, il mettra à jour votre forum pour qu'il affiche la version correcte de SMF et inclura tout mods qui modifiait l'index.php de SMF.
Vous voudrez sans doute installer SMF avec les réglages par défaut…
Si vous choisissez de rendre le menu d'items de Mambo (dans les composantes de SMF) disponible uniquement aux utilisateurs enregistrés, la connexion et l'inscription à votre forum peuvent ne pas fonctionner correctement.
Les courriels d'activation devraient être envoyés par Mambo.
Changer le type de documents de SMF pour passer de XHTML à HTML corrigera la majorité des problèmes liés à des caractères super larges. Ceci peut être effectué simplement en changeant la ligne correspondante, dans le haut de l'index.template.php de votre thème de SMF. Toutefois, certains thèmes Mambo et SMF ne vont pas de paire.
Dans le thème Mambo, les taillez fixes au-dessous de 500 pixels de largeur représentent des difficultés pour SMF pour bien s'afficher dans le tableau. Deux options principales s'offrent à vous.
Additionnellement à ce problème de tailles, certaines classes CSS s'entre-coupent entre Mambo et SMF. Vous devriez alors faire un peu de ménage dans vos deux fichiers CSS.
Deux dossiers supplémentaires ont été extraits lors de la décompression de l'archive zip du pont MOS_SMF: /mosbot et /misc modules.
Dans /mosbot, il y a un utilitaire Mambot qui offre un “lien de discussion” à être inséré dans Mambo News Items. Ce lien créera un nouveau sujet, si ce n'est pas déjà fait précédemment. Si un sujet liant vers un item de nouvelle inexistant, le lien va simplement ajouter une réponse de la part de l'utilisateur en cours.
Dans /misc modules, il y a 6 nouveaux modules qui utilisent des fonctions variées du fichier SSI.php de SMF, pour afficher plusieurs informations de votre forum dans l'environnement de Mambo. Ces modules peuvent être chargés directement dans Mambo Admin > Modules > Install/Uninstall Modules.
Vous devriez maintenant disposer de votre forum SMF intégré à votre SGC Mambo OpenSource. Nous nous permettons de vous rappeler, une nouvelle fois, ce guide n'a pas été testé par nos soins. Nous serions toutefois heureux de lire vos commentaires, alors n'hésitez pas à les poster dans notre forum de discussions.
Nous vous rappelons aussi que nous ne supportons pas ce bridge.