combindma/yotpo-api

This package is abandoned and no longer maintained. No replacement package was suggested.

This is my package yotpo-api

1.0.12 2021-10-04 21:38 UTC

Requires

• php: ^8.0
• guzzlehttp/guzzle: ^7.3
• illuminate/contracts: ^8.37
• spatie/laravel-package-tools: ^1.4.3

Requires (Dev)

• brianium/paratest: ^6.2
• nunomaduro/collision: ^5.3
• orchestra/testbench: ^6.15
• phpunit/phpunit: ^9.3
• spatie/laravel-ray: ^1.23
• vimeo/psalm: ^4.8

MIT

• Combind

• laravel
• combindma
• yotpo-api

README

Installation

You can install the package via composer:

composer require combindma/yotpo-api

You can publish the config file with:

php artisan vendor:publish --provider="Combindma\YotpoApi\YotpoApiServiceProvider" --tag="yotpo-config"

This is the contents of the published config file:

return [
    /*
    * Enable or disable Yotpo api. Useful for local development when runing tests.
    */
    'api_enabled' => env('YOTPO_API_ENABLED', false),

    /*
   * Enable or disable Yotpo Loyalty. Useful for local development when runing tests.
   */
    'loyalty_enabled' => env('YOTPO_LOYALTY_ENABLED', false),

    /*
    * Core API V3 Credentials
    */
    'app_key' => env('YOTPO_APP_KEY'),
    'secret_key' => env('YOTPO_SECRET_KEY'),

    /*
    * Loyalty & Referrals API Credentials
    */
    'loyalty_api_key' => env('LOYALTY_API_KEY'),
    'loyalty_guid_key' => env('LOYALTY_GUID_KEY'),

    /*
     * CDNs
     * */
    'loyalty_js_sdk_url' => env('LOYALTY_JS_SDK_URL'),
    'loyalty_modules_loader_url' => env('LOYALTY_MODULES_LOADER_URL'),

    /*
     * Refer link used by Loyalty Program
     * */
    'refer_link' => 'http://rwrd.io',

    /*
     * Default currency code you want to use. Make sure to have the same in your Yotpo Loyalty admin: https://loyalty.yotpo.com/general-settings
     * */
    'currency' => env('YOTPO_DEFAULT_CURRENCY', 'MAD'),

    /*
    * Default country code you want to use. This is important for API requests when submitting the phone number
    * */
    'country' => env('YOTPO_DEFAULT_COUNTRY', 'MA')
];

Usage

• You should create a free account in https://yotpo.com and add your credentials in .env file
• You must add Combindma\YotpoApi\Traits\YotpoCustomer to user model or implement yours. Just be sure to have the same structure (same array keys).
• You must add Combindma\YotpoApi\Traits\YotpoPurchase to order model or implement yours. Just be sure to have the same structure (same array keys).

For further documentation

• Loyalty API Documentation: https://loyaltyapi.yotpo.com/reference
• Core API V3 Documentation: https://core-api.yotpo.com/reference

Example of use: create a customer in loyality program

use Combindma\YotpoApi\Facades\YotpoApi;

//yotpoApiData is implemented in Combindma\YotpoApi\Traits\YotpoCustomer. You can create yours.
YotpoApi::createOrUpdateLoyaltyCustomer($user->yotpoApiData());

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• Combind
• All Contributors

License

The MIT License (MIT). Please see License File for more information.