X-Cart:Blog system in X-Cart 4

From X-Cart 4 Classic
Revision as of 13:03, 24 February 2014 by Dohtur (talk | contribs) (How to install WordPress in X-Cart)
Jump to: navigation, search

Overview

WordPress in X-Cart is a product that extends your X-Cart store with a fully functional blog using the most popular blogging software in the world. Currently it is available in two forms:

  • for X-Cart versions 4.5.0 and later - as an installable module;
  • for X-Cart version 4.6.1 - as a bundle package.

The installable module allows you to add WordPress features to your existing X-Cart store; the bundle package allows you to install a new X-Cart store from scratch, and this new store will have WordPress in it from the very start.

How to install WordPress in X-Cart

To install the WordPress in X-Cart bundle package:

  1. Download the distribution package from the File Area section of your X-Cart Account. The file you need is named like x-cart-wordpress-x.y.zedition.tgz, where x, y and z are X-Cart version numbers and the edition portion of the filename is gold for the GOLD edition or goldplus for the GOLD PLUS edition. For example, if you need X-Cart v4.6.1 GOLD edition with WordPress, choose the file x-cart-wordpress-4.6.1gold.tgz.

  2. Unpack and install it as described in the manual at Installing X-Cart Using the Installation Wizard. When the X-Cart installation is complete, you will see this page:
    Wp xc 01.png
    Click the Next button to proceed to WordPress installation.

  3. Select the directory where you want to install WordPress. Enter the directory name or leave the default value "blog".
    Wp xc 02.png
    Click the Next button.

    The installation script creates the directory and downloads WordPress package.
    Wp xc 03.png
    Note: This process may take 1-2 minutes.

    Note: If the directory cannot be created automatically, the following error message will be displayed:
    Wp xc error 01.png
    In this case you can create it manually and reload the page in your browser to continue.

  4. After the package has been downloaded, the confirmation message is displayed:
    Wp xc 04.png
    Click the Next button to continue.

    The installation script unpacks the WordPress files. After the process is completed, the link to the WordPress installation script will be displayed:
    Wp xc 05.png
    Click on the link that looks like this: httр://<domain>/<directory>/wp-admin/setup-config.php.

  5. The WordPress page will be opened in a new tab:
    Wp xc 06.png
    On this page you should specify the MySQL details of your WordPress database.
    Note: For increased security, it is recommended to create a separate MySQL user and MySQL database for your WordPress.

    Note: Do not use the same MySQL user for the two separate databases of your X-Cart and WordPress, because it will cause the database error "table doesn't exist". To resolve this issue, you can append a port number or socket to the MySQL host in the WordPress so that the host name differs from the one in your X-Cart by at least one character.

    Click the Submit button to continue.

  6. WordPress creates the wp-config.php file and writes the MySQL details into it. The confirmation message will be displayed as shown below:
    Wp xc 07.png
    Click Run the install to continue.

    If the wp-config.php file cannot be created automatically, you should create it manually in the directory of your WordPress and paste the content from the textarea into it:
    Wp xc 08.png

  7. On the next page you should enter the title of your blog, the e-mail and password of your WordPress admin user:
    Wp xc 09.png
    Click the Install WordPress button.

  8. On the Success page click the Log In button to login to the WordPress admin area with the username and password entered on the previous page:
    Wp xc 10.png

  9. In the WordPress admin area, open the Appearance > Themes section, find the Twenty Eleven for X-Cart theme and click on the Activate link under it:
    Wp xc 11.png

  10. Open the Plugins section, find the Integration with X-Cart plugin and click on the Activate link under it:
    Wp xc 12.png

  11. In the X-Cart admin area, open the Tools > Maintenance page, find the Clear templates/X-Cart cache section and click the Clear button.

  12. If the .htaccess file cannot be updated automatically, the following warning message will be displayed by the installation script:
    Wp xc error 02.png
    You should copy the lines from this message, edit the .htaccess file in your X-Cart directory and insert the lines before the Clean URLs section:
# WordPress in X-Cart [[[
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^blog/index.php blog.php [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^blog/(.*) blog.php [L]
</IfModule>
# /WordPress in X-Cart ]]]


Visit your blog page to make sure it is displayed correctly. For example, if the "Ideal Comfort" skin is used in your X-Cart, the blog should look like this:

Wp xc 13.png