README

此包不打算以任何方式处理JavaScript或HTML。此包仅处理数据库存储和读写。

标签中可用的字符没有实际限制。它使用slug转换来决定两个标签是否相同（"sugar-free" 和 "Sugar Free" 将被视为相同的标签）。标签显示名称将通过 Str::title() 处理

Composer 安装（适用于Laravel 5+/Lumen 5）

composer require softtechnoes/laravel-tagging "~3.2"

安装并运行迁移

当您使用composer update时，包应自动发现。然后发布tagging.php，并使用以下命令运行数据库迁移。

php artisan vendor:publish --provider="Conner\Tagging\Providers\TaggingServiceProvider"
php artisan migrate

设置您的模型

class Article extends \Illuminate\Database\Eloquent\Model
{
	use \Conner\Tagging\Taggable;
}

快速示例使用

$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