Installing the Magento Extension

In order to use Magento with SureDone, you will need to install our Magento Exentsion on your Magento Server. Installation of the extension requires knowledge of how to use FTP, SSH, and your Magento server setup. If you are not comfortable following these instructions yourself, please contact the person or company that set up your Magento Store Server and have them follow the instructions outlined below.

Warning

Please contact Suredone support if you’re using a non-Linux Server before attempting to install our extension or if any of these steps are unclear to you. The instructions below have been optimized for a Linux Server. Any errors made in your Magento Installation Directory may have serious, irreversible consequences.

File Download

You will first need to download the extension file from our server. Click here to access the download.

Verify Your Settings

In order to ensure that your installation goes smoothly, please verify some settings in your Magento account.

1. Navigate to System > Configuration > Magento Core API
2. Make sure that both the “WS-I Compliance” & “Enable WSDL Cache” are both set to No.
3. Make sure to click “Save Config” when you have.

   

Beginning the Installation

Now you are ready to begin the installation.

1. Locate the extension file you downloaded, Magento-SD-ext.zip.
2. Unzip the contents of the folder on your computer.
   1. You should see a single folder called ‘app’.
3. Upload the folder to your server through FTP or SSH.
   1. You will need to merge the contents of this folder with the existing ‘app’ folder.
   2. The location of this folder should be at the root of your Magento installation (main directory).
   3. Merge the contents of the unzipped folder into the existing ‘app’ folder.
4. Verify whether you are using Magento in a "Compiled" mode. 
   1. Navigate to System > Tools > Compilation.
   2. If "Compiler" status is "Enabled" you are running in Compiled mode.
   3. Click on "Run Compilation Process" to include the new plugin into Magento correctly.

Verifying the Installation

Now that you have installed the Magento extension, you need to confirm that the integration was successful. You’ll need to access your Magento Store’s WSDL.

1. To locate your store’s WSDL, replace yourdomain.com with your site’s domain name in any of the URLs below.  Which of the URLs will work for you will depend on how your Magento server is setup.
   1. http://yourdomain.com/api/v2_soap?wsdl=1
   2. http://yourdomain.com/index.php/api/v2_soap?wsdl=1
   3. https://yourdomain.com/api/v2_soap?wsdl=1
   4. https://yourdomain.com/index.php/api/v2_soap?wsdl=1
      
      

2. You’ll know you’ve found the WSDL, when the screen looks similar to this:
   
   

   
   
   

3. Having found the WSDL, search for the word “bubble”.
   
   

   

4. If you find the section with the word “bubble”, your installation was successful. You may now navigate back to your API Settings, System > Configuration > Magento Core API.
5. Set “Enable WSDL Cache” to YES.
6. Make sure to click “Save Config” when you have.
7. Proceed to Account Authorization, which can be found in Article 6.1.2 Setting up Magento in SureDone

If you can’t find “bubble” anywhere in your WSDL, you will need to clear all the caches on Magento. Follow the steps below for clearing your caches.

1. Navigate to System > Cache Management
   
   

   
   
   

2. Click “Select All”
3. Set the Action to “Refresh”.
4. Click on Submit.
   
   

   
   
   

5. Now, in the top right corner above “Submit", click “Flush Magento Cache” and “Flush Cache Storage”.
   
   

   
   
   

6. Refresh the WSDL page and check to see if the word “bubble” now appears.
7. If it does, your installation was successful. You may now navigate back to your API Settings, System > Configuration > Magento Core API.
8. Set “Enable WSDL Cache” to YES.
9. Make sure to click “Save Config” when you have.
10. Proceed to Account Authorization, which can be found in Article 6.1.2 Setting up Magento in SureDone

Troubleshooting

If you still cannot find the word “bubble,” make sure you followed the initial install instructions exactly. If it’s still not working, please contact us, and we will help you troubleshoot the issue.

If you are highly experienced with magento and handling servers, you may try the following Advanced trouble shooting techniques before contacting support.

• You may need to restart your web server (apache, nginx, lighttpd, etc...) and PHP.
• If restarting is unsuccessful, go to your Magento root, cd into app/etc/cache and delete everything in there.

Once successfully installed, please proceed to 6.1.2 Setting up Magento in SureDone to finish the setup process.