Taxonomy Repository

TaxonomyRepository wraps WordPress taxonomy functions for a specific taxonomy.

Creating a repository

php nikogin make:repository CategoryRepository --type=taxonomy

// app/Repository/Taxonomy/CategoryRepository.php
class CategoryRepository extends TaxonomyRepository
{
    public function __construct()
    {
        parent::__construct('category'); // or 'post_tag', 'product_cat', etc.
    }
}

Available methods

getAll

$terms = $repository->getAll();                         // all terms
$terms = $repository->getAll(['hide_empty' => true]);   // with overrides
// Returns WP_Term[]|WP_Error

getById / getBySlug / getByName

$term = $repository->getById(5);
$term = $repository->getBySlug('uncategorized');
$term = $repository->getByName('Uncategorized');

getChildren

$children = $repository->getChildren(5); // WP_Term[]|WP_Error

create / update / delete

$result = $repository->create('New Category', ['slug' => 'new-cat']);
$result = $repository->update(5, ['name' => 'Renamed']);
$result = $repository->delete(5);

count

$total = $repository->count(); // int

Post relationships

// Get terms attached to a post
$terms = $repository->getForPost(42);

// Append terms to a post (keeps existing)
$repository->attachToPost(42, [5, 6]);

// Replace all terms on a post
$repository->syncToPost(42, [7]);

// Remove specific terms from a post
$repository->detachFromPost(42, [5]);