[doc] Using your own tag model

[francoism90]

I'm really confused about the doc explaining how to use an own Tag model.

// config/tags.php

return [
    /*
     * The fully qualified class name of the tag model.
     */
    'tag_model' => App\Models\Tag::class,
];

As you see, the tags.php config file already provides the key to overrule the tag model.

---

This is also confusing, why should you overwrite the tag model here?

public static function getTagClassName(): string
{
    return YourTagModel::class;
}

This is the default method that lives inside the HasTags trait:

public static function getTagClassName(): string
{
    return config('tags.tag_model', Tag::class);
}

This seems to be using the tag model configured in tags.php. I don't think it is necessary (or even wanted) to overrule getTagClassName()?

---

Then you need to override the tags() method from the same trait to tell Laravel that it still needs to look for tags_id column for tags relation instead of your_tag_model_id:

use Illuminate\Database\Eloquent\Relations\MorphToMany;

public function tags(): MorphToMany
{
    return $this
        ->morphToMany(self::getTagClassName(), 'taggable', 'taggables', null, 'tag_id')
        ->orderBy('order_column');
}

I don't think this is necessary either, as the default also points to the custom tag model.

---

Would this be the solution:

\\ App\Models\Tag.php

use Spatie\Tags\Tag as BaseTag;

class Tag extends BaseTag
{
}

And simple set 'tag_model' => App\Models\Tag::class?

Maybe I'm not understanding this correctly, but wasn't the model solution through the config/tags.php introduced not so long ago and this was before this solution?

Thanks!