Difference between revisions of "X-Cart:Moving store to web-root directory"

From X-Cart 4 Classic
Jump to: navigation, search
(Created page with 'Here are general instructions on how to move your cart to the web-root directory: 1. Make sure your product and category images are stored in the database. If they are stored on…')
 
m
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
Here are general instructions on how to move your cart to the web-root directory:
+
Here are the general instructions on how to move your cart to the web-root directory:
  
−
1. Make sure your product and category images are stored in the database. If they are stored on the filesystem, you should temporarily move them to the database. You can do this under the "Images location" section of the admin interface.
+
{{XC 4.0|or earlier}}
  
−
2. Move all files from the directory where X-Cart installed to the root web directory. You can do this using either FTP or (better) SSH access. File permissions must be preserved during the copying, otherwise you will need to adjust the permissions manually.
+
1. If you are using X-Cart 4.0.19 or earlier, make sure your product and category images are stored in the database. If they are stored on the filesystem, you should temporarily move them to the database. You can do that under the "Images location" section of the admin interface.
  
−
3. Edit <u>config.php</u> file adjusting '''$xcart_web_dir''' parameter. If your cart was installed in the "store" directory, you should replace the following string:
+
2. Move all the files from the directory where X-Cart is installed to the root web directory. You can do this using either FTP or (better) SSH access. File permissions must be preserved during the copying, otherwise you will need to adjust the permissions manually.
  
−
<source>
+
3. Edit the file <u>config.php</u> adjusting the '''$xcart_web_dir''' parameter. If your cart was installed in the "store" directory, you should replace the following string:
 +
 
 +
<pre>
 
$xcart_web_dir ="/store";
 
$xcart_web_dir ="/store";
−
</source>
+
</pre>
  
 
with this:
 
with this:
  
−
<source>
+
<pre>
 
$xcart_web_dir ="";
 
$xcart_web_dir ="";
−
</source>
+
</pre>
 +
 
 +
{{XC 4.2}}
 +
 
 +
4. If you are using X-Cart version 4.2-4.4 and you have enabled clean urls in your .htaccess file, find the following lines in the file:
 +
 
 +
<pre>
 +
# Clean URLs [[[
 +
Options +FollowSymLinks -MultiViews -Indexes
 +
<IfModule mod_rewrite.c>
 +
RewriteEngine On
 +
RewriteBase /xcart/
 +
RewriteCond %{REQUEST_URI} !^/xcart/(payment|admin|provider|partner)/
 +
RewriteCond %{REQUEST_FILENAME} !\.(gif|jpe?g|png|js|css|swf|php|ico)$
 +
RewriteCond %{REQUEST_FILENAME} !-f
 +
RewriteCond %{REQUEST_FILENAME} !-d
 +
RewriteCond %{REQUEST_FILENAME} !-l
 +
RewriteRule ^(.*)$ dispatcher.php [L]
 +
</IfModule>
 +
# /Clean URLs ]]]
 +
</pre>
 +
 
 +
and replace them with the following:
 +
 
 +
<pre>
 +
# Clean URLs [[[
 +
Options +FollowSymLinks -MultiViews -Indexes
 +
<IfModule mod_rewrite.c>
 +
RewriteEngine On
 +
RewriteBase /
 +
RewriteCond %{REQUEST_URI} !^/(payment|admin|provider|partner)/
 +
RewriteCond %{REQUEST_URI} !^/server-status
 +
RewriteCond %{REQUEST_FILENAME} !\.(gif|jpe?g|png|js|css|swf|php|ico)$
 +
RewriteCond %{REQUEST_FILENAME} !-f
 +
RewriteCond %{REQUEST_FILENAME} !-d
 +
RewriteCond %{REQUEST_FILENAME} !-l
 +
RewriteRule ^(.*)$ dispatcher.php [L]
 +
</IfModule>
 +
# /Clean URLs ]]]
 +
</pre>
 +
 
 +
{{XC 4.4}}
 +
 
 +
5. If you are using X-Cart 4.4.x and have enabled CSS and JavaScript optimization tools in your .htaccess file, find the following lines in the file:
 +
 
 +
<pre>
 +
# Speed-Up JS and CSS [[[
 +
Options +FollowSymLinks -MultiViews -Indexes
 +
<IfModule mod_rewrite.c>
 +
RewriteEngine On
 +
RewriteBase /xcart/
 +
RewriteRule loader_(.+).css loader.php?type=css&md5_suffix=$1 [L]
 +
RewriteRule loader_(.+).js loader.php?type=js&md5_suffix=$1 [L]
 +
</IfModule>
 +
# /Speed-Up JS and CSS ]]]
 +
</pre>
 +
 
 +
and replace them with the following:
 +
 
 +
<pre>
 +
# Speed-Up JS and CSS [[[
 +
Options +FollowSymLinks -MultiViews -Indexes
 +
<IfModule mod_rewrite.c>
 +
RewriteEngine On
 +
RewriteBase /
 +
RewriteRule loader_(.+).css loader.php?type=css&md5_suffix=$1 [L]
 +
RewriteRule loader_(.+).js loader.php?type=js&md5_suffix=$1 [L]
 +
</IfModule>
 +
# /Speed-Up JS and CSS ]]]
 +
</pre>
 +
 
 +
6. If you have enabled clean urls in your .htaccess file
 +
 
 +
<pre>
 +
# Clean URLs [[[
 +
Options +FollowSymLinks -MultiViews -Indexes
 +
<IfModule mod_rewrite.c>
 +
RewriteEngine On
 +
RewriteBase /store/
 +
