syscover/market

Market package

Market for Laravel 5.3

, _(*1)

Installation

1 - After install Laravel framework, insert on file composer.json, inside require object this value, _(*2)

"syscover/market": "~2.0"

and execute on console:, _(*3)

composer update

2 - Register service provider, on file config/app.php add to providers array, _(*4)

Syscover\Market\MarketServiceProvider::class,

3 - Execute publish command, _(*5)

php artisan vendor:publish

4 - Execute optimize command load new classes, _(*6)

php artisan optimize

5 - And execute migrations and seed database, _(*7)

php artisan migrate
php artisan db:seed --class="MarketTableSeeder"

6 - Execute command to load all updates, _(*8)

php artisan migrate --path=database/migrations/updates

7 - Register middleware pulsar.taxRule on file app/Http/Kernel.php add to routeMiddleware array, _(*9)

'pulsar.taxRule' => \Syscover\Market\Middleware\TaxRule::class,

Activate Package

Access to Pulsar Panel, and go to:, _(*10)

Administration-> Permissions-> Profiles, and set all permissions to your profile by clicking on the open lock.
, _(*11)

Go to Administration -> Packages, edit the package installed and activate it., _(*12)

General configuration environment values

We indicate configuration variables available, to change them what you should do from the file environment variables .env, _(*13)

Order id prefix [default value empty]

You can set a prefix for all your orders, for example, if you can set on all you orders the prefix ORDER, set this value on you .env file, _(*14)

ORDER_ID_PREFIX=ORDER

Tax default country [default value ES]

To set default country to calculate tax, you can use this parameter, for example to change to US, set this value on you .env file, _(*15)

TAX_COUNTRY=US

Default customer class tax [default value 1]

Set default ID customer class value for calculate tax amount of products, _(*16)

TAX_CUSTOMER_CLASS=1

Set product price tax [default value 1]

Defines the types of prices that are introduced in products, this option is consulted when you create or update a product You have this values: * Value: 1 Excluding tax * Value: 2 Including tax, _(*17)

TAX_PRODUCT_PRICES=1

Set shipping price tax [default value 1]

Defines the types of prices that are introduced in shipping prices, this option is consulted when you create or update a shipping price * Value: 1 Excluding tax * Value: 2 Including tax, _(*18)

TAX_SHIPPING_PRICES=1

Set product display price tax [default value 1]

Defines how you want display product prices You have this values: * Value: 1 Excluding tax * Value: 2 Including tax, _(*19)

TAX_PRODUCT_DISPLAY_PRICES=1

Set shipping display price tax [default value 1]

Defines how you want display shipping prices * Value: 1 Excluding tax * Value: 2 Including tax, _(*20)

TAX_SHIPPING_DISPLAY_PRICES=1

PayPal environment values

Set PayPal mode

• Value: sandbox for testing or development environments
• Value: live for production environments

PAYPAL_MODE=sandbox

PayPal sandbox values

PAYPAL_SANDBOX_WEB_PROFILE=XX-XXXX-XXXX-XXXX-XXXX
PAYPAL_SANDBOX_CLIENT_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
PAYPAL_SANDBOX_SECRET=xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXx

PayPal live values

PAYPAL_LIVE_WEB_PROFILE=XX-XXXX-XXXX-XXXX-XXXX
PAYPAL_LIVE_CLIENT_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
PAYPAL_LIVE_SECRET_KEY=xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXx

Redsys environment values

Set Redsys mode

• Value: test for testing or development environments
• Value: live for production environments

REDSYS_MODE=test

Redsys test values

REDSYS_TEST_MERCHANT_NAME="MERCHANT NAME (TEST)"
REDSYS_TEST_MERCHANT_CODE=xxxxxxxxx
REDSYS_TEST_KEY=xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXx

Redsys live values

REDSYS_LIVE_MERCHANT_NAME="MERCHANT NAME"
REDSYS_LIVE_MERCHANT_CODE=xxxxxxxxx
REDSYS_LIVE_KEY=xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXx

Other concepts

Set tax rules values for each customer

When a customer is login on your web application, you need know your country and customer group to calculate tax rules for all products. You have a Middleware who is responsible to do this actions., _(*21)

Route::group(['middleware' => ['pulsar.taxRule']], function() {

    // write here your routes

});

This middleware set market.taxCountry and market.taxCustomerClass if customer has country and customer group id defined, _(*22)