get_the_content

説明

string get_the_content( [ string $more_link_text = null [ , bool $strip_teaser = false [ , WP_Post | object | int $post null ] ] ] )
現在の投稿情報のコンテンツを取得する。

パラメータ

  • $more_link_text
    ページ分割時に表示される区切り文字列。省略時は(more...)となる。
  • $strip_teaser
    trueの場合はページを分割し、falseの場合は分割しない。(省略時はfalse)。
  • $post
    [5.2.0]投稿情報または投稿IDを指定(省略時はnull)。

返り値

現在の投稿情報のコンテンツを返す。

注意

単純に投稿情報のコンテンツ部分を返すのではなく、リクエスト状況に応じたHTMLテキストを返している。

・現在の投稿情報がパスワード保護されている場合は、パスワード入力フォームを返す。

・コンテンツが分割されている場合は、その分割部分と(必要に応じて)モアリンクのテキストを加えたものを返す。

[5.2.0]パラメータ$postが追加され、任意の投稿情報のコンテンツを取得できるようになった。


使用例

  • 現在の投稿情報のコンテンツを取得する。
    <?php $content = get_the_content(); ?>
  • モアリンクのテキストを'[次へ…]'として、現在の投稿情報のコンテンツを取得する。
    <?php $content = get_the_content( '[次へ…]' ); ?>

フィルター

[2.8.0]モアリンクをのHTMLテキストを追加する直前に'the_content_more_link'フィルターを呼び出す。パラメータ$more_linkにはモアリンクのHTMLテキストが、$more_link_textにはモアリンクのテキストが格納される。
$output .= apply_filters( 'the_content_more_link', $more_link, $more_link_text );

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/post-template.php

最終更新 : 2019年05月13日 10:37



お勧め

囲み型ショートコードとwpautop(2018年5月27日 更新)

ショートコードは投稿記事の閲覧時に動的に内容を変更できる優れもの。galleryやcaptionなどいくつかのショートコードが標準で組み込まれており、一部のプラグインではその機能を利用する手段としてショートコードが利用されている。

使っていないか確認しないとね!(フィルター編)(2019年4月24日 更新)

先週末にWordPress 5.2 Beta3(以降5.2Beta3)が公開され、正式リリースまであとわずか。ソースコードの変更点を見ていくと、wp-login.phpの中に非推奨となったフィルターが目に留まった。

Login rebuilder 2.5.0の新機能紹介(2018年12月10日 更新)

今回追加したものは、任意の名前でロックファイルを設定し、そのファイルが存在する場合は常にログイン不可にする機能である。この機能を有効にしておくことで、何らかの理由により認証に関する情報が漏洩した場合でも不正なログインを防ぐことができる。

時代はWP_Queryなのか(2011年8月1日 更新)

WordPressのテーマ作成において、メインの投稿記事とは別に特定の条件を指定した投稿内容を表示することが多々ある。つい最近まで get_posts関数を使用することが多かったのだが、最近はWP_Queryクラスを使用することが多くなってきた。

query_posts(WP_Queryクラス)で'tax_query'を使いこなす(2011年9月14日 更新)

2日にわたって投稿した「query_posts(WP_Queryクラス)でカテゴリーを絞り込む」「query_posts(WP_Queryクラス)で投稿タグを絞り込む」の続き。今日はカテゴリーや投稿タグ以外ののタクソノミーによる絞り込み、複数のタクソノミーの絞り込みの組み合わせについてまとめてみる。