mihakot/laravel-tags

Add tags to your Laravel app models

1.2.47 2025-02-15 15:21 UTC

Requires

• php: ^8.1
• laravel/framework: ^9.0 || ^10.0
• spatie/laravel-package-tools: ^1.16.0

Requires (Dev)

• orchestra/testbench: ^6.13 || ^7.0
• phpunit/phpunit: ^9.5.2

MIT

• Konstantin <MihaKot> Aksarin

• tags
• laravel
• laravel-tags
• mihakot

README

Installation

You can install the package via composer:

composer require mihakot/laravel-tags

Publish provider config

artisan vendor:publish --provider=Mihakot\Tags\TagsServiceProvider

Usage

Here are some code examples:

// apply HasTags trait to a model
use Illuminate\Database\Eloquent\Model;
use Mihakot\Tags\HasTags;

class ArticleItem extends Model
{
    use HasTags;
    
    // ...
}

// Create a model with tags
$articleItem = ArticleItem::create([
   'name' => 'The Article Title',
   'tags' => ['first tag', 'second tag'], //tags will be created if they don't exist
]);

// Attaching tags
$articleItem->attachTag('third tag');
$articleItem->attachTag('third tag','some_type');
$articleItem->attachTags(['fourth tag', 'fifth tag']);
$articleItem->attachTags(['fourth_tag','fifth_tag'],'some_type');

// Detaching tags
$articleItem->detachTags('third tag');
$articleItem->detachTags('third tag','some_type');
$articleItem->detachTags(['fourth tag', 'fifth tag']);
$articleItem->detachTags(['fourth tag', 'fifth tag'],'some_type');

// Get all tags of a model
$articleItem->tags;

// Syncing tags
$articleItem->syncTags(['first tag', 'second tag']); // all other tags on this model will be detached

// Retrieving models that have any of the given tags
ArticleItem::withAnyTags(['first tag', 'second tag'])->get();

// Retrieve models that have all of the given tags
ArticleItem::withAllTags(['first tag', 'second tag'])->get();

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Konstantin "MihaKot" Aksarin

License

The MIT License (MIT). Please see License File for more information.

Keywords

laravel, tags