Definície slugov

Prepíšte slugOptions() a deklarujte jeden alebo viac slugových stĺpcov. Každá SlugDefinition je fluentný builder; každá nenastavená voľba preberie predvolenú hodnotu z konfigurácie:

use RoundlyConsulting\Sluggable\Definitions\SlugDefinition;
use RoundlyConsulting\Sluggable\Definitions\SlugOptions;
use RoundlyConsulting\Sluggable\Enums\UpdatePolicy;

public function slugOptions(): SlugOptions
{
    return SlugOptions::make(
        SlugDefinition::for('slug')
            ->from('name')
            ->uniqueWithin('clinic_id')
            ->onUpdate(UpdatePolicy::WhenSourceChanges)
            ->keepHistory()
            ->routeKey(),
        SlugDefinition::for('handle')
            ->from(['brand.name', 'name'])       // relation dot path + attribute
            ->separator('_')
            ->maxLength(40)
            ->immutable(),
        SlugDefinition::for('code')
            ->from(fn (Product $product, ?string $locale): string => $product->sku)
            ->lowercase(false)
            ->notUnique(),
    );
}

Definície sa spracúvajú v poradí deklarácie, takže neskorší stĺpec môže ako zdroj použiť skorší slug. Najviac jedna definícia môže byť routeKey(); duplicitné stĺpce alebo viac route kľúčov vyhodia InvalidSlugDefinitionException.

Zdroje

from() prijíma názov atribútu, zoznam atribútov, bodkové cesty cez relácie (načítané cez loadMissing(), takže preventLazyLoading() neprotestuje) alebo closure fn (Model $m, ?string $locale): ?string. Skalárne atribúty sa čítajú cez getAttribute(), takže sa uplatnia accessory aj casty a enumy použijú svoju hodnotu. Chýbajúca relácia neprispeje ničím.

Všetky voľby

Settery s closure sú generické, takže typované closures ako ->lockWhen(fn (Post $post): bool => $post->is_published) prejdú vo vašom kóde cez Larastan na úrovni 7.

Zápis atribútmi

Pre podmnožinu bez closures deklarujte stĺpce ako opakovateľné atribúty triedy #[Slug]:

use RoundlyConsulting\Sluggable\Attributes\Slug;

#[Slug('slug', from: 'name', uniqueWithin: ['kind_id'], routeKey: true)]
#[Slug('short', from: ['kind.name', 'name'], maxLength: 40, onUpdate: UpdatePolicy::Never)]
final class Breed extends Model implements Sluggable
{
    use HasSlug;
}

Atribút prijíma column, from, separator, maxLength, maxWords, language, unicode, lowercase, uniqueness, uniqueWithin, includeTrashed, localeUniqueness, onUpdate, manual, emptySource, suffix, suffixStart, randomLength, storage, locales, fallback, routeKey, bindByKeyFallback, keepHistory, redirectFromHistory a reserved. SuffixStrategy::Custom sa atribútom vyjadriť nedá.

Poradie prednosti

• Prepísaná metóda slugOptions() na modeli — má vždy prednosť.
• Atribúty triedy #[Slug] — zdedia sa z rodičovskej triedy, ak potomok žiadne nedeklaruje.
• SlugOptions::defaults() — jedna definícia: defaults.column generovaný z defaults.source.

Súčasná deklarácia atribútov a prepísanie slugOptions() vyhodí v prostrediach local a testing výnimku conflictingSources.