この記事は最後に更新してから1年以上経過しています。

wp_list_categories関数を使っているなら要確認

説明

WordPress 6.1のリリースに向け、昨日はBeta 2が公開された。6.1には新テーマ「Twenty Twenty-Three」が組み込まれるなど、気になるところが盛りだくさん。ここではそんな6.1(Beta 2)のソースコードを眺めていて個人的に気になったところを紹介する。

カテゴリーリストを表示する wp_list_categories関数

wp_list_categories関数はカテゴリーアーカイブページへ切り替えるカテゴリーリストを表示するもの。少し古めのテーマではよく使用されていた印象がある。この関数について6.1 Beta 1/2では次のようなコメントが追加され、use_desc_for_titleパラメータが省略された場合、適用される値が1から0に変更されるようだ。

 * @since 6.1.0 Default value of the 'use_desc_for_title' argument was changed from 1 to 0.

このことがどのような影響があるのか、6.1 Beta 2環境で試してみる。

wp_list_categories();

これで実際に出力された内容は次の通り。

<li class="categories">カテゴリー<ul>	<li class="cat-item cat-item-2"><a href="http://localhost/?cat=2">ニュース</a>
</li>
	<li class="cat-item cat-item-1"><a href="http://localhost/?cat=1">未分類</a>
</li>
</ul></li>

今度はuse_desc_for_titleパラメータに1を指定し、現在の6.0.x環境と比較してみる。

wp_list_categories( [ 'use_desc_for_title' => 1 ] );

これで実際に出力された内容は次の通りで、a要素にtitle属性が出力されている。

<li class="categories">カテゴリー<ul>	<li class="cat-item cat-item-2"><a href="http://localhost/?cat=2" title="これはニュースです。">ニュース</a>
</li>
	<li class="cat-item cat-item-1"><a href="http://localhost/?cat=1" title="これは分類されていません。">未分類</a>
</li>
</ul></li>

title属性の内容は、通常なら各カテゴリーの「説明」に記述された内容となる。「説明」に何も記述していない場合にはtitle属性そのものが出力されない。

現在使用しているテーマやプラグインでwp_list_categories関数を使用し、use_desc_for_titleパラメータを指定していない場合、6.1へアップデートした際にtitle属性が出力されない可能性がある。6.1の正式リリースまで時間的に余裕があるので、事前に確認しておきたい。


最終更新 : 2022年11月07日 10:16


お勧め

wp_save_post_revision(2024年1月10日 更新)

int | WP_Error | void wp_save_post_revision( int $post_id )
現状の投稿のリビジョンを作成する。

get_the_author_posts_link(2019年8月21日 更新)

string get_the_author_posts_link( )
投稿者アーカイブページのリンクを取得する。

get_year_link(2012年2月2日 更新)

string get_year_link( mixed $year )
年アーカイブのURLを取得する。

register_taxonomy(2022年6月1日 更新)

WP_Taxonomy | WP_Error register_taxonomy( string $taxonomy, array | string $object_type, array | string $args = array() )
タクソノミーを登録する。

wp_add_object_terms(2013年8月6日 更新)

mixed wp_add_object_terms( int $object_id, mixed $terms, mixed $taxonomy )
投稿情報などにタクソノミーを追加する。