Bazar

Bazar is made to be compact and easy to integrate. This means our goal is to provide a simple solution for those who want to build a small to medium-sized e-commerce system. Keep it in mind when using Bazar; while it is relatively easy to scale (because of the Laravel foundations), it's not for the next eBay or Amazon.

Bazar does not provide a REST API nor a ready-to-use web shop application. It behaves as a framework, and it gives every tool that helps you build your solutions.

If you need a REST API because you want to build a Vue-based store, you can easily do it. If you need a classic webshop application, no worries, you can make it relatively quickly and easily.

We'll provide example code and solutions in the near future, but the Bazar core will never contain more than necessary.

Bazar is a drop-in solution; this means it behaves as a package and not as an application. It has its own layer, so you can build many different things in the same application next to an installed and running Bazar package.

Before moving on, please check out the Laravel documentation about its installation, requirements, and configuration.

Requirements:

• Laravel ^10.0
• PHP 8.2+
• Root ^2.0

You can install Bazar using composer:

composer require conedevelopment/bazar

After installing the package, run the bazar:install command.

php artisan bazar:install

After install Bazar, you can find the config/bazar.php file, where you can configure the package. We'll talk about the specific configurations in their related documentation sections.

Bazar provides some default drivers out of the box: Cash and Transfer drivers. They hold an elementary logic and transaction handling; however, they can be enough in many cases.

Also, you may add your custom driver easily that implements the required logic or pull in a package that provides a gateway.

Registering gateways works almost the same as registering shipping methods. All custom drivers should extend the Bazar\Gateway\Driver class.

use Cone\Bazar\Gateway\Driver;

class CreditCardDriver extends Driver
{
    //
}

Now, let's register the driver using the Bazar\Support\Facades\Gateway facade:

use Cone\Bazar\Support\Facades\Gateway;

Gateway::extend('credit-card', static function ($app): CreditCardDriver {
    return new CreditCardDriver(
        $app['config']->get('services.credit-card')
    );
});

Shipping drivers are responsible for calculating the cost of a model that implements the Bazar\Contracts\Shippable contract.

Bazar provides some default drivers out of the box: Local Pickup and Weight Based Shipping drivers.

The class that implements the interface must implement the shipping method, where the relationship is defined between the model and the Bazar\Models\Shipping model:

use Cone\Bazar\Models\Shipping;
use Illuminate\Database\Eloquent\Relations\MorphOne;

public function shipping(): MorphOne
{
    return $this->morphOne(Shipping::class, 'shippable')->withDefault();
}

The Shipping model does not hold the address values directly on the model, but in the related Bazar\Models\Address model.

Registering shipping methods works almost the same as registering gateways methods. All custom drivers should extend the Bazar\Shipping\Driver class, which holds one abstract method: calculate().

Let's create a simple driver as an example:

use Cone\Bazar\Contracts\Shippable;
use Cone\Bazar\Shipping\Driver;

class FedexDriver extends Driver
{
    public function calculate(Shippable $model): float
    {
        //
    }
}

Now, let's register the driver using the Bazar\Support\Facades\Shipping facade:

use Cone\Bazar\Support\Facades\Shipping;

Shipping::extend('fedex', static function ($app): FedexDriver {
    return new FedexDriver(
        $app['config']->get('services.fedex')
    );
});

Bazar comes with a cart service by default, which manages cart models and their functionality.y. The cart service is one of the most crucial concepts in Bazar. It handles products, variations, quantities, taxes, discounts, shipping and prepares the checkout process.

You can access the current cart by using the Bazar\Support\Facades\Cart facade.

Bazar provides the CookieDriver by default.

Products can be attached to the cart by using the Bazar\Models\Item pivot model. This model holds all the critical information of the relationship between the cart and the product, such as price, quantity and custom properties.

The same product can be attached to the cart as different items. In fact, if a product will be attached to the cart with properties that are already present, the quantity will be increased automatically. However, if there is no product linked with the given properties, a new item will be created.

This approach makes it simple to handle quantities, prices, and variations in a cart - even if the same product was attached multiple times but with different properties.

$item = Cart::addItem($product, 1, ['Size' => 'L']);

Cart::updateItem($item->id, ['Size' => 'S']);

Cart::removeItem($item->id);

Bazar supports multiple currencies by default. Imagine a scenario when your customer starts to put an item in the cart with USD prices, but suddenly, the customer changes the currency. In this case, Bazar recalculates the fees, taxes, discounts and will update the cart's currency.

However, this behavior can be controlled by the lock/unlock mechanism. When the cart is unlocked, Bazar will update the items on currency change. But when the cart is locked, it will keep the original currency and its values.

use Cone\Bazar\Models\Cart;

$cart = Cart::first();

// Lock the cart
$cart->lock();

// Unlock the cart
$cart->unlock();

// Get locked carts
Cart::query()->locked();

// Get unlocked carts
Cart::query()->unlocked();

This can be extremely useful in the checkout process. Locking the cart can make sure that the values are not changing during the process.

