ilbronza / products

v2.5.1 2026-08-07 12:29 UTC

MIT

• Davide Bronzini

• products
• laravel

Published on Packagist.org on 2026-08-07 15:26 UTC

README

SEO

Product includes ProductHasSeoTrait (Crud HasSeo). Defaults:

• title: title / name
• description: short_description → description → name
• URL: getPublicUrl($locale) when the model (or a subclass) exposes it

Open Graph defaults to article (switch to product when a public price exists) and, when media is present, uses the first catalog or cover image for og:image / Twitter card, including width, height and alt from the product name.

Enable admin SEO form integrations with products.seo.enabled (default false). Persist with SeoFormHelper::saveFromRequest($product, $request) or the Crud trait SavesSeoFromRequest. Requires the Crud crud_seo migration.

Suppliers Creation from Standard Models

This package now includes a helper feature that allows you to create Suppliers directly from existing Eloquent models.

How it works

Any Eloquent model can be converted into a Supplier by invoking the SupplierCreatorHelper.
The system will automatically generate the corresponding Supplier entry, linking it to the source model through its class name and primary key.

Example Usage

Notes

• If a Supplier for the given model already exists, the factory will return it instead of creating a duplicate.
• The Supplier inherits descriptive fields from the model whenever possible.
• This feature is intended to simplify the integration of existing domain models into the Products package.

Sellables Creation from Standard Models

This package now includes a helper feature that allows you to create Sellables directly from existing Eloquent models.

How it works

Any Eloquent model can be converted into a Sellable by invoking the SellableCreatorHelper.
The system will automatically generate the corresponding Sellable entry, linking it to the source model through its class name and primary key.

Example Usage

Notes

• If a Sellable for the given model already exists, the factory will return it instead of creating a duplicate.
• The Sellable inherits descriptive fields from the model whenever possible.
• This feature is intended to simplify the integration of existing domain models into the Products package.

Sellable prices creation from Target Model

call this route

app('products')->route('products.calculatePrices')

it will execute ProductCalculatePricesController@calculatePrices

class ProductCalculatePricesController extends ProductCRUD
{
    public $allowedMethods = ['calculatePrices'];

    public function calculatePrices()
    {
        $products = $this->getModelClass()::all();

        foreach($products as $product)
            cache()->remember(
                $product->cacheKey('calculatePricesByTarget'),
                3600,
                function() use ($product)
                {
                    return SellablePricesCreatorHelper::calculatePricesByTarget($product);
                }
            );

        return response()->json([
            'status' => 'ok'
        ]);
    }
}

SellablePricesCreatorHelper::calculatePricesByTarget takes the product, call $product->getPriceBaseAttributes() and populate all sellable prices.

for example if you declare getPriceBaseAttributes like this:

namespace App\Overrides\Models\Products;

class Product extends IbProduct implements WithPriceInterface
{
	public function getPriceBaseAttributes()
	{
		return [
			'company_cost' => $this->company_cost,
			'client_price' => $this->client_price,
		];
	}
}

product sellables will have a company_cost and a client_price