get_the_excerpt – WordPressで記事の抜粋を表示する

get_the_excerpt
元調理師エンジニアリョウ
リョウ
WordPressで記事一覧などを表示するとき、記事内容を抜粋して表示したい時がありますよね?そんな時に便利な関数がget_the_excerptです。

get_the_excerptの概要

記事の抜粋を取得する関数。

get_the_excerptの返り値

抜粋が設定されていない場合

記事に抜粋が設定されていない場合、wp_trim_excerpt関数を適用して55単語を抜き出して生成します。

日本語の場合、抜粋できずに本文のほとんどが出力される場合があります。WordPressで日本語を使う場合、対策としてプラグイン「WP Multibyte Patch」を有効化してください。

パスワードを設定している場合

「There is no excerpt because this is a protected post.」という文字列(初期値)を返す。

抜粋が設定してあり、パスワードを設定していない場合

抜粋欄に入力した文字列を返す。

get_the_excerptの使い方

<?php $excerpt = get_the_excerpt(); ?>