To keep the database clean, carts without owners expire in 3 days. To retrieve the expired carts, you may use the expired() query scope on the Cart model:

use Cone\Bazar\Models\Cart;

$expired = Cart::expired()->get();

Also, Bazar provides a command to clean all the expired carts easily. You may run the php artisan bazar:clear-carts command to delete the database's expired cart records.

You may call this command from the scheduler to automatize the cleanup process:

// app/Console/Kernel.php

protected function schedule(Schedule $schedule)
{
    $schedule->command('bazar:clear-carts')->daily();
}

Bazar comes with a cookie driver by default. It stores the current cart's token as a cookie and retrieves the cart model based on the stored token. Because of its straightforward implementation, the cookie driver is not configurable.

Like shipping and payment gateway, Bazar manages multiple cart drivers as well. You can set the default driver easily in the configuration file:

// config/bazar.php

'cart' => [
    'default' => 'token',
    'drivers' => [
        'cookie' => [],
        'token' => [
            // ...
        ],
    ],
]

Registering cart drivers works almost the same as registering shipping methods or payment gateways. All custom drivers should extend the Bazar\Cart\Driver class, which holds one abstract method: resolve().

use Cone\Bazar\Cart\Driver;
use Cone\Bazar\Models\Cart;

class TokenDriver extends Driver
{
    protected function resolve(Request $request): Cart
    {
        return Cart::query()->firstOrNew([
            //
        ]);
    }

    protected function resolved(Request $request, Cart $cart): void
    {
        parent::resolved($request, $cart);

        // Callback after the cart is resolved
    }
}

Now, let's register the driver using the Bazar\Support\Facades\Cart facade:

use Cone\Bazar\Support\Facades\Cart;

Cart::extend('custom', function ($app): CustomDriver {
    return new CustomDriver(
        $app['config']->get('cart.drivers.custom')
    );
});

Bazar comes with flexible tax support by default. You can easily manage tax definitions by using the Bazar\Support\Facades\Tax facade.

Taxes are stored on the Item and the Shipping models. Both implement the Taxable interface, which enforces to use of a unified method signature for calculating taxes.

You may register taxes using the Tax facade. You can pass a number, a Closure, or a class (that implements the Bazar\Contracts\Tax interface) along with the name of the tax.

use Cone\Bazar\Support\Facades\Tax;

// Fix tax
Tax::register('fix-20', 20);

// Custom closure tax
use Cone\Bazar\Models\Shipping;
use Cone\Bazar\Contracts\LineItem;
use Cone\Bazar\Support\Facades\Tax;

Tax::register('custom-percent', function (LineItem $model) {
    return $model->getPrice() * ($model instanceof Shipping ? 0.3 : 0.27);
});

// Class tax
use Cone\Bazar\Contracts\Tax as Contract;
use Cone\Bazar\Contracts\LineItem;
use Cone\Bazar\Models\Shipping;
use Cone\Bazar\Support\Facades\Tax;

class CustomTax implements Contract
{
    public function calculate(LineItem $model): float
    {
        return $model->getPrice() * ($model instanceof Shipping ? 0.3 : 0.27);
    }
}

Tax::register('complex-tax', CustomTax::class);
// or
Tax::register('complex-tax', new CustomTax);

You may remove registered taxes using the Tax facade.

use Cone\Bazar\Support\Facades\Tax;

Tax::remove('complex-tax');

You may disable tax calculation globally in some scenarios. To do so, call the disable method on the Tax facade.

use Cone\Bazar\Support\Facades\Tax;

Tax::disable();

Bazar comes with flexible discount support by default. You can easily manage discount definitions by using the Bazar\Support\Facades\Discount facade.

Discounts are stored on the Item and the Shipping models. Both implement the Discountable interface, which enforces to use of a unified method signature for calculating discounts.

You may register discounts using the Discount facade. You can pass a number, a Closure, or a class (that implements the Bazar\Contracts\Discount interface) along with the name of the discount.

use Cone\Bazar\Support\Facades\Discount;

// Fix discount
Discount::register('fix-20', 20);

// Custom closure discount
use Cone\Bazar\Support\Facades\Discount;

Discount::register('custom-percent', function (Discountable $model) {
    return $model->getTotal() * 0.3;
});

// Class discount
use Cone\Bazar\Contracts\Discount as Contract;
use Cone\Bazar\Contracts\Discountable;
use Cone\Bazar\Support\Facades\Discount;

class CustomDiscount implements Contract
{
    public function calculate(Discountable $model): float
    {
        return $model->getTotal() * 0.3;
    }
}

Discount::register('complex-discount', CustomDiscount::class);
// or
Discount::register('complex-discount', new CustomDiscount);

You may remove registered discounts using the Discount facade.

use Cone\Bazar\Support\Facades\Discount;

Discount::remove('complex-discount');

You may disable discount calculation globally in some scenarios. To do so, call the disable method on the Discount facade.

use Cone\Bazar\Support\Facades\Discount;

Discount::disable();