Update readme

This commit is contained in:
Pavel 2021-05-18 12:11:19 +03:00 committed by GitHub
parent d058173aa4
commit a1f97bc996
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -6,7 +6,7 @@
Opencart module Opencart module
=============== ===============
Module allows integrate CMS Opencart >= 2.3 with [RetailCRM](https://retailcrm.pro) This module allows to integrate CMS Opencart >= 2.3 with [RetailCRM](https://retailcrm.pro).
### Previous versions: ### Previous versions:
@ -16,51 +16,59 @@ Module allows integrate CMS Opencart >= 2.3 with [RetailCRM](https://retailcrm.p
#### Features: #### Features:
* Export orders to RetailCRM & fetch changes back * Export orders to RetailCRM & receive changes from RetailCRM.
* Export product catalog into [ICML](https://help.retailcrm.pro/Developers/ICML) format * Export product catalog to the [ICML](https://help.retailcrm.pro/Developers/ICML) format.
#### Install #### Install
Copy files to the site root **Note:** `/path/to/your/site` is just a placeholder. You should replace it with the actual path to your site root in the examples below. The module won't work if you'll use those examples without changing the path placeholder.
Copy module files to the site root (replace `/path/to/your/site` with the actual path to your site):
``` ```
unzip master.zip unzip master.zip
cp -r opencart-module/src/* /path/to/site/root cp -r opencart-module/src/* /path/to/your/site
``` ```
#### Setup #### Setup
* Go to Admin -> Extensions -> Modules -> RetailCRM * Go to Admin -> Extensions -> Modules -> RetailCRM
* Fill you api url & api key * Fill you API URL & API key
* Specify directories matching * Specify directories matching
#### Migrating to 4.* from early modules versions #### Migrating to 4.* from early modules versions
Before you copy the files of module you will to remove the directory `path/to/opencart/system/library/retailcrm` It's necessary to remove the `/path/to/your/site/system/library/retailcrm` before copying current module into your site.
#### Getting changes in orders #### Getting changes in orders
Add to cron: Add to cron (replace `/path/to/your/site` with the actual path to your site):
``` ```
*/5 * * * * /usr/bin/php /path/to/opencart/system/library/retailcrm/cron/history.php >> /path/to/opencart/system/storage/logs/cronjob_history.log 2>&1 */5 * * * * /usr/bin/php /path/to/your/site/system/library/retailcrm/cron/history.php >> /path/to/your/site/system/storage/logs/cronjob_history.log 2>&1
``` ```
#### Setting product catalog export #### Setting product catalog export
Add to cron: Add to cron (replace `/path/to/your/site` with the actual path to your site):
``` ```
* */4 * * * /usr/bin/php /path/to/opencart/system/library/retailcrm/cron/icml.php >> /path/to/opencart/system/storage/logs/cronjob_icml.log 2>&1 * */4 * * * /usr/bin/php /path/to/your/site/system/library/retailcrm/cron/icml.php >> /path/to/your/site/system/storage/logs/cronjob_icml.log 2>&1
``` ```
Your export file will be available by following url Your export file should be available by following url:
``` ```
http://youropencartsite.com/retailcrm.xml http://youropencartsite.com/retailcrm.xml
``` ```
Replace `youropencartsite.com` with your site domain and `http` with your site scheme.
#### Export existing orders and customers #### Export existing orders and customers
You want to run this command onecly: Run this command (replace `/path/to/your/site` with the actual path to your site):
/usr/bin/php /path/to/opencart/system/library/retailcrm/cron/export.php ```sh
/usr/bin/php /path/to/your/site/system/library/retailcrm/cron/export.php
```
You should run this command only once.