the_content() の使い方|説明・引数・注意点

説明

the_content() は、現在の投稿の本文を出力する関数です。

基本構文

the_content( string $more_link_text = null, bool $strip_teaser = false ): void

引数

  • $more_link_text:「続きを読む」のリンクテキスト
  • $strip_teaser:true で、moreタグより前の部分を除く

戻り値

戻り値はありません(出力します)。

使い方(サンプル)

// ループ内で使用
the_content( '続きを読む' );

注意点

  • the_content フィルターが適用され、ショートコードや自動整形も動作します。
  • 文字列として取得するときは get_the_content() を使いますが、その場合フィルターは自動で適用されません。
  • テンプレートファイル(single.php など)のPHPブロック内に記述します。

実務での使いどころ

  • ループの中で、投稿の本文を出力するとき。
  • 続きを読むリンクの文言を変えるとき(the_content( '続きを読む' ))。

よくあるミスと対処

  • ループの外で呼び、意図した投稿の本文にならない。
  • echo the_content() のように、echo を付けている。the_content() は、それ自体が出力する。
  • the_content フィルターの中で、the_content() を呼んでいる。無限ループの原因になる。

NG例

echo the_content(); // それ自体が出力する関数なので、echo は不要

OK例

the_content();

使い分け早見表

やりたいこと 使うもの
本文を、フィルター付きで出力 the_content()
本文を文字列で取得 get_the_content()
抜粋を出力 the_excerpt()

関連項目

get_the_content()、the_excerpt()

公式リファレンス:the_content() | Function | WordPress Developer Resources

コメント

タイトルとURLをコピーしました