WP_Query パラメーターlazy_load_term_meta

どういう時に使うか

ターム画像や色などのタームメタを一覧内で読む時に関係します。タームメタを使わないサイトでは、意識する場面は多くありません。

この値は update_post_term_cache の設定とも関係します。片方だけを見て性能判断をしないようにします。

実際に効いているかは、タームメタを読む一覧と読まない一覧でクエリ数を比べます。

近い引数との違い

update_post_term_cache は投稿に紐づくターム情報の先読み、lazy_load_term_meta はそのタームに付いたメタ情報の遅延読み込みです。

投稿メタを扱う update_post_meta_cache とは保存先が違います。投稿のカスタムフィールドとタームの追加情報を混同しません。

Builderでの扱い

WP Query Builder では直接指定できますが、タームメタを使う実装か分からない段階では既定値を保ちます。

性能系の詳細設定として折りたたみ、通常の絞り込み項目より前に出さない方が初心者には扱いやすくなります。

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

タームメタの遅延読み込み方針を、実際の参照回数とキャッシュ構成に基づいて調整する時だけ検討します。

タームメタを読むか分からない通常一覧で、性能向上を期待して無条件に切り替えません。

update_post_term_cache との組み合わせで挙動が変わるため、片方だけを見てクエリ数を判断しません。

タームメタを読まない画面と読む画面では結果が逆になり得るため、サイト全体の共通設定にはしません。

タームメタを読む一覧と読まない一覧を分け、初回・再実行のデータベース問い合わせ回数とキャッシュから読めた回数を同じ環境で比較します。

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

まず標準の WP_Query とループを固定し、性能系の指定だけを変える比較の土台にできます。

記事を読む →

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

公式の WP_Query::parse_query() には追加バージョンが記録されています。

WP_Query 本体のソース説明では、update_post_term_cache と合わせて扱われる流れも確認できます。

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