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

5.5の機能強化：set_404メソッドの新アクション

（5.5.0以降）
プロパティを直接変更するのは止めないとね！

説明

「WordPress 5.5 RC 2（以降RC 2）」が公開され、今日・明日には正式版がリリースされる。そんなWordPress 5.5 RC 2のソースコードを眺めていると、WP_Queryクラスのset_404メソッドにアクションが追加されていた。

はじめに、この記事は公開された5.5 RC 2をもとにしており、正式リリースの際に変更される可能性があることを予めお断りする。

>WP_Queryクラスはユーザーからリクエストされたページ向けの投稿情報を取得する際に使用されている重要なクラスである。取得した投稿情報を保持するほか、リクエストされたページがどんなページなのかをプロパティとして保持している。今回の記事に関連するのはその中の1つis_404である。

プロパティのis_404には、該当する投稿情報が見つからなかった場合（キーワード検索時などは除く）にtrueが格納され、一般的には is_404関数を使用して状態を調べる。

そんなプロパティのis_404だが、グローバル変数$wp_query（WP_Queryオブジェクト）から直接読み取ることができるだけでなく、書き換えることも可能である。

global $wp_query;
$wp_query->is_404 = true;

このように直接書き換えることはあまり褒められたものではないが、手軽さもあってついついやってしまいがちである。では、どのようにすべきなのかというと、プロパティのis_404をtrueに変更する場合はWP_Queryクラスのset_404メソッドが適任である。

global $wp_query;
$wp_query->set_404();

5.5ではこのset_404メソッドにset_404アクションが追加された。

do_action_ref_array( 'set_404', array( $this ) );

このアクションはデバッグ目的で追加されたもので、パラメータは自身のWP_Queryオブジェクトとなっており、その時の状況を詳しく把握できる。

これは5.5の開発者向けの変更点の1つであり、いつか、こんな提案ができるようになりたいものだ。

最終更新 : 2020年08月12日 08:26

has_category（2012年1月17日更新）

bool has_category( [ mixed $category = '' [ , mixed $post = null ] ] )

投稿記事がカテゴリーに属しているか調べる。

comments_template（2018年5月27日更新）

void comments_template( string $file = '/comments.php' , bool $separate_comments = false )

投稿ページ（post）または単一ページ（page）のコメント情報を取得し、コメント表示・投稿用のテンプレートファイルを読み込んで表示する。

is_taxonomy_hierarchical（2018年5月27日更新）

bool is_taxonomy_hierarchical( string $taxonomy )

タクソノミーに階層（親子）関係があるか調べる。

void send_confirmation_on_profile_email()

メールアドレス変更を確認するメールを送信する。

get_the_modified_time（2023年9月20日更新）

string | int | false get_the_modified_time( [ string $format = '' [ , int | WP_Post $post = null ] ] )

パラメータ$formatで指定したフォーマットで投稿の更新時刻を取得する。