mayoz/laravel-categorizable

Polymorphic categorizable for Laravel

Laravel Categorizable

, _(*1)

Easily add the ability to category your Eloquent models in Laravel 5., _(*2)

• Installation
• Configuration
• Usage
• Extending
• License

Installation

You can install the package via composer:, _(*3)

``` bash composer require mayoz/laravel-categorizable, <sub>(*4)</sub>

Register the service provider in your `config/app.php` configuration file:

```php
'providers' => [
    ...
    Mayoz\Categorizable\CategorizableServiceProvider::class,
    ...
];

You can publish the migration with:, <sub>(*5)</sub>

php artisan vendor:publish --provider="Mayoz\Categorizable\CategorizableServiceProvider" --tag="migrations"

The migration has been published you can create the categories and categorizable tables. You are feel free for added new fields that you need. After, run the migrations:, <sub>(*6)</sub>

php artisan migrate

Usage

Suppose, you have the Post model as follows:, <sub>(*7)</sub>

<?php

namespace App;

use Mayoz\Categorizable\Categorizable;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    use Categorizable;
}

Associate new categories for the Post model:, <sub>(*8)</sub>

$post = Post::find(1);

$post->categorize([1, 2, 3, 4, 5]);

return $post;

Now, the post model is associated with categories ids of 1, 2, 3, 4 and 5., <sub>(*9)</sub>

Remove the existing category association for the Post model:, <sub>(*10)</sub>

$post = Post::find(1);

$post->uncategorize([3, 5]);

return $post;

The post model is associated with categories ids of 1, 2 and 4., <sub>(*11)</sub>

Rearrange the category relationships for the Post model:, <sub>(*12)</sub>

$post = Post::find(1);

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

return $post;

The post model is associated with categories ids of 1 and 5., <sub>(*13)</sub>

Extending

I suggest, you always extend the Category model to define your relationships directly. Create you own Category model:, <sub>(*14)</sub>

<?php

namespace App;

use Mayoz\Categorizable\Category as BaseCategory;

class Category extends BaseCategory
{
    /**
     * Get all posts for the relation.
     *
     * @return \Illuminate\Database\Eloquent\Relations\MorphedByMany
     */
    public function posts()
    {
        return $this->categorized(Post::class);
    }
}

You publish the package config:, <sub>(*15)</sub>

php artisan vendor:publish --provider="Mayoz\Categorizable\CategorizableServiceProvider" --tag="config"

This is the contents of the published config file:, <sub>(*16)</sub>

<?php

return [

    /*
    |--------------------------------------------------------------------------
    | Model Namespace
    |--------------------------------------------------------------------------
    |
    | Change these values when you need to extend the default category model
    | or if the user model needs to be served in a different namespace.
    |
    */

    'category' => App\Category::class,

];

That is all. Now let's play for relationship query with the category., <sub>(*17)</sub>

/**
 * Respond the post
 *
 * @param  \App\Category  $category
 * @return \Illuminate\Http\Response
 */
public function index(Category $category)
{
    return $category->posts()->paginate(10);
}

If we did not extend the Category model, as had to use;, <sub>(*18)</sub>

/**
 * Respond the post
 *
 * @param  \App\Category  $category
 * @return \Illuminate\Http\Response
 */
public function index(Category $category)
{
    return $category->categorize(Post::class)->paginate(10);
}

License

This package is licensed under The MIT License (MIT)., <sub>(*19)</sub>