この記事は最後に更新してから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


お勧め

get_bookmark_field(2011年6月11日 更新)

mixed get_bookmark_field( string $field, int $bookmark [ , string $context = 'display' ] )
リンク情報の要素値を取得する。

remove_filter(2022年11月8日 更新)

bool remove_filter( $tag, mixed $function_to_remove [ , int $priority = 10 [ , int $accepted_args = 1 ] ] )
WordPressタグに登録されているフィルターを削除する。

get_user_locale(2023年3月30日 更新)

string get_user_locale( [ mixed $user_id = 0 ] )
ユーザの言語を取得する。

add_plugins_page(2022年6月27日 更新)

mixed add_plugins_page( string $page_title, string $menu_title, mixed string $capability, string $menu_slug [ , mixed $function = '' [, int $position = null ] ] )
プラグインメニューにサブメニューを登録する。

wp_list_bookmarks(2018年5月27日 更新)

string wp_list_bookmarks( [ mixed $args = '' ] )
ブックマーク(管理画面の「リンク」)をパラメータ$argsのecho値が1ならば表示する。echo値が0ならばその文字列を取得する。