RewriteCond %{REQUEST_URI} !^/xcart/(payment|admin|provider|partner)/
 +
RewriteCond %{REQUEST_FILENAME} !\.(gif|jpe?g|png|js|css|swf|php|ico)$
 +
RewriteCond %{REQUEST_FILENAME} !-f
 +
RewriteCond %{REQUEST_FILENAME} !-d
 +
RewriteCond %{REQUEST_FILENAME} !-l
 +
RewriteRule ^(.*)$ dispatcher.php [L]
 +
</IfModule>
 +
# /Clean URLs ]]]
 +
</pre>
 +
 
 +
you have to go in and change those as well
 +
 
 +
<pre>
 +
# Clean URLs [[[
 +
Options +FollowSymLinks -MultiViews -Indexes
 +
<IfModule mod_rewrite.c>
 +
RewriteEngine On
 +
RewriteBase /
 +
RewriteCond %{REQUEST_URI} !^/(payment|admin|provider|partner)/
 +
RewriteCond %{REQUEST_URI} !^/server-status
 +
RewriteCond %{REQUEST_FILENAME} !\.(gif|jpe?g|png|js|css|swf|php|ico)$
 +
RewriteCond %{REQUEST_FILENAME} !-f
 +
RewriteCond %{REQUEST_FILENAME} !-d
 +
RewriteCond %{REQUEST_FILENAME} !-l
 +
RewriteRule ^(.*)$ dispatcher.php [L]
 +
</IfModule>
 +
# /Clean URLs ]]]
 +
</pre>
  
−
4. Check if X-Cart is working fine on the new location.
+
5. Check whether X-Cart is working fine in its new location.
  
−
5. Move products and category images back to the filesystem if necessary.
+
6. If necessary, move the images from the database back to the filesystem.
  
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]

Latest revision as of 03:23, 31 July 2019

Here are the general instructions on how to move your cart to the web-root directory:

X-Cart 4.0or earlier

1. If you are using X-Cart 4.0.19 or earlier, make sure your product and category images are stored in the database. If they are stored on the filesystem, you should temporarily move them to the database. You can do that under the "Images location" section of the admin interface.

2. Move all the files from the directory where X-Cart is installed to the root web directory. You can do this using either FTP or (better) SSH access. File permissions must be preserved during the copying, otherwise you will need to adjust the permissions manually.

3. Edit the file config.php adjusting the $xcart_web_dir parameter. If your cart was installed in the "store" directory, you should replace the following string: 

$xcart_web_dir ="/store";

with this: 

$xcart_web_dir ="";
X-Cart 4.2or above

4. If you are using X-Cart version 4.2-4.4 and you have enabled clean urls in your .htaccess file, find the following lines in the file: 

# Clean URLs [[[
Options +FollowSymLinks -MultiViews -Indexes
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /xcart/
RewriteCond %{REQUEST_URI} !^/xcart/(payment|admin|provider|partner)/
RewriteCond %{REQUEST_FILENAME} !\.(gif|jpe?g|png|js|css|swf|php|ico)$
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^(.*)$ dispatcher.php [L]
</IfModule>
# /Clean URLs ]]]

and replace them with the following: 

# Clean URLs [[[
Options +FollowSymLinks -MultiViews -Indexes
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_URI} !^/(payment|admin|provider|partner)/
RewriteCond %{REQUEST_URI} !^/server-status
RewriteCond %{REQUEST_FILENAME} !\.(gif|jpe?g|png|js|css|swf|php|ico)$
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^(.*)$ dispatcher.php [L]
</IfModule>
# /Clean URLs ]]]
X-Cart 4.4or above

5. If you are using X-Cart 4.4.x and have enabled CSS and JavaScript optimization tools in your .htaccess file, find the following lines in the file: 

# Speed-Up JS and CSS [[[
Options +FollowSymLinks -MultiViews -Indexes
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /xcart/
RewriteRule loader_(.+).css loader.php?type=css&md5_suffix=$1 [L]
RewriteRule loader_(.+).js loader.php?type=js&md5_suffix=$1 [L]
</IfModule>
# /Speed-Up JS and CSS ]]]

and replace them with the following: 

# Speed-Up JS and CSS [[[
Options +FollowSymLinks -MultiViews -Indexes
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule loader_(.+).css loader.php?type=css&md5_suffix=$1 [L]
RewriteRule loader_(.+).js loader.php?type=js&md5_suffix=$1 [L]
</IfModule>
# /Speed-Up JS and CSS ]]]

6. If you have enabled clean urls in your .htaccess file 

# Clean URLs [[[
Options +FollowSymLinks -MultiViews -Indexes
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /store/
RewriteCond %{REQUEST_URI} !^/xcart/(payment|admin|provider|partner)/
RewriteCond %{REQUEST_FILENAME} !\.(gif|jpe?g|png|js|css|swf|php|ico)$
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^(.*)$ dispatcher.php [L]
</IfModule>
# /Clean URLs ]]]

you have to go in and change those as well 

# Clean URLs [[[
Options +FollowSymLinks -MultiViews -Indexes
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_URI} !^/(payment|admin|provider|partner)/
RewriteCond %{REQUEST_URI} !^/server-status
RewriteCond %{REQUEST_FILENAME} !\.(gif|jpe?g|png|js|css|swf|php|ico)$
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^(.*)$ dispatcher.php [L]
</IfModule>
# /Clean URLs ]]]

5. Check whether X-Cart is working fine in its new location.

6. If necessary, move the images from the database back to the filesystem.

Retrieved from "https://help.x-cart.com/index.php?title=X-Cart:Moving_store_to_web-root_directory&oldid=15356"