How To Install Connector File

LitExtension Connector files are used to establish a connection between your shopping carts and make the data exchange possible. They are special access gateways that are completely secured by unique Security Tokens bounded to your personal account and provided by LitExtension. To work correctly, “le_connector” folder needs to be located in your store’s root folder

 

How to install Connector files?

The procedure is the same for macOS, Windows and Linux users. You can use Filezilla or any FTP app (FileZilla, WinSCP, FileFTP, CuteFTP)

Step 1: Firstly, at your Migration Setup page, after filling Source/Target cart URL, easily download connector by clicking “Download Litextension Connector”. You will receive a zip file.

Install Connector File

 

Step 2: Upload the folder “le_connector” to your Source / Target store via FTP. Whichever FTP client you are using (FileZilla, WinSCP, FileFTP, CuteFTP) enter the root folder of your store and paste the “le_connector” folder you extracted from the zip file previously.

Install Connector File

 

Step 3: Check whether Connector files have been installed correctly. Click the instructed link or you can directly type in url in your browser, it should be /le_connector/connector.php added to your root store url. If you see this message “Connector Installed” – Connector is working correctly and you can proceed with the next step of your migration.

Install Connector File

Done! You have already installed Litextension connector successfully. Hit next to finish your data migration with LitExtension!
 

If your web server is Nginx

If you are running Nginx as webserver( instead of Apache), the above steps might not get the connector working immediately. Because Nginx normally does not allow access to all php files, and thus requires some additional configuration for this to work. For details please consult:

https://www.linode.com/docs/web-servers/nginx/serve-php-php-fpm-and-nginx/#configure-the-nginx-server-block

In case you still facing difficulties, it is recommended to ask your web developer for help.
 

How to fix Connector Setup issue?

Question 1: I’m clicking on the link but just get a “File not found” message?

Answer: Please make sure you have uploaded the “le_connector” folder to the correct location on your website. With most shopping carts, you just need to upload “le_connector” to the webroot folder. But some carts has been configured to use a sub folder as root folder. For example:

Magento 2: can be confgured to use both webroot or webroot/pub as root folder ( https://devdocs.magento.com/guides/v2.3/install-gde/tutorials/change-docroot-to-pub.html ). Please make sure you upload “le_connector” to the correct place.

 

Question 2: I’m clicking on the link but just get a “File not found. Nginx version ….” message?

Answer: This shows that your webserver is running Nginx, did you check the section “If your webserver is Nginx” above?

 

Question 3: I’m clicking on the link but no “Connector Installed” message shown?

Answer: It could be due to your permission setting upon the uploaded files and folder. Please set permissions like below:
1. 755 or 777 for “/le_connector” folder, if you are using Filezilla you can simply right click on the “/le_connector” folder in your root folder, select file permissions and set the necessary value.
LitEXtension connector

 

2. 644 (if “/le_connector” folder permission is set to 755) or 666 (if “/le_connector” folder permission is set to 777) for “connector.php”.

 

Question 4: Oops, it still doesn’t work?

Answer: No worries, we can give a helping hand for that, please just “Contact Us” for further assistance.