【WordPress/PHP】the_excerpt関数で表示される文字数を変更する方法

2023年5月26日2023年7月16日

本記事では、WordPressのthe_excerpt関数で表示される文字数を変更する方法について解説しています。

WordPressの学習におすすめ書籍

1冊ですべて身につくWordPress入門講座

総合評価

( 5 )

メリット

楽天ブックス

¥2,200 （2024/04/23 07:35時点 | 楽天市場調べ）

＼楽天ポイント5倍セール！／

＼ポイント5%還元！／

ポチップ

先輩くん

Amazon Kindle Unlimitedに登録すると、月額980円で読み放題だからオススメだよ！

後輩ちゃん

初回30日間は無料だから、まだ登録したことのない人はぜひ試してみてね！

全プログラマー必見！
変数名/関数名にもう悩まない！

リーダブルコード

総合評価

( 5 )

メリット

著:Dustin Boswell, 著:Trevor Foucher, 解説:須藤功平, 翻訳:角征典

¥2,640 （2023/07/23 02:48時点 | Amazon調べ）

＼楽天ポイント5倍セール！／

＼ポイント5%還元！／

ポチップ

excerpt_lengthフィルター

the_excerpt関数で表示されるテキストの文字数を変更したい時は、excerpt_lengthフィルターを使います。基本的な使い方は以下のとおりです。

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

ポイント

returnで返す値がthe_excerpt関数で表示されるテキストの文字数になります。つまり、上記のコードでは、抜粋で表示されるテキストは10文字までになります。

実際に、表示されるテキストが10文字に収まってるか動作確認してみましょう。投稿ページを一つ作成し適当な本文または抜粋にテキストを記述します。

今回は本文に「投稿ページのコンテンツです。」を記述しました。single.phpでthe_excerpt関数を実行してみます。

<?php the_excerpt(); ?>

ブラウザを確認すると、「投稿ページのコンテン」の10文字だけ表示され残りのテキストは3点リーダー(…)で省略されていることが分かります。