X-Cart:ShippingEasy module installation - Revision history

Dohtur at 13:03, 21 January 2016

2016-01-21T13:03:23Z

Dohtur at 22:36, 30 October 2014

2014-10-30T22:36:07Z

Dohtur at 20:30, 30 October 2014

2014-10-30T20:30:37Z

Dohtur at 20:14, 30 October 2014

2014-10-30T20:14:18Z

Dohtur at 20:12, 30 October 2014

2014-10-30T20:12:57Z

Dohtur at 10:32, 30 October 2014

2014-10-30T10:32:45Z

Dohtur: Created page with '==System requirements and installation== To be able to successfully install and use the ShippingEasy module, you need a working copy of X-Cart version 4.4.x installed on your ser…'

2014-10-29T21:05:28Z

Created page with '==System requirements and installation== To be able to successfully install and use the ShippingEasy module, you need a working copy of X-Cart version 4.4.x installed on your ser…'

New page

==System requirements and installation==
To be able to successfully install and use the ShippingEasy module, you need a working copy of X-Cart version 4.4.x installed on your server.

{{Note1|Note: If you do not remember the version of X-Cart on which your store is based, you can look it up in the Environment info section of the [[X-Cart:Summary_Page |Summary]] page in X-Cart Admin area.}}

'''To install the module''':
# Download the ShippingEasy module archive from the File Area section of your {{QA}}. Look for a file named like x-shippingeasy-x.y.z.tgz, where x, y and z are numbers matching the version of your installed copy of X-Cart.
# Copy the contents of the module achive to the X-Cart root directory on your server or hosting account.
#* If you are using a Windows-based server, or a UNIX-based server without terminal access:
#: a) Unpack the module archive to a directory on your system using your favorite compression program (WinZIP, 7-Zip or any other archiver with support for TAR files).
#: b) Use an FTP client to upload all the files contained in this directory (retaining the directory structure) to the X-Cart root directory on your server or your hosting account.
#* If you are using a UNIX-based server with terminal access:
#: a) Use an FTP client to upload the module archive to the X-Cart root directory on your server or your hosting account.
#: b) Unpack the archive using the following command:
#: <pre>tar -xzvf x-shippingeasy-x.y.z.tgz</pre>
#: (Replace x, y and z with the actual version numbers).
#: {{Note1|'''Important:''' Make sure you keep the directory structure while unpacking and uploading the module archive, otherwise some necessary files may be overwritten!}}
# In a web browser, run the installation script httр://<YOUR_XCART_DOMAIN>/install-shippingeasy.php replacing <YOUR_XCART_DOMAIN> with the actual domain name of your X-Cart store. This will start the installation wizard. A screen like the following will be displayed: [[File:PwA_install.png|700px|border]] 
# Carefully read the License agreement, enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]] for your X-Cart installation into the Auth code field and select the "I accept the License Agreement" check box: [[File:PwA_install1.png|700px|border]] 
# Click '''Next''' to continue. The installation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be activated: [[File:PwA_install2.png|700px|border]] {{Note1|'''Note:''' If you are using a custom skin, you will need to patch it manually. Otherwise, the module will not work in this skin.}}
# Once the process is completed, click '''Next'''. This will open the next screen where you will be asked whether you wish a new system fingerprint to be generated: [[File:PwA_install3.png|700px|border]] 
# Make your selection (Yes/No) and click '''Next'''. If you have chosen to generate a new system fingerprint, it will be generated. The process of generating a system fingerprint may take up as long as a few minutes. Once the generation process is completed, click '''Next'''. If you have chosen to skip the generation of a system fingerprint, you will be taken to the next step.
# After clicking '''Next''' you should see the "Installation complete" screen: [[File:PwA_install4.png|700px|border]] This is the final step. It informs you that the ShippingEasy module has been installed successfully. It also reminds you to remove the module archive file in case you put it in a web accessible directory; this is needed to protect the module from unauthorized copying. '''Important:''' At the final step of the installation process, the installation script install-shippingeasy.php is automatically renamed as an additional measure to protect the module installation. Please take note of the filename to which the installation script was renamed. If you decide to re-install or uninstall the module later on, you will need to rename the installation script back to install-shippingeasy.php before launching the installation process in your web browser.

Now if you choose to view the list of your store's installed modules (this can be done using the Administrator area link provided on the "Installation complete" screen), the ShippingEasy module will be on the list:
::[[File:PwA_modules_list.png|border]]

