When building a MageBridge^TM-based website and webshop, the Magento^TM theme is combined with the Joomla! template. To get the look and feel right, you will need therefor knowledge of both Joomla!^TM as Magento theming.

As a workaround, we have made several add-ons for RocketTheme templates available which integrate Magento smoothly into these templates. The RocketTheme template add-ons are available in our Yireo^TM Shop, and function like a patch of the original RocketTheme template.

Purchase RocketTheme template

You will still need to purchase the original template at the RocketTheme website. Also note that this patch only functions with the Magento "Default" theme.

Installing the MageBridge RocketTheme addon

The add-on can be downloaded after purchase in our Yireo Shop, and consists of a ZIP-file. Within this ZIP-file you will find a README.txt file that guides you through the installation process, but the same process is explained more thoroughly below.

The following steps only require you to modify Joomla!. Nothing needs to be changed within Magento.

• Make a file-backup of your current RocketTheme template.
• Copy all files inside the rt_template folder to the RocketTheme template-directory (for instance templates/rt_nexus_j15) or your custom copy of this template.

Configuring MageBridge with the right theming options

After installation of the RocketTheme patch, it is important to configure the MageBridge extension with the right options. Login to the Joomla! Administrator and browse to the MageBridge Configuration page. Select the Theming-tab and make the modifications below:

• Set the option Disable Magento CSS to Yes.
• Set the option Disable MageBridge CSS to Yes.

Patched files

The template-patch contains the following files or folders:

• rt_head_includes.php = A modified version of the original RocketTheme.
• css = Several CSS-files created by Yireo
• images = Images originating from Magento

These files modify the RocketTheme template so that the MageBridge shop integrates nicely with it. Note that these files only work in combination with the default Magento theme.

JavaScript issues

Yireo has tested that the MageBridge webshop functions together with the basic JavaScript offered by RocketTheme templates. Some functions of the RocketTheme template might not work correctly with MageBridge. Please follow the guidelines below:

• Set the option Disable Joomla! MooTools within the MageBridge Configuration to Yes
• Set the option Disable all Joomla! scripts within the MageBridge Configuration to Yes

RocketTheme settings

Within the RocketTheme template, you can often choose which Menu Type to use. When using MageBridge, MooTools needs to be disabled, which disables animation effects for the RocketTheme template. Your menus (either Fusion Menu or a Split Menu will still function.

Newer Gantry-based templates include a setting Advanced > Smartload which should exclude MageBridge. Under Component Ignores add .com_magebridge

Adding more PHP-code to the template

When you want to add a specific Joomla! module or Magento block to specific pages within the webshop, you will notice that Joomla! is not advanced enough to do this. You can only assign modules to specific Joomla! pages, but not "subpages" within the Magento system. To accomplish this, you will need to modify the PHP-code in your template.

To make things a little easier, MageBridge ships with a specific template-helper and within the "rt_head_includes.php" file this helper-class is instantiated to the object $mb. This $mb variable can be used to exclude for instance the module position "user1" from all MageBridge checkout pages:

<?php if ($this->countModules('user1') && !$mb->isCheckoutPage()) : ?>

Or if you want to enable a new Joomla! module-position only on the MageBridge wishlist pages:

<?php if($this->countModules('wishlist') && $mb->isPage('wishlist/*')) : ?>

Unfortunately, for the correct usage of this helper, you will need more knowledge of PHP. More information about the MageBridge template-helper can be found in the MageBridge template helper guide.