wp_insert_term()


WordPressのwp_insert_term()関数は、分類法（タクソノミー）に新しい用語（ターム）を追加するために使用されます。

構文

wp_insert_term( string $term, string $taxonomy, array|string $args = array() );

引数の説明:

  • $term (string) — 新しいタームの名前。
  • $taxonomy (string) — タームを追加するタクソノミー名。
  • $args (array|string) — オプションの引数。タームスラッグや親タームなどを指定できます。

注意:

  • 指定したタクソノミーが存在しない場合、エラーが発生します。
  • すでに同じ名前のタームが存在する場合、エラーではなくそのタームIDが返されます。

例1: 新しいカテゴリを追加

wp_insert_term( '新しいカテゴリ', 'category' );

例2: タームスラッグを指定してタグを追加

wp_insert_term( '新しいタグ', 'post_tag', array( 'slug' => 'new-tag' ) );

例3: 親タームを指定してカスタムタクソノミーに追加

$parent_id = term_exists( '親ターム名', 'custom_taxonomy' );
wp_insert_term( '子ターム', 'custom_taxonomy', array( 'parent' => $parent_id['term_id'] ) );

例4: 複数のオプションを指定してタームを追加

wp_insert_term( '詳細付きターム', 'category', array( 'slug' => 'detailed-term', 'description' => 'このタームの説明です。' ) );

例5: エラーハンドリング付きでタームを追加

$result = wp_insert_term( 'エラーチェックターム', 'category' );
if ( is_wp_error( $result ) ) {
    echo 'エラー: ' . $result->get_error_message();
} else {
    echo 'タームが正常に追加されました。';
}

注意事項

  • タームを削除する場合はwp_delete_term()関数を使用してください。
  • タームが重複しないように、事前にterm_exists()を使用して確認することを推奨します。

関連機能：