the_content()
は、WordPressの投稿本文を表示するためのテンプレートタグです。
機能の説明
the_content()
は、現在表示中の投稿またはページの「本文」を取得し、HTMLを適用して表示します。記事内の段落やショートコードが適切に解釈されて出力されるため、投稿のメインコンテンツを表示する際に使用します。
シンプルなコード例
the_content();
このコードは、現在表示中の投稿またはページの本文を出力します。
使い方の解説
the_content()
は、ループ内で使用されるのが一般的です。WordPressテーマのsingle.php
やpage.php
、index.php
などにおいて、各投稿の本文を表示する際に使われます。
引数
$more_link_text
-
<!--more-->
タグが使われているときに、続きを表示するリンクのテキストをカスタマイズします。 $strip_teaser
-
冒頭のテキスト(ティーザー)を非表示にするかどうかを指定します。デフォルトは
false
。
戻り値
void
-
the_content()は直接HTMLを出力します。戻り値はありません。HTMLとして出力されるため、エスケープ処理が不要な場合がほとんどです。
オプション
the_content()
自体にオプションはありませんが、ショートコードや<!--more-->
タグの影響を受けてコンテンツが表示されます。
使用例
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
the_title( '<h1>', '</h1>' );
the_content( '続きを読む', true );
}
}
このコードは、WordPressのメインループで各投稿のタイトルと本文を表示します。the_content()
には、<!--more-->
タグがある場合に「続きを読む」というリンクを表示するようにしています。
一緒に使うことが多い関連タグ
get_the_content()
get_the_content()
は、投稿本文を取得するテンプレートタグで、the_content()
とは異なり、直接HTMLを出力せずに戻り値として返します。
$content = get_the_content();
echo apply_filters( 'the_content', $content );
このコードでは、get_the_content()
で取得した本文をapply_filters()
を使ってフィルタリングした後に出力しています。
追加情報を取得したい場合
投稿本文からショートコードを解釈したり、特定のHTML要素をフィルタリングしたい場合、apply_filters()
関数を使うことが推奨されます。
get_the_excerpt()で取得できる情報
$excerpt = get_the_excerpt();
echo '<p>' . esc_html( $excerpt ) . '</p>';
出力できる情報
- excerpt: 投稿の抜粋
- custom_excerpt_length: 抜粋の文字数(
add_filter()
で調整可能)
想定されるトラブル
ショートコードが解釈されない
add_filter('the_content', 'do_shortcode');
を使用してショートコードを有効化する。
<!--more-->
タグが正しく表示されない
テーマでthe_content()
を使っていることを確認し、$more
グローバル変数が適切に設定されているか確認してください。
Q&A
まとめ
the_content()
は、WordPressの投稿本文を表示するための基本的なテンプレートタグで、ループ内で使用することが推奨されます。
ショートコードの解釈や<!--more-->
タグのサポートも行います。
the_content()
を正しく使うことで、ユーザーに適切なコンテンツを提供し、SEOにも効果的なサイト運営が可能です。