See also:
:* [[X-Cart:ShippingEasy#Integrating your X-Cart store with ShippingEasy|Integrating your X-Cart store with ShippingEasy]]

==Uninstallation==

Uninstallation completely removes all the data related to the ShippingEasy module from your store.

To complete the uninstallation, you will need to run the ShippingEasy module installation script. You might remember that, after the module was installed in your store, the script was saved with a new name to help prevent unauthorised runs of the installer. Now, before you start, you need to rename the script back to its original name - install-shippingeasy.php.

'''To uninstall the module''':

# Run the module installation script in your web browser by going to httр://<YOUR_XCART_DOMAIN>/install-shippingeasy.php (be sure to replace the <YOUR_XCART_DOMAIN> part with the actual domain name of your X-Cart store). This will start the installation wizard. A screen like the following will be displayed: [[File:PwA_uninstall.png|700px|border]] 
# Select "Uninstall the module", enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]] for your X-Cart installation into the Auth code field and select the "I accept the License Agreement" check box: [[File:PwA_uninstall1.png|700px|border]] 
# Click '''Next''' to continue. The uninstallation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be deactivated: [[File:PwA_uninstall2.png|700px|border]] 
# Once the process is completed, click '''Next'''. This will open the next screen where you will be able to generate a new system fingerprint.
# Generate the system fingerprint, or skip it. After clicking '''Next''' you should see the "Uninstallation complete" screen: [[File:PwA_uninstall3.png|700px|border]] This is all. The ShippingEasy module has been uninstalled.

@@ Line 37: / Line 37: @@
 '''To uninstall the module''':
-# Run the module installation script in your web browser by going to <u>httр://<YOUR_XCART_DOMAIN>/install-shippingeasy.php</u> (be sure to replace the <u><YOUR_XCART_DOMAIN></u> part with the actual domain name of your X-Cart store). This will start the installation wizard. A screen like the following will be displayed:<br />[[File:PwA_uninstall.png|700px|border]]<br /><br />
+# Run the module installation script in your web browser by going to <u>httр://<YOUR_XCART_DOMAIN>/install-shippingeasy.php</u> (be sure to replace the <u><YOUR_XCART_DOMAIN></u> part with the actual domain name of your X-Cart store). This will start the installation wizard. A screen like the following will be displayed:<br />[[File:shippingeasy_uninstall1.png|700px|border]]<br /><br />
-# Select "Uninstall the module", enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]] for your X-Cart installation into the Auth code field and select the "I accept the License Agreement" check box:<br />[[File:PwA_uninstall1.png|700px|border]]<br /><br />
+# Select "Uninstall the module", enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]] for your X-Cart installation into the Auth code field and select the "I accept the License Agreement" check box:<br />[[File:shippingeasy_uninstall2.png|700px|border]]<br /><br />
-# Click '''Next''' to continue. The uninstallation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be deactivated:<br />[[File:PwA_uninstall2.png|700px|border]]<br /><br />
+# Click '''Next''' to continue. The uninstallation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be deactivated:<br />[[File:shippingeasy_uninstall3.png|700px|border]]<br /><br />
-# Once the process is completed, click '''Next'''. This will open the next screen where you will be able to generate a new system fingerprint.
+# Once the process is completed, click '''Next'''. This will open the next screen where you will be able to generate a new system fingerprint.<br />[[File:shippingeasy_installation4.png|700px|border]]
-# Generate the system fingerprint, or skip it. After clicking '''Next''' you should see the "Uninstallation complete" screen:<br />[[File:PwA_uninstall3.png|700px|border]]<br /><br />This is all. The ShippingEasy module has been uninstalled.
+# Generate the system fingerprint, or skip it. After clicking '''Next''' you should see the "Uninstallation complete" screen:<br />[[File:shippingeasy_uninstall4.png|700px|border]]<br /><br />This is all. The ShippingEasy module has been uninstalled.

@@ Line 24: / Line 24: @@
 Now if you choose to view the list of your store's installed modules (this can be done using the Administrator area link provided on the "Installation complete" screen), the ShippingEasy module will be on the list:
-::[[File:shippingeasy_installed_enabled.png|700px|border]]
+::[[File:shippingeasy_installed.png|700px|border]]
 See also:

@@ Line 24: / Line 24: @@
 Now if you choose to view the list of your store's installed modules (this can be done using the Administrator area link provided on the "Installation complete" screen), the ShippingEasy module will be on the list:
-::[[File:shippingeasy_installed_enabled.png|border]]
+::[[File:shippingeasy_installed_enabled.png|700px|border]]
 See also:

@@ Line 16: / Line 16: @@
 #: (Replace <u>x</u>, <u>y</u> and <u>z</u> with the actual version numbers).
 #: {{Note1|'''Important:''' Make sure you keep the directory structure while unpacking and uploading the module archive, otherwise some necessary files may be overwritten!}}
-# In a web browser, run the installation script <u>httр://<YOUR_XCART_DOMAIN>/install-shippingeasy.php</u> replacing <u><YOUR_XCART_DOMAIN></u> with the actual domain name of your X-Cart store. This will start the installation wizard. A screen like the following will be displayed:<br />[[File:PwA_install.png|700px|border]]<br /><br />
+# In a web browser, run the installation script <u>httр://<YOUR_XCART_DOMAIN>/install-shippingeasy.php</u> replacing <u><YOUR_XCART_DOMAIN></u> with the actual domain name of your X-Cart store. This will start the installation wizard. A screen like the following will be displayed:<br />[[File:shippingeasy_installation1.png|700px|border]]<br /><br />
-# Carefully read the License agreement, enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]] for your X-Cart installation into the Auth code field and select the "I accept the License Agreement" check box:<br />[[File:PwA_install1.png|700px|border]]<br /><br />
+# Carefully read the License agreement, enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]] for your X-Cart installation into the Auth code field and select the "I accept the License Agreement" check box:<br />[[File:shippingeasy_installation2.png|700px|border]]<br /><br />
-# Click '''Next''' to continue. The installation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be activated:<br />[[File:PwA_install2.png|700px|border]]<br />
+# Click '''Next''' to continue. The installation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be activated:<br />[[File:shippingeasy_installation3.png|700px|border]]<br />
-# Once the process is completed, click '''Next'''. This will open the next screen where you will be asked whether you wish a new system fingerprint to be generated:<br />[[File:PwA_install3.png|700px|border]]<br /><br />
+# Once the process is completed, click '''Next'''. This will open the next screen where you will be asked whether you wish a new system fingerprint to be generated:<br />[[File:shippingeasy_installation4.png|700px|border]]<br /><br />
 # Make your selection (Yes/No) and click '''Next'''. If you have chosen to generate a new system fingerprint, it will be generated. The process of generating a system fingerprint may take up as long as a few minutes. Once the generation process is completed, click '''Next'''. If you have chosen to skip the generation of a system fingerprint, you will be taken to the next step.
-# After clicking '''Next''' you should see the "Installation complete" screen:<br />[[File:PwA_install4.png|700px|border]]<br /><br />This is the final step. It informs you that the ShippingEasy module has been installed successfully. It also reminds you to remove the module archive file in case you put it in a web accessible directory; this is needed to protect the module from unauthorized copying.<br />'''Important:''' At the final step of the installation process, the installation script <u>install-shippingeasy.php</u> is automatically renamed as an additional measure to protect the module installation. Please take note of the filename to which the installation script was renamed. If you decide to re-install or uninstall the module later on, you will need to rename the installation script back to <u>install-shippingeasy.php</u> before launching the installation process in your web browser.
+# After clicking '''Next''' you should see the "Installation complete" screen:<br />[[File:shippingeasy_installation5.png|700px|border]]<br /><br />This is the final step. It informs you that the ShippingEasy module has been installed successfully. It also reminds you to remove the module archive file in case you put it in a web accessible directory; this is needed to protect the module from unauthorized copying.<br />'''Important:''' At the final step of the installation process, the installation script <u>install-shippingeasy.php</u> is automatically renamed as an additional measure to protect the module installation. Please take note of the filename to which the installation script was renamed. If you decide to re-install or uninstall the module later on, you will need to rename the installation script back to <u>install-shippingeasy.php</u> before launching the installation process in your web browser.
 Now if you choose to view the list of your store's installed modules (this can be done using the Administrator area link provided on the "Installation complete" screen), the ShippingEasy module will be on the list:
-::[[File:PwA_modules_list.png|border]]
+::[[File:shippingeasy_installed_enabled.png|border]]
 See also:

@@ Line 18: / Line 18: @@
 # In a web browser, run the installation script <u>httр://<YOUR_XCART_DOMAIN>/install-shippingeasy.php</u> replacing <u><YOUR_XCART_DOMAIN></u> with the actual domain name of your X-Cart store. This will start the installation wizard. A screen like the following will be displayed:<br />[[File:PwA_install.png|700px|border]]<br /><br />
 # Carefully read the License agreement, enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]] for your X-Cart installation into the Auth code field and select the "I accept the License Agreement" check box:<br />[[File:PwA_install1.png|700px|border]]<br /><br />
-# Click '''Next''' to continue. The installation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be activated:<br />[[File:PwA_install2.png|700px|border]]<br /><br />{{Note1|'''Note:''' If you are using a custom skin, you will need to patch it manually. Otherwise, the module will not work in this skin.}}
+# Click '''Next''' to continue. The installation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be activated:<br />[[File:PwA_install2.png|700px|border]]<br />
 # Once the process is completed, click '''Next'''. This will open the next screen where you will be asked whether you wish a new system fingerprint to be generated:<br />[[File:PwA_install3.png|700px|border]]<br /><br />
 # Make your selection (Yes/No) and click '''Next'''. If you have chosen to generate a new system fingerprint, it will be generated. The process of generating a system fingerprint may take up as long as a few minutes. Once the generation process is completed, click '''Next'''. If you have chosen to skip the generation of a system fingerprint, you will be taken to the next step.

@@ Line 6: / Line 6: @@
 '''To install the module''':
 # Download the ShippingEasy module archive from the File Area section of your {{QA}}. Look for a file named like <u>x-shippingeasy-x.y.z.tgz</u>, where <u>x</u>, <u>y</u> and <u>z</u> are numbers matching the version of your installed copy of X-Cart.
-# Copy the contents of the module achive to the X-Cart root directory on your server or hosting account.
+# Copy the contents of the module archive to the X-Cart root directory on your server or hosting account.
 #* If you are using a Windows-based server, or a UNIX-based server without terminal access:
 #: a) Unpack the module archive to a directory on your system using your favorite compression program (WinZIP, 7-Zip or any other archiver with support for TAR files).