説明
string wp_trim_excerpt( [ string $text = '' [ , mixed $post = null ] ] )
抜粋を取得する。
パラメータ
- $text抜粋を指定（省略時は''）。
- $post[5.2.0]投稿情報または投稿IDを指定（省略時はnull）。
返り値
抜粋を返す。
注意
パラメータ$textが空の場合、投稿情報の本文からショートコードなどを取り除いた抜粋を wp_trim_words関数を使って生成する。
[5.2.0]パラメータ$postが追加され、任意の投稿情報から抜粋が取得できるようになった。
[6.3.0]抜粋からfootnotesマークアップを除外するようになった。
使用例
- 現在の投稿情報からその抜粋を取得する。
<?php $excerpt = wp_trim_excerpt(); ?> - 変数$post現在の投稿情報からその抜粋を取得する。
<?php $excerpt = wp_trim_excerpt( '', $post ); ?>
フィルター
[2.7.0]抜粋を生成する前に'excerpt_length'フィルターを呼び出す。パラメータ$excerpt_lengthには文字数（標準は55の翻訳内容（日本語の場合は110））が格納されている。$excerpt_length = (int) apply_filters( 'excerpt_length', $excerpt_length );$excerpt_more = apply_filters( 'excerpt_more', $more_string );return apply_filters( 'wp_trim_excerpt', $text, $raw_excerpt );アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/formatting.php最終更新 : 2023年08月09日 08:07
関連
お勧め
投稿情報を連想配列で参照する（2018年5月27日 更新）
投稿情報は、タイトルや本文、投稿日時といったいくつかのデータが含んでおり、多くの場合オブジェクトになっている。これを連想配列で扱いたい場合はキャストして型変換することが多かった。基本的にはキャストで問題ないのだが、ふと目に留まったto_arrayメソッドが興味深かったのでメモとして残しておく。
WordPressのコーディングスタンダードとPSR-2がかみ合わない（2018年5月27日 更新）
先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon（4.6）」から「Oxygen（4.7）」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style（Formatter）」が「PSR-2」に設定されていることが原因だった。
続テーマを変更せずにWebフォントを使ってみた（2022年2月8日 更新）
先日投稿した「テーマを変更せずにWebフォントを使ってみた」では、テーマ「Twenty Twenty One」でWebフォントを使うことができた。その後、ほかのテーマで試したところ、そのままではWebフォントを使うことができなかった。今回は、それらのテーマの対応について紹介する。
ブロックエディターで現在の「ロケール」を取得した時のメモ（2024年8月10日 更新）
ブロックエディター向けのプラグインで日本語固有の機能を実装する際、現在のロケール（言語）を取得したい。ブロックエディターの編集時、投稿を編集しているユーザーの言語が優先され、それをどうやって取得するかを「ChatGPT」に聞いてみたのだが。。。
スマートフォン向けの振り分けを自前で行う（2012年1月23日 更新）
PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。