Magento WordPress Integration Installation

Before installing anything, please make sure that the Magento cache is fully disabled and that if you use the Magento compiler, this is disabled too.

Install WordPress

The first step is to download WordPress and upload the files to a folder named 'wp' in your Magento root directory. Do not use a folder name that matches where you want to see your integrated blog. For example, if you want your integrated blog to be available from /blog, do not use /blog as the installation folder name.

To complete the WordPress installation, go to your Magento URL + /wp in a browser and follow the steps. You can use the Magento database for WordPress or a completely separate database.

Install the Extension

Download the extension ZIP file from here and extract the files. Upload the files to your Magento site and merge them with the existing files. If you are logged in to the Magento Admin, you will need to log out and log back in to complete the installation.

Configuring the Integration

Log in to the Magento Admin and select System > Configuration > WordPress from the navigation and fill out the Database section, ensuring that you use the database that you used while installing WordPress. If you are unsure of your WordPress database details, you can find them in the wp-config.php file, which is in the WordPress root directory.

Enter the path to your WordPress installation under Integration > Path. If you installed WordPress in a sub-directory of Magento called 'wp' you can simply enter wp in this field. This field can be either an absolute or relative path.

Enter the Home URL of the blog. This is the part after your Magento URL that your blog will be available on. The most common value here is 'blog' but this can be 'news', 'articles' or anything else. This will be added to your Magento base URL and will be the URL that your blog is visible on. You cannot enter the name of the WordPress installation folder here.

Configuring WordPress

Login to the WordPress Admin and select Settings > General. The first URL should be the WordPress installation URL (eg. the /wp URL) and the second URL should be your Magento base URL + the Home URL you specified (eg. https://www.yourmagento.com/blog).

Select Settings > Permalinks and specify a custom permalink structure.

Select Appearances > Themes and enable the FishPig theme.

Install WordPress

The first step is to download WordPress and upload the files to a folder named 'wp' in your Magento root directory. This directory may be the root directory or it may be the pub directory. Do not use a folder name that matches where you want to see your integrated blog. For example, if you want your integrated blog to be available from /blog, do not use /blog as the installation folder name.

To complete the WordPress installation, go to your Magento URL + /wp in a browser and follow the steps. You can use the Magento database for WordPress or a completely separate database.

Install the Extension

Download the extension ZIP file from here and extract the files. Create a folder at app/code/FishPig/WordPress and upload the files to it. Ensure that you use the correct spelling and capitalisation of this folder name.

Enable the extension by running the following commands in the shell: php bin/magento module:enable FishPig_WordPress
php bin/magento setup:upgrade

Configuring the Integration

Log in to the Magento Admin and select WordPress from the menu. To configure the extension, simply enter the path in the config option. This should be the path to your WordPress installation. If you installed WordPress in a sub-directory named 'wp' you can simply enter wp in this field. This can contain an absolute or relative path to the WordPress installation.

The extension will figure everything else out from here, including your WordPress URLs and database details.

Configuring WordPress

Login to the WordPress Admin and select Settings > General. The first URL should be the WordPress installation URL (eg. the /wp URL) and the second URL should be your integrated URL, which is the URL that you want your blog frontend to be visible on (eg. https://www.yourmagento.com/blog).

Select Settings > Permalinks and specify a custom permalink structure.

Select Appearances > Themes and enable the FishPig theme.