WP_Query パラメーターupdate_menu_item_cache

どういう時に使うか

nav_menu_item を取得し、そのリンク先オブジェクトや関連タームを後続処理で読む場面に向く引数です。

既定値は false です。通常投稿だけを取得するクエリで有効化しても、狙った改善にはつながりません。

WordPress 6.1 未満をサポートするコードでは引数の導入時期を確認し、対応バージョンを明記します。

近い引数との違い

update_post_meta_cache と update_post_term_cache は取得した投稿のメタやターム情報を扱います。update_menu_item_cache はメニュー項目の参照先に必要なキャッシュをまとめて用意します。

名前が似ていても対象が限定的です。3つを一括で同じ値にする理由はありません。

Builderでの扱い

WP Query Builder では指定できますが、post_type=nav_menu_item など用途が見える時だけ候補として案内します。

WordPress 6.1以上という前提を出力コードの互換性表示にも反映します。

使いどころ・避けどころと実践確認

取得投稿がナビゲーションメニュー項目を含み、関連オブジェクトの先読み効果を計測する時に検討します。

通常投稿の一覧を速くする一般的な設定として、用途を確認せず切り替えません。

WordPress 6.1以降の引数であり、メニュー項目を実際に使わないクエリでは効果と必要性が異なります。

通常投稿の一覧ではなく、取得対象がメニュー項目の時にだけ効果を検討する限定的な引数です。

メニュー項目を読む処理と読まない処理で、対応バージョン、データベース問い合わせ回数、キャッシュ状態を指定前後に比較します。

実践記事で確認WP_Queryの基本構文と$argsの書き方

基本の取得とループを固定してから、メニュー項目キャッシュだけの効果を測る土台にできます。

記事を読む →

WordPressの仕様で確認するポイント

公式の WP_Query::parse_query() 変更履歴で6.1追加を確認できます。

WP_Query の実装では、取得結果があり、この値が有効な時に update_menu_item_cache() が呼ばれる流れを確認できます。

最後は、値を変える目的と、変えた時に失う情報を一緒に確認します。