WordPress 4.2以前

同じスラッグを持つ異なるタクソノミーの用語は、単一の用語IDを共有していました。たとえば、スラッグ「news」を持つタグとカテゴリは同じ用語IDを持っていました。

WordPress 4.2以降

4.2以降、これらの共有用語の1つが更新されると、それは分割されます：更新された用語には新しい用語IDが割り当てられます。

あなたにとっての意味は？

ほとんどの状況において、この更新はシームレスで問題ありませんでした。しかし、オプション、投稿メタ、ユーザーメタ、または他の場所に用語IDを保存するいくつかのプラグインやテーマは影響を受けた可能性があります。

分割の処理

WordPress 4.2には、プラグインやテーマの作者が移行を支援するための2つの異なるツールが含まれています。

split_shared_termフック

共有用語に新しい用語IDが割り当てられると、新しい split_shared_term アクションが発火します。

プラグインやテーマの作者がこのフックを活用して、保存された用語IDが更新されることを保証する方法のいくつかの例を示します。

オプションに保存された用語ID

あなたのプラグインが featured_tags というオプションを保存していて、それがホームページのフィーチャード投稿セクションのクエリパラメータとして機能する用語IDの配列（[4, 6, 10]）を含んでいるとしましょう。

この例では、split_shared_term アクションにフックし、更新された用語IDが配列に含まれているかどうかを確認し、必要に応じて更新します。 

  1. /**
  2.  * Update featured_tags option when a shared term gets split.
  3.  *
  4.  * @param int    $term_id          ID of the formerly shared term.
  5.  * @param int    $new_term_id      ID of the new term created for the $term_taxonomy_id.
  6.  * @param int    $term_taxonomy_id ID for the term_taxonomy row affected by the split.
  7.  * @param string $taxonomy         Taxonomy for the split term.
  8.  */
  9. function wporg_featured_tags_split( int $term_id, int $new_term_id, int $term_taxonomy_id, string $taxonomy ): void {
  10.     // we only care about tags, so we'll first verify that the taxonomy is post_tag.
  11.     if ( 'post_tag' === $taxonomy ) {
  13.         // get the currently featured tags.
  14.         $featured_tags = get_option( 'featured_tags' );
  16.         // if the updated term is in the array, note the array key.
  17.         $found_term = array_search( $term_id, $featured_tags, true );
  18.         if ( false !== $found_term ) {
  20.             // the updated term is a featured tag! replace it in the array, save the new array.
  21.             $featured_tags[ $found_term ] = $new_term_id;
  22.             update_option( 'featured_tags', $featured_tags );
  23.         }
  24.     }
  25. }
  26. add_action( 'split_shared_term', 'wporg_featured_tags_split', 10, 4 );

投稿メタに保存された用語ID

あなたのプラグインが特定のページに関連する投稿を表示するために、ページの投稿メタに用語IDを保存しているとしましょう。

この場合、get_posts() 関数を使用して、meta_key を持つページを取得し、分割された用語IDに一致する meta_value を更新する必要があります。 

  1. /**
  2.  * Update related posts term ID for pages
  3.  *
  4.  * @param int    $term_id          ID of the formerly shared term.
  5.  * @param int    $new_term_id      ID of the new term created for the $term_taxonomy_id.
  6.  * @param int    $term_taxonomy_id ID for the term_taxonomy row affected by the split.
  7.  * @param string $taxonomy         Taxonomy for the split term.
  8.  */
  9. function wporg_page_related_posts_split( int $term_id, int $new_term_id, int $term_taxonomy_id, string $taxonomy ): void {
  10.     // find all the pages where meta_value matches the old term ID.
  11.     $page_ids = get_posts(
  12.         array(
  13.             'post_type'  => 'page',
  14.             'fields'     => 'ids',
  15.             'meta_key'   => 'meta_key',
  16.             'meta_value' => $term_id,
  17.         )
  18.     );
  20.     // if such pages exist, update the term ID for each page.
  21.     if ( $page_ids ) {
  22.         foreach ( $page_ids as $id ) {
  23.             update_post_meta( $id, 'meta_key', $new_term_id, $term_id );
  24.         }
  25.     }
  26. }
  27. add_action( 'split_shared_term', 'wporg_page_related_posts_split', 10, 4 );

wp_get_split_term関数

split_shared_term フックを使用することは、用語IDの変更を処理するための推奨方法です。

ただし、用語が分割される際に、あなたのプラグインが split_shared_term アクションにフックする機会がない場合もあります。

WordPress 4.2は、分割されたタクソノミー用語に関する情報を保存し、開発者がこの情報を取得するのを助けるために wp_get_split_term() ユーティリティ関数を提供します。

上記のケースを考えてみてください。あなたのプラグインが featured_tags という名前のオプションに用語IDを保存している場合、これらのタグIDが分割されていないことを確認するために（おそらくプラグインの更新時に実行される）、これらのタグIDを検証する関数を構築したいかもしれません： 

  1. /**
  2.  * Retrieve information about split terms and udpates the featured_tags option with the new term IDs.
  3.  *
  4.  * @return void
  5.  */
  6. function wporg_featured_tags_check_split() {
  7.     $featured_tag_ids = get_option( 'featured_tags', array() );
  9.     // check to see whether any IDs correspond to post_tag terms that have been split.
  10.     foreach ( $featured_tag_ids as $index => $featured_tag_id ) {
  11.         $new_term_id = wp_get_split_term( $featured_tag_id, 'post_tag' );
  13.         if ( $new_term_id ) {
  14.             $featured_tag_ids[ $index ] = $new_term_id;
  15.         }
  16.     }
  18.     // save
  19.     update_option( 'featured_tags', $featured_tag_ids );
  20. }

wp_get_split_term() は2つのパラメータ、$old_term_id と $taxonomy を取り、整数を返します。

古い用語IDに関連するすべての分割された用語のリストを取得する必要がある場合は、タクソノミーに関係なく wp_get_split_terms() を使用してください。