【WordPressテンプレートタグ】the_excerpt()：記事の抜粋を表示

テンプレートタグ

2016.03.24 2015.01.04

概要

記事の抜粋を表示する。

抜粋の文末には […]（角括弧＋三点リーダー）をリンクなしで表示する。管理画面「投稿の編集」の「抜粋」欄に入力があればその入力を表示し、「抜粋」欄に入力がない場合は投稿本文の最初の55個の単語までを表示する。

書式

<?php the_excerpt(); ?>

パラメーター

なし

位置

ループ内

使用例

初期設定での使用

投稿の抜粋を表示する。

<?php the_excerpt(); ?>

条件分岐タグと併用

カテゴリーページまたはアーカイブページでは抜粋を表示し、それ以外のページでは記事全文を表示する。

<?php if ( is_category() || is_archive() ) {
the_excerpt();
} else {
the_content();
} ?>

抜粋の長さを変更

デフォルトでは抜粋の長さは55単語なので、単語数を変更するにはfunctions.phpファイルに以下のコードを追加する。
単語数110文字に変更する場合、

function custom_excerpt_length( $length ) {
     return 110;	
}	
add_filter( 'excerpt_length', 'custom_excerpt_length', 999 );

文末の[…]を変更・削除

デフォルトの抜粋文末'[…]’を’【続きを読む】’に変更するには、functions.phpファイルに以下のコードを追加する。

function new_excerpt_more($more) {
	return '【続きを読む】';
}
add_filter('excerpt_more', 'new_excerpt_more');

投稿で “【続きを読む】” リンクを作成する

投稿で “【続きを読む】” リンクを作成するには、functions.phpに以下のコードを追加する。 CSSのread-moreクラスを設定する必要がある。

function new_excerpt_more( $more ) {
 return ' <a class="read-more" href="'. get_permalink( get_the_ID() ) . '">【続きを読む】</a>';
}
add_filter( 'excerpt_more', 'new_excerpt_more' );

MEMO

抜粋のコンテンツからはHTMLタグと画像は取り除かれる。