These installation steps assume you have already installed Joomla!TM and MagentoTM on your website. Make sure you understand how to use both applications first, before starting with MageBridgeTM.
Procedure
- Buy license from YireoTM Shop
- Install MageBridge Installer in Joomla!
- Upgrade to full version in Joomla!
- Install MageBridge Installer in Magento
- Upgrade to full version in Magento
1. Check the system requirements
Make sure all requirements are met on the hosting level. Check the MageBridge - System Requirements guide for more information.
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 My Software Subscriptions. You need to login and browse to My Account to access this page.
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.
Take note of the license key, because you need this while installing MageBridge.
About the domains you can use MageBridge on
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.
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
Download the Joomla! 1.5 component MageBridge Installer for Joomla! to your desktop:
www.yireo.com/documents/com_magebridge_installer.zip
Login to your Joomla! Administrator and install the MageBridge Installer through Extensions » Install/Uninstall. Upload the com_magebridge.zip file and install it as you would any other Joomla! extension.
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).
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
Login into your Magento Connect Manager (also called the Magento Downloader). You can navigate to the downloader using the Magento backend panel (System » Magento Connect » Magento Connect Manager). Under Install New Extensions enter the following code and click Install
magento-community/Jira_MageBridge
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 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.
5. Done
You're done installing MageBridge. The next step is to configure all settings. Please see the Quick Start Guide for more information.
If you're running into any problems, please checkout the Troubleshooting FAQ and the MageBridge tutorials (for customers only). If you still have questions, don't hesitate to post your question/problem 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.
Tutorials on MageBridge basics
- MageBridge - Quick Start Guide
- MageBridge - Configuration options
- MageBridge - System requirements
- MageBridge - Known issues
- Getting started with MageBridge
- MageBridge - Recommended Magento settings
Tutorials on MageBridge administration
- Performance tuning with MageBridge
- MageBridge SEO Guide
- MageBridge scenarios
- Authentication guide for MageBridge
- MageBridge Troubleshooting Guide
- Using MageBridge modules
- Step-by-step: Activating MageBridge plugins
- Upgrading Magento, Joomla! and MageBridge
- Configuring payment methods in MageBridge
- MageBridge Security Guide
- Step-by-step: Creating a MageBridge Menu-Item
- Step-by-step: Create a Magento API user
- API permissions with MageBridge
- How to use URL-suffices with MageBridge?
- Using MageBridge stores to load a different Magento theme
- Step-by-step: Adding a custom Magento block
- Managing MageBridge extensions
- Using the MageBridge Content Plugin
- Enabling SSL for MageBridge
- Prevent direct access to Magento
- Switching stores with MageBridge
- Using MageBridge Product Connectors
