WordPress / 関数 / the_post

WordPress / 関数 / the_post

テーマ中のテンプレートで呼び出される。呼び出されるコンテキストによって挙動は変わる。

これが実行されることによってそのコンテキストの情報が $post というグローバル変数にセットされて、これに付随する様々な関数がこれを呼び出すということになっている。

テンプレートから、変数、スコープ、引数、という概念を排除しようとした設計の結果、このような惨状になっている。

この関数はグローバル変数を操作するので、実行タイミングや順番により結果が意図せず変化してしまうので注意が必要である。

引数は無い。

the_post();

アーカイブテンプレート中

特定の投稿の情報を(取得)し、ループを次の投稿へ進める。 次の投稿を取得して、それを「現在の投稿」としてセットアップし、ループの 'in the loop' プロパティを true にする。

↑説明が意味不明だが、要は単なる投稿の foreach。非プログラマ向けにその機構をうまく「ぼくのかんがえたさいきょうのふぉーいーち」で隠蔽したもの。

固定ページテンプレート中

暗黙的にトリガーされるらしいが、一部の値が正しくセットされない場合もあるっぽいので、テンプレートの頭で明示的に呼んだほうがいいかも。

実行されると、その固定ページに入力されている各種値を取得する準備が整うようにグローバル変数 $post に値がセットされる。

投稿テンプレート中

暗黙的にトリガーされるらしいが、一部の値が正しくセットされない場合もあるっぽいので、テンプレートの頭で明示的に呼んだほうがいいかも。

実行されると、その投稿ページに入力されている各種値を取得する準備が整うようにグローバル変数 $post に値がセットされる。

Tags

wordpress/function/the_post.txt · 最終更新: 2020-09-22 16:50 by ore