bhavinjr/laravel-ekomi

Ekomi Laravel 扩展包

v1.1 2019-01-28 07:23 UTC

This package is auto-updated.

Last update: 2024-08-28 23:32:51 UTC


README

Latest Stable Version Total Downloads License

lararvel-ekomi based on eKomi_APIv3

安装

首先,您需要使用 Composer 安装此包

$ composer require bhavinjr/laravel-ekomi

如果您不使用 Laravel 5.5.*,则更新 config/app.php 文件,添加服务提供者的条目。

'providers' => [
    // ...
    Bhavinjr\Ekomi\Providers\EkomiServiceProvider::class,
];

'aliases' => [
    //...
    "Ekomi": "Bhavinjr\Ekomi\Facades\Ekomi",
];

在命令行中粘贴以下命令

php artisan config:cache

再次在命令行中,发布默认配置文件

php artisan vendor:publish --provider="Bhavinjr\Ekomi\Providers\EkomiServiceProvider"

配置

配置设计得尽可能灵活。全局配置可以在 config/ekomi.php 文件中设置。

更新 config/ekomi.php 文件后。

php artisan config:cache

使用方法

该包提供了以下方法供您使用

PutProduct

use Bhavinjr\Ekomi\Services\PutProduct;
use Ekomi;

$putProduct = new PutProduct();
$putProduct->setProductId(1)
           ->setProductName('t-shirt')
           ->setProductOther('json or serialized array') //optional. if has additional data such as categories, image_urls etc..
           ->setProductCanonicalLink('www.laravel-ekomi.com/t-shirt'); //optional

Ekomi::create($putProduct);

PutOrder

$putOrder = new PutOrder();
$putOrder->setOrderId(1)
         ->setProductIds(1) //if more than on products '1,2'
         ->setOrderTimestamp('2018-08-16'); // YYYY-MM-DD

Ekomi::create($putOrder);

PutComment

$putComment = new PutComment();
$putComment->setOrderId(1)
           ->setComment('laravel+ekomi') //Must be urlencoded.
           ->setUpdate('replace or delete'); //optional

Ekomi::create($putComment);

PutDialog

$putDialog = new PutDialog();
$putDialog->setOrderId(1)
          ->setMessage('laravel+ekomi'); //Must be urlencoded

Ekomi::create($putDialog);

PutClient

$putClient = new PutClient();
$putClient->setClientId(1)
          ->setEmail('bhavin@gmail.com'); //optional

Ekomi::create($putClient);

also check other optional properties: 
setLocale, setScreenName, setFirstName, setLastName, setCountry, setCity, setZip, setGender, setBirthdate, setMetadata 

AssignClientOrder

$assignOrder = new AssignClientOrder();
$assignOrder->setOrderId(1)
            ->setClientId(1)
            ->setUnlink(false); //true if want to removes the order_id assignment

Ekomi::create($assignOrder);

GetAverage

$getAverage = new GetAverage();
$getAverage->setDays(8); //optional

Ekomi::create($getAverage);

GetDialog

$getDialog = new GetDialog();
$getDialog->setContent('process_only') //optional
	  ->setRange('all') //optional
	  ->setFilter('all'); //optional

Ekomi::create($getDialog);

GetFeedback

$getFeedback = new GetFeedback();
$getFeedback->setCaching('verylong') //optional available none, short, middle, long, verylong
	    ->fields('date,order_id'); //optional
		  	
Ekomi::create($getFeedback);

also check other optional properties: 
setFilter, setRange

还有其他方法可用

GetMarketResearch, GetProduct, GetProductFeedback, GetProductResearch, GetRated, GetResearch, GetSettings, GetSnapshot, GetVisitorFeedback

also use setType and setCharset properties to any methods 

=> setType is used for output

	default type set is 'json' (json or serialized)

=> setCharset is used for Character encoding

	default charset set is 'iso'