PHPackages                             hamworks/wp-taxonomy - 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. hamworks/wp-taxonomy

ActiveLibrary[Utility & Helpers](/categories/utility)

hamworks/wp-taxonomy
====================

0.6.1(2y ago)43.7kGPL-2.0-or-laterPHP

Since Sep 1Pushed 10mo ago1 watchersCompare

[ Source](https://github.com/hamworks/wp-taxonomy)[ Packagist](https://packagist.org/packages/hamworks/wp-taxonomy)[ RSS](/packages/hamworks-wp-taxonomy/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (6)Dependencies (4)Versions (8)Used By (0)

hamworks/wp-taxonomy
====================

[](#hamworkswp-taxonomy)

WordPressのカスタムタクソノミーを簡単に作成するためのライブラリです。ビルダーパターンを使用して、タクソノミーの登録、初期タームの設定、管理画面との統合を簡単に行えます。

特徴
--

[](#特徴)

- **初期ターム設定**: タクソノミー登録時に自動でデフォルトタームを作成
- **管理画面統合**: 管理カラムとドロップダウンフィルターの自動サポート
- **REST API & GraphQL対応**: WordPress REST APIとGraphQL（WPGraphQL）の組み込みサポート
- **日本語ラベル**: 日本語対応のカスタマイズ可能なラベル
- **階層型タクソノミー**: 親子関係のあるタームをサポート

インストール
------

[](#インストール)

Composerを使用してインストール:

```
composer require hamworks/wp-taxonomy
```

基本的な使用方法
--------

[](#基本的な使用方法)

### シンプルなタクソノミーの作成

[](#シンプルなタクソノミーの作成)

```
$builder = new HAMWORKS\WP\Taxonomy\Builder( 'product-category', '商品カテゴリ', [ 'product' ] );
$builder->create();
```

### 詳細設定を含むタクソノミー

[](#詳細設定を含むタクソノミー)

```
$builder = new HAMWORKS\WP\Taxonomy\Builder( 'product-category', '商品カテゴリ', [ 'product' ] );
$builder->set_options([
    'public'            => true,
    'hierarchical'      => true,
    'show_ui'          => true,
    'show_admin_column' => true,
    'show_in_nav_menus' => true,
    'show_tagcloud'     => true,
    'description'       => '商品を整理するためのカテゴリ',
    'has_archive'       => true,
    'rewrite'          => [
        'slug'       => 'products/category',
        'with_front' => false,
    ],
]);
$builder->create();
```

初期タームの設定
--------

[](#初期タームの設定)

タクソノミー登録時にデフォルトのタームを自動作成できます：

```
$builder = new HAMWORKS\WP\Taxonomy\Builder( 'product-category', '商品カテゴリ', [ 'product' ] );

// シンプルなタームを作成
$electronics = new \HAMWORKS\WP\Taxonomy\Term( '家電', 'electronics' );
$clothing = new \HAMWORKS\WP\Taxonomy\Term( '衣類', 'clothing' );

$builder->set_initial_term( $electronics );
$builder->set_initial_term( $clothing );
$builder->create();
```

### メタデータ付きの階層型タームの作成

[](#メタデータ付きの階層型タームの作成)

```
$builder = new HAMWORKS\WP\Taxonomy\Builder( 'product-category', '商品カテゴリ', [ 'product' ] );

// 親カテゴリ
$electronics = new \HAMWORKS\WP\Taxonomy\Term(
    '家電',                    // 名前
    'electronics',            // スラッグ
    0,                        // 親（0はトップレベル）
    '家電製品のカテゴリ',       // 説明
    '',                       // エイリアス
    [                         // メタデータ
        'featured' => true,
        'color' => '#3498db'
    ]
);

// 子カテゴリ
$smartphones = new \HAMWORKS\WP\Taxonomy\Term(
    'スマートフォン',
    'smartphones',
    'electronics',            // 親スラッグ
    '携帯電話とアクセサリー',
    '',
    [
        'icon' => 'smartphone'
    ]
);

$builder->set_initial_term( $electronics );
$builder->set_initial_term( $smartphones );
$builder->create();
```

APIリファレンス
---------

[](#apiリファレンス)

### Builderクラス

[](#builderクラス)

#### コンストラクタ

[](#コンストラクタ)

```
new Builder( string $name, string $label, array|string $post_type = ['post'] )
```

- `$name`: タクソノミースラッグ（URLやデータベースで使用）**※単数形で指定してください**
- `$label`: 人が読める形のタクソノミー名
- `$post_type`: 関連付ける投稿タイプ

**注意**: `$name`パラメータは単数形で指定してください。ライブラリ内部で自動的に複数形に変換されます（例：`category` → `categories`）。

#### メソッド

[](#メソッド)

##### `set_options( array $args )`

[](#set_options-array-args-)

タクソノミー登録引数を設定。デフォルト値とマージされます。

**デフォルトオプション:**

```
[
    'show_in_rest'        => true,
    'show_in_graphql'     => true,
    'graphql_single_name' => $singular_slug,
    'graphql_plural_name' => $plural_slug,
    'rest_base'           => $plural_slug,
    'show_admin_column'   => true,
    'rewrite'             => [
        'with_front' => false,
        'slug'       => $singular_slug,
        'walk_dirs'  => false,
    ],
]
```

##### `set_labels( array $args )`

[](#set_labels-array-args-)

タクソノミーラベルをカスタマイズ。日本語デフォルトとマージされます。

##### `set_initial_term( Term $term )`

[](#set_initial_term-term-term-)

タクソノミー登録時に自動作成するタームを追加。

##### `create()`

[](#create)

タクソノミーを登録し、初期タームを作成。

##### `get_taxonomy()`

[](#get_taxonomy)

登録された `WP_Taxonomy` オブジェクトを返します。

### Termクラス

[](#termクラス)

#### コンストラクタ

[](#コンストラクタ-1)

```
new Term( string $name, string $slug = '', int|string $parent = 0, string $description = '', string $alias_of = '', array $meta = [] )
```

- `$name`: ターム表示名
- `$slug`: タームスラッグ（空の場合は名前から自動生成）
- `$parent`: 階層型タクソノミーの親タームIDまたはスラッグ
- `$description`: ターム説明
- `$alias_of`: 他のタームのエイリアス
- `$meta`: タームメタデータのキーバリュー配列

複数の投稿タイプ
--------

[](#複数の投稿タイプ)

```
$builder = new HAMWORKS\WP\Taxonomy\Builder(
    'topic',
    'トピック',
    [ 'post', 'page', 'custom_post_type' ]
);
$builder->create();
```

カスタムラベル
-------

[](#カスタムラベル)

```
$builder = new HAMWORKS\WP\Taxonomy\Builder( 'skill', 'スキル', [ 'employee' ] );
$builder->set_labels([
    'name'                => 'スキル',
    'singular_name'       => 'スキル',
    'search_items'        => 'スキルを検索',
    'popular_items'       => '人気のスキル',
    'all_items'          => '全てのスキル',
    'edit_item'          => 'スキルを編集',
    'update_item'        => 'スキルを更新',
    'add_new_item'       => '新しいスキルを追加',
    'new_item_name'      => '新しいスキル名',
    'menu_name'          => 'スキル',
]);
$builder->create();
```

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance39

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~195 days

Recently: every ~290 days

Total

7

Last Release

951d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b1738118b1515a2c312e90b71dc041a57a90db61144063f36de6b27587b507d6?d=identicon)[torounit](/maintainers/torounit)

![](https://avatars.githubusercontent.com/u/925303?v=4)[h2ham](/maintainers/h2ham)[@h2ham](https://github.com/h2ham)

![](https://avatars.githubusercontent.com/u/3461188?v=4)[Takenori Okashita (GOUTEN)](/maintainers/gouten5010)[@gouten5010](https://github.com/gouten5010)

---

Top Contributors

[![torounit](https://avatars.githubusercontent.com/u/1908815?v=4)](https://github.com/torounit "torounit (1 commits)")

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/hamworks-wp-taxonomy/health.svg)

```
[![Health](https://phpackages.com/badges/hamworks-wp-taxonomy/health.svg)](https://phpackages.com/packages/hamworks-wp-taxonomy)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.8k532.1M19.4k](/packages/laravel-framework)[illuminate/support

The Illuminate Support package.

582110.9M39.8k](/packages/illuminate-support)[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k116.2M674](/packages/symfony-maker-bundle)[api-platform/core

Build a fully-featured hypermedia or GraphQL API in minutes!

2.6k50.1M314](/packages/api-platform-core)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)[stoutlogic/acf-builder

An Advanced Custom Field Configuration Builder

8361.9M63](/packages/stoutlogic-acf-builder)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)