#[AsTaxonomy]

Register a class as a custom WordPress taxonomy.

Signature

#[Attribute(Attribute::TARGET_CLASS)]
final readonly class AsTaxonomy
{
    public function __construct(
        public string $name,
        public array $postTypes = [],
        public ?string $singular = null,
        public ?string $plural = null,
        public bool $public = true,
        public bool $hierarchical = false,
        public bool $showInRest = true,
        public bool $showAdminColumn = true,
        public ?string $rewriteSlug = null,
    ) {}
}

Parameters

Parameter	Type	Default	Description
name	string	—	Taxonomy slug (required)
postTypes	string[]	[]	Associated post type slugs
singular	?string	null	Singular label
plural	?string	null	Plural label
public	bool	true	Whether publicly visible
hierarchical	bool	false	Hierarchical like categories
showInRest	bool	true	Enable REST API and Gutenberg
showAdminColumn	bool	true	Show column in admin post list
rewriteSlug	?string	null	Custom URL slug

Usage

Basic Taxonomy

<?php

namespace App\Models;

use Studiometa\Foehn\Attributes\AsTaxonomy;

#[AsTaxonomy(
    name: 'product_category',
    postTypes: ['product'],
    singular: 'Category',
    plural: 'Categories',
    hierarchical: true,
)]
final class ProductCategory {}

Tag-style Taxonomy

#[AsTaxonomy(
    name: 'product_tag',
    postTypes: ['product'],
    singular: 'Tag',
    plural: 'Tags',
    hierarchical: false,
)]
final class ProductTag {}

Shared Taxonomy

#[AsTaxonomy(
    name: 'location',
    postTypes: ['event', 'team', 'office'],
    singular: 'Location',
    plural: 'Locations',
)]
final class Location {}

With Advanced Configuration

Implement ConfiguresTaxonomy for full control:

<?php

namespace App\Models;

use Studiometa\Foehn\Attributes\AsTaxonomy;
use Studiometa\Foehn\Contracts\ConfiguresTaxonomy;

#[AsTaxonomy(
    name: 'skill',
    postTypes: ['team'],
    singular: 'Skill',
    plural: 'Skills',
)]
final class Skill implements ConfiguresTaxonomy
{
    public static function taxonomyArgs(array $args): array
    {
        $args['capabilities'] = [
            'manage_terms' => 'manage_skills',
            'edit_terms' => 'edit_skills',
            'delete_terms' => 'delete_skills',
            'assign_terms' => 'assign_skills',
        ];

        return $args;
    }
}

Related

• Guide: Taxonomies
• #[AsPostType]