Magento / WordPress Integration Installation and Configuration
This article explains how to install WordPress Integration via Magento Connect. If you are unable to use Magento Connect, you can always install the extension manually.
Install WordPress
Before installing FishPig's WordPress Integration you will need to install WordPress. For detailed instructions on how to install WordPress, see the WordPress install page. Before installing WordPress, we recommend reading the following points as they will help you to install WordPress in a way that will make integrating it with Magento much easier.
- It is recommended that you install WordPress in a sub-directory of Magento. Do not install it in a sub-directory that you plan to make your blog visible on. For example, if you want your blog to be visible from http://www.yourmagento.com/blog/, you should not install WordPress in the blog sub-directory. We recommend installing WordPress in a sub-directory named wp. If WordPress is already installed in the directory you want your blog to be visible on, click here for instructions on how to move it to a different directory.
- You can install WordPress in the same database as Magento or in a separate database (you can even install it on a database on a different server, as long as the server allows external MySQL connections).
Install the WordPress Integration Extension
Before installing the extension, log in to your Magento Admin and disable the Magento cache. Also, if you are using the Magento compiler, ensure this is disabled.
Go to the WordPress Integration page and click the download button. This will take you to the extension page on Magento Connect, which allows you to get the extension key for WordPress Integration. If you are unsure of how to install an extension using Magento Connect, please see this article.
Once you have the extension installed, log out of your Magento Admin and then log back in. If the extension has installed correctly, you should see a new tab in your Magento Admin navigation called 'WordPress'
Configuring WordPress Integration
Now that the extension is installed, it's time to configure it so that Magento and WordPress can talk to each other. To do this, login to the Magento Admin and select WordPress > Settings > Database / Plugins from the top navigation. The main configuration page for the extension should be displayed and should contain several sections (each section is explained below).
Database
Add the details here for your WordPress database. If Magento and WordPress share a database, you don't have much to do. If you are unsure of any of these details, you can find them in the wp-config.php, which should be in the root of your WordPress installation.
Integration
This section sets the level of integration you want. For a full explanation of the different types of integration available, please see this article.
If you have chosen full-integration (most people do), an extra field will be displayed. This field contains the blog route and is appended to your base Magento URL to create the URL that your blog is visible on. If for example your Magento store was installed at http://www.yourmagento.com/ and you want your WordPress blog to be visible at http://www.yourmagento.com/blog/, you would simply enter 'blog' in this field. Once you have set this field, we need to make a change in the WordPress Admin so that WordPress knows not to display your blog on the install URL, which would cause your blog to be accessible from 2 URL's (duplicate content!). To do this, login to your WordPress Admin and select Settings > General. Once the page has loaded, you should see 2 URL's. Change the URL in the field labelled 'Site Address (URL)' (the second one) to be the full URL that you want your WordPress blog to be visible on. Using the previous example, you would enter http://www.yourmagento.com/blog in this field.
Miscellaneous
This second contains only 1 field and that is the WordPress path. In this field, enter the relative path to your WordPress installation. If WordPress is installed in a sub-directory of Magento, just enter the sub-directory name here. For example, if WordPress is installed in a sub-directory of Magento named wp, enter wp here.
Checking WordPress & Magento are Integrated
Once you have set all of your configuration values, the integration test results at the top should show all green ticks. If this is the case, WordPress & Magento are successfully integrated. If this isn't the case and some errors are displayed, try reading over the instructions again to see whether you missed anything. Alternatively, get in touch and we'll see if we can help.
