Installation

Require the package, then publish and run its migrations. The service provider is auto-discovered — no manual registration:

composer require roundly-consulting/shops-for-laravel

php artisan vendor:publish --tag="shops-migrations"
php artisan migrate

Migrations are publish-only — the package never loads them itself, so publishing is a required step, not an optional one. The fourteen files publish in dependency order (shops → products → variants → carts → orders), so a single migrate applies them cleanly. Republishing overwrites the same files instead of duplicating them.

Provider packages’ migrations

Shops builds on sibling Roundly packages that Composer installs automatically. Six of them ship their own tables — publish each one before migrating:

php artisan vendor:publish --tag="media-migrations"
php artisan vendor:publish --tag="reviews-migrations"
php artisan vendor:publish --tag="attributes-migrations"
php artisan vendor:publish --tag="coupons-migrations"
php artisan vendor:publish --tag="credits-migrations"
php artisan vendor:publish --tag="addresses-migrations"
php artisan migrate

Sluggable’s only migration (sluggable-migrations, the slug_history table) is needed just when you turn on shops.slugs.history.

Decide before migrating

• shops.key_type — bigint, uuid or ulid for the polymorphic orders.customer, carts.owner and stock_adjustments.reference columns. Match the key type of your user model; it is fixed once the migrations run.
• sluggable.locales.supported — the shops, products and categories migrations create one unique slug index per supported locale. It defaults to app.locale plus app.fallback_locale.

# .env — fixed once the migrations have run
SHOPS_KEY_TYPE=ulid   # bigint (default) | uuid | ulid

// config/sluggable.php — one unique slug index is created per supported locale
'locales' => [
    'supported' => ['en', 'sk'],   // null = app.locale + app.fallback_locale
],

Configuration file

The config file is optional — every key has a default and the common ones are env-backed. Publish it only to override:

php artisan vendor:publish --tag="shops-config"

The package exposes two publish tags: shops-migrations and shops-config.

What comes with it

These Roundly packages are hard dependencies and power specific parts of the shop:

What the provider registers

• Merges config/shops.php, registers ShopsManager (the Shops facade root) as a singleton and CurrentShop as a scoped binding — reset per request and per queued job. The global Shops alias comes from the package’s composer.json.
• Binds six drivers from config — NumberGenerator, TaxResolver, PaymentGateway, ShippingMethod, DiscountResolver and VerifiedPurchaseResolver.
• Registers the morphKey Blueprint macro the orders, carts and stock-adjustment migrations use.
• Registers every shops.attributes.definitions entry in the attributes registry.
• Listens for OrderRefunded with GrantStoreCreditOnRefund.
• Adds a Shops section to php artisan about.

php artisan about --only=shops

The about section reports the shop and coupon models, currency, price type, tax resolver and tax-class count, payment gateway, store credit, shipping method, discount resolver, order numbers, low-stock threshold, attribute count, catalog media, verified purchases, fallback locale and slug history. Configured classes show by base name only; tax-class names, attribute names, the store-credit bucket and the media disk are never printed.