README

Tenant-aware product management for Vendra applications.

Features

Product categories
Products
Product prices per currency
Filament resources on the admin panel

Requirements

PHP 8.3+
Laravel 13
Filament 5
Livewire 4
Pest 4
Tailwind CSS 4
misaf/vendra-support
misaf/vendra-multimedia

Optional:

misaf/vendra-attribute — enables reusable product attributes and values through the shared support resolver
misaf/vendra-currency — enables management of the active currencies used by pricing forms and demo seeders
misaf/vendra-tagger — enables assigning product-typed tags through the shared support resolver

Installation

composer require misaf/vendra-product
php artisan vendor:publish --tag=vendra-product-migrations
php artisan migrate

Optional configuration and translations:

php artisan vendor:publish --tag=vendra-product-config
php artisan vendor:publish --tag=vendra-product-translations

The service provider and Filament plugin are auto-registered.

Usage

Create a category:

use Misaf\VendraProduct\Models\ProductCategory;

$category = ProductCategory::query()->create([
    'name' => ['en' => 'Beverages'],
    'description' => ['en' => 'Cold and hot drinks'],
    'slug' => ['en' => 'beverages'],
    'active' => true,
]);

Create a product:

use Misaf\VendraProduct\Models\Product;

$product = Product::query()->create([
    'product_category_id' => $category->id,
    'name' => ['en' => 'Orange Juice'],
    'description' => ['en' => 'Fresh and natural'],
    'slug' => ['en' => 'orange-juice'],
    'quantity' => 20,
    'stock_threshold' => 5,
    'in_stock' => true,
    'available_soon' => false,
]);

Add a price:

use Misaf\VendraProduct\Models\ProductPrice;

ProductPrice::query()->create([
    'product_id' => $product->id,
    'currency_code' => 'USD',
    'price' => 9900,
]);

Load products with relationships:

$products = Product::query()
    ->with(['productCategory', 'latestProductPrice'])
    ->get();

Optional tags

Install misaf/vendra-tagger in the host application to enable the Tags tab and table column automatically. Product does not require or import Tagger or Spatie Tags; both packages communicate through the TagResolver contract in misaf/vendra-support.

Create tags with the reserved product type in the Tagger resource, then assign them from the product form:

use Misaf\VendraTagger\Models\Tagger;

$tag = Tagger::findOrCreate('Featured', type: 'product', locale: 'en');

$product->tags()->sync([$tag->getKey()]);

Without Tagger, Product continues working without tag queries or tag UI.

Filament

Resources are available in the shared Catalog cluster on the admin panel:

Product Categories
Products
Product Prices

Testing

Run the package checks from the package directory:

composer test
composer analyse

License

MIT. See LICENSE.

misaf / vendra-product

Maintainers

Package info

Statistics

Security