WordPress

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

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

WordPressの学習におすすめ参考書
1冊ですべて身につくWordPress入門講座

本書情報
著者Mana
発売日2022/3/22
ページ数344ページ
Kindle版
レビュー
(Amazon)
(217件)

【中・上級者向け】オリジナルテーマの作り方が学べるおすすめ参考書
WordPressオリジナルテーマ制作入門

本書情報
著者清水 由規 / 清水 久美子 / 鈴木 力哉 / 西岡 由美
発売日2022/1/13
ページ数416ページ
Kindle版
レビュー
(Amazon)
(53件)
先輩くん
先輩くん
Amazon Kindle Unlimitedに登録すると、月額980円で読み放題だからオススメだよ!
後輩ちゃん
後輩ちゃん
初回30日間は無料だから、まだ登録したことのない人はぜひ試してみてね!

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点リーダー(…)で省略されていることが分かります。

ブラウザの表示結果

ブログランキング・にほんブログ村へ PVアクセスランキング にほんブログ村