Slugy a URL

Slugy obchodov, produktov a kategórií zabezpečuje sluggable-for-laravel. Každý model ukladá jeden slug na jazyk do stĺpca slug a používa ho ako route key:

• Generujú sa pre každý jazyk z name: z Chair / Stolička vznikne chair / stolicka.
• Vynucuje ich databáza — migrácie pridajú jedinečný index pre každý podporovaný jazyk (pri produktoch a kategóriách v rámci shop_id), takže duplikát nevznikne ani pri súbehu či priamom inserte. Soft-deletnuté riadky si slug ponechajú, takže obnova nikdy nekoliduje.
• Ručne zadané slugy sa normalizujú a urobia jedinečnými; jazyk pridaný neskôr sa doplní pri ďalšom uložení; prázdny názov dostane náhodný slug.
• Route binding hľadá podľa jazyka requestu, potom shops.locales.fallback, potom v ľubovoľnom jazyku — na každom databázovom engine, vrátane routov v rámci tenanta.

Route::get('/shops/{shop}/products/{product}', ShowProduct::class)->scopeBindings();
// /shops/acme/products/chair — another shop's "chair" is a 404

Všetky čítacie metódy a scopes balíka sluggable sú dostupné na všetkých troch modeloch:

$product->currentSlug();   // "stolicka" under sk
$product->slugFor('en');   // "chair"
$product->slugMap();       // ['en' => 'chair', 'sk' => 'stolicka']

Product::query()->forShop($shop)->whereSlug('chair')->first();

SKU predvoleného variantu sa odvodzuje zo slugu v záložnom jazyku (CHAIR-DEFAULT), takže je rovnaké bez ohľadu na jazyk requestu, ktorý produkt vytvoril.

História slugov (voliteľná)

Zapnite slugs.history a publikujte migráciu balíka sluggable — obchod, produkt či kategória, ktorým sa zmení slug, budú na starú URL odpovedať presmerovaním 301 na novú. Premenovanie slug nemení: slug sa vygeneruje raz z prvého názvu, takže odkazy zostanú stabilné. Ak má URL nasledovať nový názov, nastavte nový slug sami ($product->setTranslation('slug', 'en', 'armchair')->save()) — so zapnutou históriou starý presmeruje:

# .env
SHOPS_SLUG_HISTORY=true

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

Aktualizácia existujúcej databázy

Databáza, ktorá spustila migrácie shops pred integráciou sluggable, ešte nemá indexy slugov. Pre každý model (Shops\Shop, Products\Product, Products\Category): nájdite duplikáty, pozrite si náhľad prepisu, aplikujte ho a potom pridajte indexy. Rovnako postupujete pri neskoršom pridaní jazyka:

php artisan sluggable:duplicates "RoundlyConsulting\Shops\Products\Product"
php artisan sluggable:regenerate "RoundlyConsulting\Shops\Products\Product" --mode=all --dry-run
php artisan sluggable:regenerate "RoundlyConsulting\Shops\Products\Product" --mode=all
php artisan sluggable:indexes "RoundlyConsulting\Shops\Products\Product"

# Adding a locale later:
php artisan sluggable:regenerate "RoundlyConsulting\Shops\Products\Product" --locale=de
php artisan sluggable:indexes "RoundlyConsulting\Shops\Products\Product"