関数リファレンス/in the loop

説明

この in_the_loop() がループの中で呼び出されたかどうか判定します（つまり、現在ループの中であるかどうか）。

使い方

<?php in_the_loop(); ?>

パラメータ

この関数にパラメータはありません。

戻り値

(真偽値) 

ループの中かどうかを返します。

• true - ループの中。
• false - ループが始まる前、または終わった後。

用例

単一投稿のタイトル表示を変える

次のコード例は、投稿タイトルのデフォルト出力を変更できるようにします。これはテーマやプラグインの functions.php ファイルに記述して使用します。

add_filter( 'the_title', 'modify_single_post_entry_titles' );

function modify_single_post_entry_titles( $title ) {

	if ( is_singular( 'post' ) && in_the_loop() ) {

		/* $title を書き換える */

	}

	return $title;
}

変更履歴

バージョン 2.0.0 にて導入されました。

ソースファイル

in_the_loop() は wp-includes/query.php にあります。

関連資料

条件分岐タグ： is_404(), is_admin(), is_admin_bar_showing(), is_archive(), is_attachment(), is_author(), is_category(), is_comments_popup(), is_date(), is_day(), is_feed(), is_front_page(), is_home(), is_local_attachment(), is_main_query, /is_multi_author, is_month(), is_new_day(), is_page(), is_page_template(), is_paged(), is_plugin_active(), is_plugin_active_for_network() /en, is_plugin_inactive() /en, is_plugin_page() /en, is_post_type_archive(), is_preview() /en, is_search(), is_single(), is_singular(), is_sticky(), is_tag(), is_tax(), is_taxonomy_hierarchical(), is_time(), is_trackback(), is_year(), in_category(), in_the_loop(), is_active_sidebar(), is_active_widget(), is_blog_installed() /en, is_rtl(), is_dynamic_sidebar(), is_user_logged_in(), has_excerpt(), has_post_thumbnail(), has_tag(), pings_open(), email_exists(), post_type_exists(), taxonomy_exists(), term_exists(), username_exists() /en, wp_attachment_is_image(), wp_script_is()

関数リファレンス、テンプレートタグ目次もご覧ください。

最新英語版： WordPress Codex » Function Reference/in_the_loop （最新版との差分）