itmosoft / laravel-product-bundles
Manage fixed-price and component-priced product bundles in Laravel applications.
Package info
github.com/ITMOSOFT/laravel-product-bundles
pkg:composer/itmosoft/laravel-product-bundles
Requires
- php: ^8.3
- illuminate/database: ^12.0|^13.0
- illuminate/support: ^12.0|^13.0
Requires (Dev)
- orchestra/testbench: ^10.0|^11.0
- phpunit/phpunit: ^11.0|^12.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Manage fixed-price and component-priced product bundles in Laravel applications.
Requirements
- PHP 8.3+
- Laravel 12 or 13
Installation
composer require itmosoft/laravel-product-bundles php artisan vendor:publish --tag=itmosoft-product-bundles-config php artisan migrate
Create a bundle
use ItmoSoft\ProductBundles\ProductBundleManager; $bundles = app(ProductBundleManager::class); $fixed = $bundles->createBundle([ 'name' => 'Starter Kit', 'description' => 'A curated starter package', 'pricing_type' => 'fixed', 'fixed_price' => '49.9500', 'currency' => 'USD', ]); $dynamic = $bundles->createBundle([ 'name' => 'Build Your Own Kit', 'pricing_type' => 'dynamic', 'currency' => 'USD', ]);
Add components
Components are any Eloquent model, including catalog products or product variants. The package stores a polymorphic reference and a unit-price snapshot.
$bundles->addComponent( $dynamic, $product, quantity: 2, unitPrice: '12.5000', position: 1, ); $price = $bundles->calculatePrice($dynamic);
Dynamic pricing is calculated from the stored component unit-price snapshots multiplied by their quantities. Refresh snapshots through your application when catalog prices change. The package does not assume a particular product schema or automatically fetch product prices.
Synchronize components
$bundles->syncComponents($dynamic, [ [ 'component' => $keyboard, 'quantity' => 1, 'unit_price' => '25.0000', 'position' => 1, ], [ 'component' => $mouse, 'quantity' => 2, 'unit_price' => '10.0000', 'position' => 2, ], ]);
Other operations
$bundles->removeComponent($dynamic, $mouse); $bundles->setActive($dynamic, false); $bundles->findBundle('starter-kit'); $bundles->activeBundles(); $bundles->deleteBundle($dynamic);
Database tables
Default tables:
itmosoft_product_bundlesitmosoft_product_bundle_items
Change the table_prefix in config/itmosoft-product-bundles.php before running migrations. Changing it after installation requires a corresponding database migration.
Integration boundaries
This package owns bundle definitions, component references, quantities, and bundle price calculation. It does not modify inventory, expand bundles into cart/order lines, reserve stock, or process payments. Integrate those workflows with laravel-inventory, laravel-cart, and laravel-orders in the host application.
Testing
composer install
composer test
License
MIT.