wp_trim_excerpt

（1.5.0以降）
wp_trim_excerpt - 抜粋を取得する

説明

string wp_trim_excerpt( [ string $text = '' [ , mixed $post = 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 );

[2.9.0]本文を指定した文字数で切り詰める前に'excerpt_more'フィルターを呼び出す。パラメータ$more_stringには文字数（標準は' ' . '[…]'）が格納されている。

$excerpt_more = apply_filters( 'excerpt_more', $more_string );

[2.8.0]抜粋を返す前に'wp_trim_excerpt'フィルターを呼び出す。パラメータ$textには抜粋が、$raw_excerptには本関数が受け取り退避しておいた抜粋が格納されている。

return apply_filters( 'wp_trim_excerpt', $text, $raw_excerpt );

直接実行するアクションはありません。

/wp-includes/formatting.php

最終更新 : 2023年08月09日 08:07

先週「WordPress 5.4 RC3」が公開され、正式リリースまであと1週間。ブロックエディターの機能強化が目立つわけですが、地味な変更点もちらほらと。今回はその中の1つ、「個人データのエクスポート」機能に関連するフィルターを紹介する。

WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。

ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。

Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。

先週「WordPress 5.4 Beta2」が公開され、来月末には正式リリース。タイミングよく三連休だったので、1つ前の「ニュース」で紹介されていた変更点から確認してみた。