rtconner / laravel-tagging
Use PHP traits to extend Laravel Eloquent Models to allow Tags. Models can be marked as Taggable.
Installs: 2 327 699
Dependents: 25
Suggesters: 0
Security: 0
Stars: 882
Watchers: 28
Forks: 168
Open Issues: 3
Requires
- php: ^7.3|^8.0
- illuminate/database: >=8.0
- illuminate/support: >=8.0
Requires (Dev)
- mockery/mockery: 1.*
- orchestra/testbench: 6.*
- phpunit/phpunit: 9.*
- squizlabs/php_codesniffer: 3.*
- dev-master
- dev-laravel-8
- dev-laravel-7
- 4.1.4
- 4.1.3
- 4.1.2
- 4.1.1
- 4.1.0
- 4.0.2
- 4.0.1
- 4.0.0
- 3.2.3
- 3.2.2
- 3.2.1
- 3.2.0
- 3.1.1
- 3.1.0
- 3.0.0
- 2.2.3
- 2.2.2
- 2.2.1
- 2.2.0
- 2.1.0
- 2.0.9
- 2.0.8
- 2.0.7
- 2.0.6
- 2.0.5
- 2.0.4
- 2.0.3
- 2.0.2
- 2.0.0
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.7
- 0.5.4
- 0.5.2
- 0.5.1
- 0.4.0
- 0.3.3
- 0.3.2
- 0.2.2
- 0.1.0
- dev-laravel-5
- dev-laravel-4
This package is auto-updated.
Last update: 2024-11-03 04:52:22 UTC
README
This package is not meant to handle javascript or html in any way. This package handles database storage and read/writes only.
There are no real limits on what characters can be used in a tag. It uses a slug transform to determine if two tags are identical ("sugar-free" and "Sugar Free" would be treated as the same tag). Tag display names are run through Str::title()
composer require rtconner/laravel-tagging
Install and then Run the migrations
The package should auto-discover when you composer update. Then publish the tagging.php and run the database migrations with these commands.
php artisan vendor:publish --provider="Conner\Tagging\Providers\TaggingServiceProvider"
php artisan migrate
Setup your models
class Article extends \Illuminate\Database\Eloquent\Model { use \Conner\Tagging\Taggable; }
Quick Sample Usage
$article = Article::with('tagged')->first(); // eager load foreach($article->tags as $tag) { echo $tag->name . ' with url slug of ' . $tag->slug; } $article->tag('Gardening'); // attach the tag $article->untag('Cooking'); // remove Cooking tag $article->untag(); // remove all tags $article->retag(array('Fruit', 'Fish')); // delete current tags and save new tags $article->tagNames(); // get array of related tag names Article::withAnyTag(['Gardening','Cooking'])->get(); // fetch articles with any tag listed Article::withAllTags(['Gardening', 'Cooking'])->get(); // only fetch articles with all the tags Article::withoutTags(['Gardening', 'Cooking'])->get(); // only fetch articles without all tags listed Conner\Tagging\Model\Tag::where('count', '>', 2)->get(); // return all tags used more than twice Article::existingTags(); // return collection of all existing tags on any articles
Documentation: More Usage Examples
Configure
See config/tagging.php for configuration options.
Lumen Installation
Credits
- Robert Conner - http://smartersoftware.net