mirror of
https://github.com/retailcrm/opencart-module.git
synced 2024-11-25 14:46:06 +03:00
Update readme
This commit is contained in:
parent
c454db172f
commit
c49070ea6f
63
README.md
63
README.md
@ -1,26 +1,57 @@
|
||||
# OpenCart Project Template
|
||||
Opencart module
|
||||
===============
|
||||
|
||||
## Getting Started
|
||||
Module allows integrate CMS Opencart >= 2.3 with [retailCRM](http://retailcrm.pro)
|
||||
|
||||
1. Create a new project: `composer create-project beyondit/opencart-project-template ./my/project/folder -s dev`
|
||||
2. Copy the `.env.sample` file to `.env` and set the configuration parameters respectively
|
||||
3. Run `bin/robo opencart:setup` and afterwards `bin/robo opencart:run` on command line (`bin/robo opencart:run &` to run in background)
|
||||
4. Open `http://localhost:8000` in your browser
|
||||
### Previous versions:
|
||||
|
||||
## Robo Commands
|
||||
[v1.x](https://github.com/retailcrm/opencart-module/tree/v1.x)
|
||||
|
||||
* `bin/robo opencart:setup` : Install OpenCart with configuration set in `.env` file
|
||||
* `bin/robo opencart:run` : Run OpenCart on a php build-in web server on port 8000
|
||||
* `bin/robo project:deploy` : Mirror contents of the src folder to the OpenCart test environment
|
||||
* `bin/robo project:watch` : Redeploy after changes inside the src/ folder or the composer.json file
|
||||
* `bin/robo project:package`: Package a `build.ocmod.zip` inside the target/ folder
|
||||
[v2.x (2.0, 2.1, 2.2)](https://github.com/retailcrm/opencart-module/tree/v2.2)
|
||||
|
||||
## Writing Tests
|
||||
#### Features:
|
||||
|
||||
* Based on the [OpenCart Testing Suite](https://github.com/beyondit/opencart-test-suite) project tests can be written.
|
||||
* After successful setup and deployment, tests can be executed by running the `bin/phpunit` command.
|
||||
* Two examples inside the `/tests` folder are given, which can be executed as separat Testsuites by `bin/phpunit --testsuite admin-tests` or `bin/phpunit --testsuite catalog-tests`
|
||||
* Export orders to retailCRM & fetch changes back
|
||||
* Export product catalog into [ICML](http://www.retailcrm.pro/docs/Developers/ICML) format
|
||||
|
||||
#### Install
|
||||
|
||||
Copy files to the site root
|
||||
|
||||
```
|
||||
unzip master.zip
|
||||
cp -r opencart-module/* /path/to/site/root
|
||||
```
|
||||
|
||||
#### Setup
|
||||
|
||||
* Go to Admin -> Extensions -> Modules -> retailCRM
|
||||
* Fill you api url & api key
|
||||
* Specify directories matching
|
||||
|
||||
#### Getting changes in orders
|
||||
|
||||
Add to cron:
|
||||
|
||||
```
|
||||
*/5 * * * * /usr/bin/php /path/to/opencart/system/cron/history.php >> /path/to/opencart/system/storage/logs/cronjob_history.log 2>&1
|
||||
```
|
||||
|
||||
#### Setting product catalog export
|
||||
|
||||
Add to cron:
|
||||
|
||||
```
|
||||
* */4 * * * /usr/bin/php /path/to/opencart/system/cron/icml.php >> /path/to/opencart/system/storage/logs/cronjob_icml.log 2>&1
|
||||
```
|
||||
|
||||
Your export file will be available by following url
|
||||
|
||||
```
|
||||
http://youropencartsite.com/retailcrm.xml
|
||||
```
|
||||
|
||||
#### Export existing orders and customers
|
||||
|
||||
You want to run this command onecly:
|
||||
/usr/bin/php /path/to/opencart/system/cron/export.php
|
||||
|
Loading…
Reference in New Issue
Block a user