当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

関数リファレンス/wp trim excerpt

提供: WordPress Codex 日本語版
< 関数リファレンス
2015年5月24日 (日) 23:39時点におけるGblsm (トーク | 投稿記録)による版 (en:Function Reference/wp trim excerpt 15:28, 6 March 2015 Bcworkz 版を反映。)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

必要に応じて投稿から抜粋を生成する関数です。ループの中で使ってください。

抜粋の長さは 55 単語までになり、それより長い場合は '[...]' が付加されます。もし 55 単語以下であった場合はそのまま返されます。

注: 日本語のように語句の間を半角スペースで区切らない言語では「55単語」を判定できないため、抜粋できずに本文のほとんどが出力されてしまうことがあります。

WordPress 日本語版では、この問題を含むマルチバイト関連の問題に対処するために WP Multibyte Patch プラグインを同梱しています。このプラグインを使用すると、110文字まで(設定により変更可)を抜粋文として出力できます。

使い方

<?php wp_trim_excerpt( $text ); ?>

パラメータ

$text
文字列) (オプション) 抜粋の文字列。空文字列を与えると抜粋が生成されます。テキストを与えるとそれがそのまま返される他、短縮されません
初期値: "" — 空文字列

戻り値

(文字列) 
抜粋の文字列。

用例

参考

変更履歴

ソースファイル

wp_trim_excerpt()wp-includes/formatting.php にあります。

the_excerpt_rss(), wp_trim_words()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/wp_trim_excerpt最新版との差分