MageBridge Installation Guide

These installation steps assume you have already installed Joomla! and Magento on your website. Make sure you understand how to use both applications first, before starting with MageBridge. Also check out MageBridge Magento Settings guide and MageBridge Joomla! Settings guide for further changes you need to make.

Procedure

  1. Purchase a support subscription from Yireo Shop
  2. Install MageBridge component in Joomla!
  3. Upgrade to full version in Joomla!
  4. Install MageBridge Installer in Magento
  5. Upgrade to full version in Magento
Magento and MageBridge are complicated products. We therefor recommend you follow the steps in this guide precisely, especially if this is the first time with MageBridge.

1. Check the system requirements

Make sure all requirements are met on the hosting level:

Also check the required settings for Magento and Joomla!:

2. Purchase and configure your support subscription

The first step is to purchase a MageBridge Support Subscription at our Yireo Shop. After you have finished the checkout procedure, you can access the details of your subscription through a page called Subscriptions.

You need to login and browse to your Yireo Account to access this page.

yireo-menu-account

2.1 - Modifying your configured domains

The page lists all your MageBridge support settings, including a support key that gives you updates on specific domains. For a support key to become active, you need to enter the hostnames of the sites for which you're going to use MageBridge. Select the support key you want to configure. Enter the hostname of your Magento application, and the hostname(s) of your Joomla! website(s). Use the exact same hostname that is used when accessing the backend.

If your Joomla! and/or Magento site is accessed under the URL http://www.example.com/ enter as hostname:

www.example.com

2.2 - Copy the support key

Take note of the support key listed on the same page, because you need this while installing MageBridge.

mb-license-page

2.3 - About the domains you can use MageBridge on

In case of a MageBridge Enterprise Support Subscription, you can use one MageBridge support key for 6 domains. We recommend using these 6 domains for 3 sets of Joomla! and Magento (production, testing and development) but you are free to choose a different scheme. With the MageBridge Standard Support Subscription you can only use 2 domains.

When entering the domainnames, do not use a URL-prefix - so do not use http:// or https://. Only use the plain hostname.

If your Joomla! and/or Magento site is accessed under the URL http://www.example.com/ enter as hostname:

www.example.com

2.4 - Installing the MageBridge extensions

The bridge of MageBridge is setup through two extensions: A MageBridge component in Joomla! and a MageBridge module in Magento. The Joomla! component is used to install numerous other Joomla! extensions, which are based upon the core bridge of MageBridge. The following chapter tells you how to install all of these extensions on your site.

3. MageBridge installation in Joomla!

In short:

  • Install the MageBridge component for Joomla!
  • Configure the support key in Joomla!
  • Install all other MageBridge extensions using the MageBridge Update Manager.

3.1 - Install the MageBridge component for Joomla!

Download the MageBridge component for Joomla! to your desktop. The file is com_magebridge_j25.zip. It is compatible with both Joomla! 2.5 as Joomla! 3. Do not unzip this file. Login to your Joomla! Administrator and install the MageBridge component through Extensions » Extension Manager » Install. Upload the com_magebridge_j25.zip file and install it as you would any other Joomla! extension.

3.2 - Installing all other MageBridge extensions

Browse within the Joomla! Administrator to Components » MageBridge. Next, go to the Configuration. Open up the Support tab. You will see an empty Support Key box.

Copy the support-key from your Yireo Account, paste it in the Support Key box and hit the Save & Close button. You have now configured your MageBridge environment to receive extensions and updates from our Yireo servers.

Next go to Components > MageBridge > Update. You are now entering the MageBridge Update Manager. You should see a listing of extensions. All core extensions of MageBridge are automatically selected. Hit the Update button. This will automatically install all packages that are needed for MageBridge to function properly. Optionally you can install additional packages from here, but we recommend you finish this installation guide first.

If the installation fails at this point, make sure you have entered the right license key and have configured the proper domainnames (see above) within your Yireo Account.

3.3 - Post-installation checks for Joomla!

After you have installed all MageBridge extensions, browse to System Check to make sure all settings are correct. Before jumping to the MageBridge Quick Start Guide, also make sure you have installed everything correctly on the Magento-side.

4. MageBridge installation in Magento

In short:

  • Install the MageBridge Installer for Magento
  • Configure the support-key in Magento
  • Upgrade to the full MageBridge-version

4.1 - Installing the MageBridge extension

You can install the MageBridge extension using the patch file from our download-section. You need to login to your Yireo Account to access those files. Extract the patch file locally on your own computer and copy all of the resulting files to your Magento root-folder (through FTP or SSH). Refresh the Magento cache afterwards and make sure to logout (and back in) from the Magento Admin Panel.

4.2 - Upgrading the MageBridge extension to the latest version

mb_magento_installer1Navigate within the Magento backend to CMS » MageBridge » Support Key. Copy the support-key from your Yireo Account and paste it in the Support Key box. Click on the button Save. The support key is now stored in Magento, which allows you to access updates from the Yireo Server.

Click on on the tab Updates on the left. A version-check will be performed, and an Update button is visible on the page. Hit the button Update. This will upgrade the MageBridge extension to the latest version. If this fails, make sure you have entered the right support-key and have configured the proper domainnames (see above).

Post-installation checks for Magento

After you have upgraded to the full MageBridge version in Magento, make sure it is correctly installed. By accessing the URL http://MAGENTO/magebridge.php you should see some strange data-structure (JSON-output).

If you get an 500 Internal Server Error, most probably the file permissions on the newly installed are incorrect. All MageBridge files should have the same permissions as the files of Magento (for instance index.php).

5. Troubleshooting

If you run into problems, make sure you have configured Magento and Joomla! properly. See the Magento settings guide and the Joomla! settings guide for more information.

If your problem persists, check the MageBridge troubleshooting tutorials.

6. Done

You're done installing MageBridge. The next step is to configure all settings. Please see the MageBridge Quick Start Guide for more information. Check out our other MageBridge tutorials as well for more tips and tricks when configuring things. If you still have questions, don't hesitate to post on our forum.

Are we done?

Note that however MageBridge itself is easy to use, you will need to customize theming yourself. MageBridge brings the Magento theme to Joomla!, but doesn't guarantee anything about what happens next. It could be that HTML- or CSS-code is causing strange-looking layouts, it could even be that JavaScript-errors are thrown on every MageBridge-page. With our tutorials and assistence on the forum, you can certainly make this to a success. Knowledge of HTML and CSS is required.