wp_update_term()


WordPress関数wp_update_term()は、既存のタクソノミータームを更新するために使用されます。この関数を使用することで、タームの名前、スラッグ、説明、親タームなどを変更できます。

シンタックス

wp_update_term( int|string $term_id, string $taxonomy, array|string $args = array() );

引数の説明:

  • $term_id (int|string) — 更新するタームのIDまたはスラッグ。
  • $taxonomy (string) — タームが属するタクソノミーのスラッグ。
  • $args (array|string) — タームを更新するためのパラメータを含む配列または文字列。

引数$argsの主な要素:

  • 'name' (string) — 新しいターム名。
  • 'slug' (string) — 新しいスラッグ。
  • 'description' (string) — 新しい説明。
  • 'parent' (int) — 親タームのID。

例 1: ターム名の更新

タームの名前を「新しい名前」に変更します。

wp_update_term( get_term_by( 'slug', 'example-term', 'category' )->term_id, 'category', array( 'name' => '新しい名前' ) );

例 2: タームスラッグの更新

タームのスラッグを「new-slug」に変更します。

wp_update_term( get_term_by( 'name', '旧名', 'post_tag' )->term_id, 'post_tag', array( 'slug' => 'new-slug' ) );

例 3: タームの説明を追加

タームの説明を追加します。

wp_update_term( get_term_by( 'slug', 'example-tag', 'post_tag' )->term_id, 'post_tag', array( 'description' => '新しい説明' ) );

例 4: 親タームの変更

タームの親を特定のタームIDに設定します。

wp_update_term( get_term_by( 'name', 'サブカテゴリ', 'category' )->term_id, 'category', array( 'parent' => get_term_by( 'slug', 'parent-category', 'category' )->term_id ) );

例 5: 複数の属性を一度に更新

タームの名前、スラッグ、説明を同時に変更します。

wp_update_term( get_term_by( 'slug', 'example-term', 'category' )->term_id, 'category', array(
    'name' => '新しい名前',
    'slug' => 'new-slug',
    'description' => '説明を更新しました'
) );

注意事項

  • 無効な$term_idや$taxonomyを指定するとエラーが発生します。
  • 既存のスラッグや名前と競合するとエラーが発生します。
  • 更新後にタームデータを再確認してください。

関連機能：