Taggable

Purpose

Adds lightweight JSON-array tagging behavior to a model.

Static Configuration

Default tag attribute:

protected static string $tagsAttribute = 'tags';

Override this property when the model stores tags in a different attribute.

Methods

scopeTagged(...)

scopeTagged($query, array|string|null $tags)

Behavior:

• filters rows whose JSON tag array contains one or more tags

tags()

public static function tags(): array

Behavior:

• returns all distinct tags from all records
• result is formatted as key/value pairs

attachTag(...)

attachTag(string ...$tags): void

Behavior:

• merges new tags into the existing tag set

detachTag(...)

detachTag(string ...$tags): void

Behavior:

• removes one or more tags

syncTags(...)

syncTags(?array $tags): void

Behavior:

• overwrites the stored tag set and saves the model