Setting the MageBridge URLs in Magento - Yireo

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. Buy your license from Yireo Shop
2. Install MageBridge Installer in Joomla!
3. Upgrade to full version in Joomla!
4. Install MageBridge Installer in Magento
5. Upgrade to full version in Magento

1. Check the system requirements

Make sure all requirements are met on the hosting level. Check the following guide for more information:

• MageBridge - System Requirements

Also check the required settings for Magento and Joomla!:

• Magento settings for MageBridge
• Joomla! settings for MageBridge

2. Purchase MageBridge and configure your licensing

The first step is to purchase the MageBridge suite at our Yireo Shop. After you have finished the checkout procedure, you can access the details of MageBridge through a page called Software Subscriptions. If you are installing the trial-version, you can skip this check entirely.

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

2.1 - Modifying your licensed domains

The page lists all your MageBridge licenses. For a license to become useful, you need to enter the hostnames of the sites for which you're going to use MageBridge. Select the license 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 license key

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

About the domains you can use MageBridge on

In case of the MageBridge Enterprise version, you can use one MageBridge license 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 version 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.

About the MageBridge Installers

You will be able to install a stripped-down MageBridge extension (the MageBridge Installer) on your site, but this stripped-down is useless and only serves as installer for the complete MageBridge suite. To install the full-blown MageBridge suite, you need a valid license, which needs to be purchased. The MageBridge Installer is publicly available.

3. MageBridge Installer for Joomla!

In short:

• Install the MageBridge Installer for Joomla!
• Configure the license-key in Joomla!
• Upgrade to the full MageBridge-version

3.1 - Install the MageBridge Installer for Joomla!

Download the Joomla! component MageBridge Installer for Joomla! to your desktop. There are two versions available: One for Joomla! 1.5, one for Joomla! 1.6.

Login to your Joomla! Administrator and install the MageBridge Installer through Extensions » Install/Uninstall. Upload the com_magebridge_installer.zip file and install it as you would any other Joomla! extension.

3.2 - Upgrade to the full MageBridge version

Browse within the Joomla! Administrator to Components » MageBridge. There's only one page. Make sure your hosting environment meets the minimum requirements of MageBridge. The installer will not let you continue unless all requirements are met.

Copy the license key from your Yireo Account, paste it in the License box and hit the Apply button. Next hit the Install button. This will upgrade the MageBridge Installer to the full MageBridge version. If this fails, make sure you have entered the right license key and have configured the proper domainnames (see above).

If you are installing the trial-version, use the license key TRIAL instead (one word, capital letters). If you choose to install the trial-version, make sure you have the ionCube-decoders installed on your webserver.

Post-installation checks for Joomla!

After you have installed the full MageBridge version, 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 Installer for Magento

In short:

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

4.1 - Installing the MageBridge Installer in Magento

4.1 - A) Installing the MageBridge installer in Magento 1.5 or newer

If you use Magento 1.5 or newer, you can download the MageBridge Installer package from within the download-section of our site. Download the file called magebridge_magento_installer_mc2.tgz and upload it within your Magento Connect Manager.

Refresh the Magento cache afterwards.

4.1 - B) Installing the MageBridge installer without the Magento Connect Manager

If you don't use a Magento Connect Manager or Magento Downloader - or if the steps laid down above fail -, you can just install the MageBridge full-version right away by downloading the patch-file from our download-section. You need to login to access those files. Extract the patch-file and copy all of the resulting files to your Magento root-folder (through FTP or SSH). Refresh the Magento cache afterwards.

4.2 - Upgrading the MageBridge installer to the full-version

Navigate within the Magento backend to CMS » MageBridge Installer » License. There's only one page. Copy the license key from your Yireo Account and paste it in the License box. Click on the button Save. The license-key is now stored in Magento, but we still need to upgrade MageBridge to the full version.

Click on on the tab Installation on the left. (If it is called Updates, you have already upgraded the installer to the full version.) A version-check will be performed, and an Update button is visible on the page. Hit the button Update. This will upgrade the MageBridge Installer to the full MageBridge version. If this fails, make sure you have entered the right license 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.