unisharp/categorizable

categorize model

Categorizable

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

It's a package to let you cagorize anything, _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require unisharp/categorizable, <sub>(*4)</sub>

## Usage

``` php
use UniSharp\Category\Categorizable;

class Post extends Model {
    use Categorizable;
}

categorize

You can categorize by id, name or mixed array and id won't add duplicate category, <sub>(*5)</sub>

``` php $post->categorize(1); // by category id, it will do nothing if it can't find this category, <sub>(*6)</sub>

$post->categorize("News"); // by category name and it will create new one if it can't find category, <sub>(*7)</sub>

$post->categorize([1, "news"]); // You can use array, <sub>(*8)</sub>

$post->categorize(1, "news"); // it's same as using array, <sub>(*9)</sub>

### uncategorize

It will remove category just like categorize

``` php
$post->uncategorize(1);

$post->uncategorize("News");

$post->uncategorize([1, "news"]);

$post->uncategorize(1, "news");

decategorize

remove all category, <sub>(*10)</sub>

$post->decategorize();

recategorize

it will add category after clean all binding categories, <sub>(*11)</sub>

same as $post->decategorize()->categorize(....), <sub>(*12)</sub>

$post->recategorize(1);

$post->recategorize("News");

$post->recategorize([1, "news"]);

$post->recategorize(1, "news");

hasCategories

You can find model which has specify categories it also search all children category, <sub>(*13)</sub>

Post::hasCategories('News', 1)->get();

hasStrictCategories

It's same as hasCategories but just find category which you specify, <sub>(*14)</sub>

Post::hasStrictCategories('News', 1)->get();

You can find model which has specify categories it also search all children category, <sub>(*15)</sub>

Post::hasCategories('News', 1)->get();

Change log

Please see CHANGELOG for more information on what has changed recently., <sub>(*16)</sub>

Testing

bash $ composer test, <sub>(*17)</sub>

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details., <sub>(*18)</sub>

Security

If you discover any security related issues, please email xing1615@gmail.com instead of using the issue tracker., <sub>(*19)</sub>

Credits

• Xing
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*20)</sub>