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


お勧め

home_url(2023年3月31日 更新)

string home_url( [ string $path = '' [ , string $scheme = null ] ] )
現在のブログ(サイト)のホームURLを取得する。ホームURLは、管理者ページの「設定」-「一般」の「サイトのアドレス(URL)」のこと。

get_comment_meta(2014年3月9日 更新)

mixed get_comment_meta( int $comment_id [ , string $key = '' [ , bool $single = false ] ] )
コメントメタ情報の値を取得する。

wp_maybe_inline_styles(2025年12月4日 更新)

void wp_maybe_inline_styles()
CSSファイルの追加情報をインライン化する。

next_posts_link(2018年5月27日 更新)

void next_posts_link( [ string $label = 'Next Page &raquo;' [ , int $max_page = 0 ] ] )
カテゴリーやタグなどのアーカイブページにおいて、1ページの投稿件数以上の投稿があった場合に次ページへのリンクを表示する。

wp_lazy_loading_enabled(2023年8月11日 更新)

bool wp_lazy_loading_enabled( string $tag_name, string $context )
要素にloading属性を追加するか判定する。