PHPackages melsaka/categorist - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. melsaka/categorist ActiveLibrary[Utility & Helpers](/categories/utility) melsaka/categorist ================== Implementing Categories system for Laravel's Eloquent models. 11PHP Since Sep 16Pushed 2y ago1 watchersCompare [ Source](https://github.com/melsaka/categorist)[ Packagist](https://packagist.org/packages/melsaka/categorist)[ RSS](/packages/melsaka-categorist/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Categorist ========== [](#categorist) Categorist is a laravel package designed to handle hierarchical categorization for various models within your application. It allows you to organize your data into categories and provides an easy-to-use interface to perform operations like adding, editing, and querying categories. Installation ------------ [](#installation) Add the package to your Laravel app via Composer: ``` composer require melsaka/categorist ``` Register the package's service provider in config/app.php. ``` 'providers' => [ ... Melsaka\Categorist\CategoristServiceProvider::class, ... ]; ``` Run the migrations to add the required table to your database: ``` php artisan migrate ``` Add `Categorized` trait to the model that you want categorize: ``` use Melsaka\Categorist\Categorized; class Post extends Model { use Categorized; // ... } ``` Configuration ------------- [](#configuration) To configure the package, publish its configuration file: ``` php artisan vendor:publish --tag=categorist ``` You can then modify the configuration file to change the categories table name if you want, default: `categories`. Usage ----- [](#usage) ### Adding a New Category [](#adding-a-new-category) You can add a new category for a specific model, such as **Post**, by using the `Category::add()` method. If a category with the same **slug** and **type** already exists, it will be **returned** instead. Here's an example: ``` use Melsaka\Categorist\Models\Category; $data = [ 'name' => 'Foo', 'slug' => 'foo', 'children' => [ [ 'name' => 'Bar', 'slug' => 'bar', 'children' => [ [ 'name' => 'Baz', 'slug' => 'baz', ], ], ], ], ]; $category = Category::add(Post::class, $data); ``` If you don't want the existed record to be returned: ``` $category = Category::add(Post::class, $data, false); // will throw duplicate entry error if record exists ``` ### Retrieving Models Related to a Category [](#retrieving-models-related-to-a-category) You can retrieve all models related to a specific category using the `categorized()` method: ``` $posts = $category->categorized(); ``` ### Checking if a Category is Newly Added [](#checking-if-a-category-is-newly-added) You can check whether a category is newly added or if it already existed and was returned using the `isNew()` method: ``` $isNew = Category::isNew($category); ``` ### Editing a Category [](#editing-a-category) To edit a category, use the `Category::edit()` method. Pass the category instance and an array of data to update: ``` use Melsaka\Categorist\Models\Category; $data = [ 'name' => 'New Category Name', ]; Category::edit($category, $data); ``` ### Removing a Category [](#removing-a-category) You can remove a category using the `Category::remove()` method. Pass either a category instance or its ID: ``` Category::remove($category); ``` ### Synchronizing Categories with a Model [](#synchronizing-categories-with-a-model) To synchronize categories with a model, you can use the `Category::syncWith()` method. This associates a category with a model: ``` Category::syncWith($post, $category); ``` ### Checking if a Model has a Category [](#checking-if-a-model-has-a-category) You can check whether a model has a specific category using the `Category::has()` method: ``` $hasCategory = Category::has($post, $category); ``` ### Listing Categories [](#listing-categories) To list all categories of a specific type, you can use the `Category::list()` method: ``` $categories = Category::list(Post::class); ``` ### Retrieving a Category Tree [](#retrieving-a-category-tree) To retrieve a hierarchical list of all categories for a specific type, you can use the `Category::treeList()` method: ``` $categoryTree = Category::treeList(Post::class); ``` ### Working with Model Relationships [](#working-with-model-relationships) You can retrieve categories associated with a model using Eloquent relationships. For example, to retrieve categories for a `Post` model: ``` $postWithcategories = Post::with('categories')->get(); // or retrieve only the categories $postCategories = $post->categories; $postCategories = Category::ofThis($post); $firstCategory = $post->firstCategory(); ``` To retrieve the parent categories of a model, you can use the `parentCategories()` method: ``` $parentCategories = $post->parentCategories(); ``` To retrieve a hierarchical list of categories associated with a model, you can use the `treeCategories()` method: ``` $treeCategories = $post->treeCategories(); ``` You can retrieve a list of category names associated with a model using the `categoriesList()` method: ``` $categoryNames = $post->categoriesList(); ``` You can `attach`, `detach`, or `sync` multiple categories to a model using the following methods: ``` // Attach categories to a model $post->attachCategories($category); // Detach categories from a model $post->detachCategories($category); // Sync categories with a model $post->syncCategories($category); // Check if a model has specific categories $post->hasCategories($cat, $category); // Check if a model has all of the specified categories $post->hasAllCategories($cat, $category); ``` ### Additional Methods [](#additional-methods) You can also retrieve related data using additional methods: ``` // Retrieve all models related to a category $posts = $category->categorized()->get(); // Retrieve the parent of a category $parent = Category::with('parent')->get(); // Retrieve the children of a category $children = Category::with('children')->get(); // Retrieve the ancestors of a category $ancestors = Category::with('ancestors')->get(); // Retrieve the descendants of a category $descendants = Category::with('descendants')->get(); ``` **Note**: Check [**Nested Sets**](https://github.com/lazychaser/laravel-nestedset) package for **more methods** and **details**. License ------- [](#license) This package is released under the MIT license (MIT). ### Health Score 13 — LowBetter than 1% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity3 Limited adoption so far Community7 Small or concentrated contributor base Maturity21 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/6c7cf52b7cdfb096062f2e3862d4d8f45f9b8b5af8bc8d06e5ed74dcb5316682?d=identicon)[melsaka](/maintainers/melsaka) --- Top Contributors [![melsaka](https://avatars.githubusercontent.com/u/16939366?v=4)](https://github.com/melsaka "melsaka (3 commits)") ### Embed Badge ![Health badge](/badges/melsaka-categorist/health.svg) ``` [![Health](https://phpackages.com/badges/melsaka-categorist/health.svg)](https://phpackages.com/packages/melsaka-categorist) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)