The top of this thread now covers the new bridge for SMF 1.1.x This bridge is v1.1.7.
If you are using SMF RC1 or prior (including 1.0.x) please see the specific message further down in this thread!)THIS message specifically pertains to SMF 1.1.x in combination with Mambo up to version 4.5.4. If you are using Joomla, please see the PREVIOUS message in this thread. If you are using Mambo 4.6.x, we are currently TESTING a new version of the bridge. 1.1.7 will NOT work with Mambo 4.6.xThe system mambot that automatically inserts the code does not work with Mambo!
It should be noted, before you start with this bridge...
Everything in these instructions assumes that you already have Mambo (4.5.2.3 or higher) and SMF (1.1.x) installed and working as stand-alone utilities.
For simplicity, if you don't know exactly what you are doing:
- SMF should be installed in a "sub level" directory. (i.e.
www.yoursite.com/forum or something like that)
- Mambo can be installed in a "sub level" directory or at the top level itself.
The bridge is available
HERESTART:
First, unzip the Bridge ZIP file
This will extract to create threefiles.
com_smf.zip
readme.html
leggimi.html (the readme in Italian)
For new installs:Unzip the package, read the readme.html, and install the com_smf.zip as a component.
For Joomla, you will not need to add code to your template, but for Mambo, you will.
For upgrades from 1.1.2 or 1.1.3:Uninstall the bridge component, the bridge registration component, and the mod_smf_login module. Remove the code from your Mambo template.
For upgrades from 1.1.4 or 1.1.5:Uninstall the bridge component, the bridge registration component, the mod_smf_login module and the smf_header_include mambot. Remove the code from your Mambo template.
Read the readme.html. Install the com_smf.zip as a component. Please note that for Mambo, the code in the template has changed significantly.
INSTALLATION INSTRUCTIONS:Now that you have all the files unzipped and ready to load, you can log in to your
server and start installation.
This README has a detailed instructions, but the new one-step design makes things
fairly easy and straight-forward. Make sure you read the README.HTML file first!
1 ) Install the Simple Machines Forum component.
1a) Using Mambo Admin > Install/Uninstall Component
1b) Choose Upload File Package and Browse to the into which you extracted
the bridge and choose the file called "com_smf.zip"
1c) This now automatically installs the com_smf_registration component and
the mod_smf_login module as well as adding a Forum menu item to the main menu.
2 ) Modify the index.php of your Mambo Template.
2a) Go to directory MAMBO/templates/NAME
(where MAMBO is your mambo directory and NAME is the name of the template.)
2b) Open index.php
2c) Add the following code just before the </HEAD> tag in index.php
<?php
global $sc, $context, $settings;
if (!defined('SMF')){
// Get the configuration. This will tell Mambo where SMF is, and some integration settings
$database->setQuery("
SELECT `variable`, `value1`
FROM #__smf_config
");
$variables = $database->loadAssocList();
foreach ($variables as $variable){
$variable_name = $variable['variable'];
$$variable_name = $variable['value1'];
}
require ($smf_path."/SSI.php");
}
$sc = &$context['session_id'];
$_SESSION['USER_AGENT'] = $_SERVER['HTTP_USER_AGENT'];
mysql_select_db($mosConfig_db);
echo '
<script language="JavaScript" type="text/javascript" src="', $settings['default_theme_url'], '/script.js?beta4"></script>
<script language="JavaScript" type="text/javascript"><!-- // --><![CDATA[
var smf_theme_url = "', $settings['theme_url'], '";
var smf_images_url = "', $settings['images_url'], '";
var smf_scripturl = "', $scripturl, '";
var smf_session_id = "', $context['session_id'], '";
// ]]></script>';
echo '
<link rel="stylesheet" type="text/css" href="', $settings['theme_url'], '/style.css?rc1" />
<link rel="stylesheet" type="text/css" href="', $settings['default_theme_url'], '/print.css?beta4" media="print" />
<link rel="help" href="', $scripturl, '?action=help" target="_blank" />
<link rel="search" href="' . $scripturl . '?action=search" />
<link rel="contents" href="', $scripturl, '" />';
?>
AND add the following just above the </body> tag at the bottom of the index.php file:
<?php mysql_select_db($GLOBALS['db_name']); ?>
3 ) Configure the SMF component in Mambo Admin.
3a) Using the Mambo Admin, choose Components > Simple Machines Forum > Configuration
CONFIGURATION TAB
3b) Set the Path to SMF. This is NOT a URL! This is the absolute path to your SMF
Installation.
(Usually this will be something similar to /home/username/public_html/forum)
3c) Choose if you want your Forum wrapped or unwrapped.
It should be noted that there are essentially three formats to display your Joomla
to Forum integration:
Wrapped: You are using SMF through the Mambo bridge. The Forum appears
"wrapped" in the Joomla template.
Unwrapped: You are still using SMF through Mambo, but it doesn't have the
look of a wrapped forum. It looks stand-alone, but it is actually
loading through Mambo.
This is set in the Mambo config for the component.
REGISTRATION TAB
3d) Choose what registration method you want to use:
- The bridge registration looks like mambo's registration method...
- The mambo registration uses Mambo's registration routine...
- The SMF registration uses SMF's registration routine...
- The Community Builder registration uses the CB registration component...
- The MamboCharge registration uses the MamboChargeregistration component...
but all options will still result in the users being added to both databases (eventually).
3e) Require Registration Agreement? Display the agreement.txt from SMF's directory and
require "I agree" to be checked?
3f) Ask for ICQ, AIM, YIM, MSN? At registration time, as for the IM info?
3g) Send a SMF PM to the user on registration?
3h) Use real name or username as display? For SMF, is the joomla NAME (aka realname)
used as their display name or is the Mambo USERNAME (login name) used for both
the username AND display name fields?
3i) Also register into Community Builder?
(You must have Community Builder already installed, and be using Bridge Registration)
GROUPS TAB
3j) Associate the SMF groups with the Mambo Groups here. This is ONE WAY, SMF to Mambo!
It will not make a Mambo admin into an SMF admin!
SYNC TAB
3k) This should be self-explanatory.
4 ) The Simple Machines Forum Registration component just opens the same configuration
screen, to the REGISTRATION TAB
Other Configuration notes
4a) You will probably want to start SMF off with default settings...
4b) If you make the Mambo menu item (for the SMF - Bridge component) available to registered
users only, the login and registration may not function correctly.
4c) Activation emails should be handled by Mambo (for Bridge Regsitration) or in SMF (for SMF registration)
5 ) Configure the Login Form (mod_smf_login)
5a) Choose what options you want displayed in your Login box...
5b) Even if you do not change any options, click SAVE!
It is a known issue in Mambo that modules must be "saved" at least once in order to
be fully activated.
6 ) In Mambo Admin > Menu > User Menu
6a) Remove the link for the User Profile.
(You will probably not want Mambo/Joomla to handle the user
information any more, unless you are using CB.)
6b) Remove the link for the Joomla Logout.
7 ) In Mambo Admin > Menu > Main Menu
7a) You may have to delete and re-enter the Menu item for the SMF- Bridge Component.
(if it points to "Component - "). (Don't forget to empty the trash)
If so, then add a new item, pointing to the SMF - Bridge component.
