get_queried_object_id() の使い方｜説明・引数・注意点

説明

基本構文

get_queried_object_id(): int

引数

引数はありません。

戻り値

IDの整数。取得できなければ 0。

使い方（サンプル）

$id = get_queried_object_id();

注意点

• 投稿一覧のページ（ブログページ）では、固定ページに設定した投稿ページのIDが返ります。

実務での使いどころ

• 現在表示中のカテゴリーやタームのIDを取得するとき。
• 固定ページで、そのページのIDを取得するとき（ループの外でも使える）。

よくあるミスと対処

• get_the_ID() と混同している。get_the_ID() はループ中の投稿のID。
• 対象のオブジェクトがないページでは、0 が返る場合がある。確認せずに使う。

NG例

$term_id = get_the_ID(); // タームのアーカイブでは、タームのIDではない

OK例

$term_id = get_queried_object_id();

使い分け早見表

関連項目

get_queried_object()、get_the_ID()

公式リファレンス：get_queried_object_id() | Function | WordPress Developer Resources