ingenius/storefront

Ingenius Storefront Package

1.1.2 2025-10-07 18:11 UTC

Requires

• php: ^8.2
• ingenius/core: *

Requires (Dev)

• orchestra/testbench: ^9.0
• phpunit/phpunit: ^11.0

MIT

• Ingenius Team

README

A Laravel package for storefront functionality in the Ingenius ecosystem.

Installation

You can install the package via composer:

composer require ingenius/storefront

Configuration

Publish the configuration file:

php artisan vendor:publish --tag=storefront-config

Environment Variables

PRODUCT_MODEL=Ingenius\Products\Models\Product

Note: For backward compatibility, STOREFRONT_PRODUCT_MODEL is still supported but PRODUCT_MODEL is preferred as it's used across all packages.

Usage

Routes

The package registers the following tenant routes:

Route::middleware(['api'])->prefix('api')->group(function () {
    Route::prefix('shop')->group(function () {
        Route::get('products', [StorefrontController::class, 'products'])->name('shop.products');
    });
});

Product Listing

The package provides functionality to list products for a storefront:

use Ingenius\Storefront\Actions\ListShopProductsAction;

$products = app(ListShopProductsAction::class)->handle([
    'category_id' => 1,
    'search' => 'keyword',
    'sort' => 'created_at',
    'order' => 'desc',
    'per_page' => 20,
]);

License

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