【WordPress】the_excerpt()で表示される抜粋の文字数制限の変更方法【functions.php】

お知らせ一覧ページなどのアーカイブページで、WordPress関数「the_excerpt()」により表示される抜粋文の文字数制限を変更する方法を３つ紹介します。

抜粋文のデフォルトの文字数制限について

WordPress関数「the_excerpt()」で表示される文字数にはデフォルトで制限がかかっています。

事前準備：プラグイン：「WP Multibyte Patch」をインストール

抜粋の文字数を変更する場合には、WordPressプラグインの「WP Multibyte Patch」をインストールしておいて下さい。

このプラグインがないと文字数が正しく表示されない場合があります。

方法１：functoins.phpに一筆書く

この方法にはいくつかありますが、簡単な方法はfunctions.phpに一筆書くものです。

文字数制限のためにfunctions.phpに書くコードは下記のとおりです。

/*----------------------------------------------------------*/
/* 投稿の抜粋文の文字数制限 */
/*----------------------------------------------------------*/
add_filter( 'excerpt_length', function( $length ){
  return 70; //returnの後ろに最大表示文字数を書く。この場合は70文字
}, 999 );

例えば、上のコードでは抜粋表示は最大70文字で、それ以上の長さになると[…]で省略されます。

抜粋が文字数制限以上にある場合の省略表記変更

抜粋文が上で設定した文字数以上ある場合には、デフォルト設定では文末が[…]のように表示されます。

これを … に変更したい場合には下記のようにfunctions.phpに記述します。

// 省略記号を「…」に変更する
add_filter( 'excerpt_more', function( $more ){
  return '…';
}, 999 );

方法２：WordPress関数で文字数制限する

下のWordPress関数「wp_trim_words()」を使うと、抜粋やタイトル、あるいはコンテンツ本文の文字数を制限することができます。

<?php echo wp_trim_words( get_the_excerpt(), 60, '...' ); ?>

エスケープ処理する場合

必要なのか微妙なところですが、エスケープ処理する場合には下記のようになります。

<?php echo esc_html(wp_trim_words( get_the_excerpt(), 63, '...' )); ?>

SIMS-CODE

【WordPress】画面表示のエスケープ処理【セキュリティ対策】 | SIMS-CODE ３つのエスケープ処理、esc_url()、esc_url()、esc_attr()について使用例を紹介します。また、エスケープ処理の必要ないWordPress関数も合わせて紹介します。

方法３：PHPで文字数制限する

この場合にはfunctions.phpへの記述は必要ありません。抜粋を表示させる部分に直接書きます。（ほとんどの場合はアーカイブページ等のループの中だと思います）

先にコードを書いておきます。

<?php 
$post_cont = strip_tags(get_the_excerpt());
$excerpt_cont = str_replace(array("\n", "\r\n"), '', $post_cont);
$text_limit = '50'; //表示させる文字数の制限
                    
// 制限した文字数より読み込むテキスト量が多い時は、文末は「...」で省略
if(mb_strlen($post_cont) > $text_limit) {
  $excerpt_cont= mb_substr($post_cont, 0, $text_limit);
  echo $excerpt_cont. '...';
} else {
  echo $post_cont;
}
?>

補足すると、2行目の「get_the_excerpt()」の部分は、抜粋以外にコンテンツやタイトル等のテキストにも使えます。

この方法であれば、「投稿ページ」と「カスタム投稿タイプ」の各アーカイブページで別々に抜粋の文字数制限が可能となります。

ここでは自分の忘備録として簡潔にまとめましたが、参考にしたブログでは非常に丁寧に解説されています。リスペクトしてリンクを貼らせて頂きます。深く理解したい方は是非参照なさって下さい。

KoMariCote

WordPressで表示させる文字数を制限する | KoMariCote WordPressで表示する文字数を制限するための方法をいくつかご紹介します。うまく表示させられる方法を見つけてみてください。