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

テンプレートタグ/get the excerpt

提供: WordPress Codex 日本語版
< テンプレートタグ
2013年7月6日 (土) 18:32時点におけるDjkaz (トーク | 投稿記録)による版 (英語版をコピペ)

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

Returns the excerpt of the current post with the "[...]" text at the end, which is not a "read more" link. This template tag must be used within The Loop. Alternatively, the_excerpt() can be used to directly display the excerpt, but it also adds opening and closing <p> tags to the string returned by get_the_excerpt().

使い方

<?php $excerpt = get_the_excerpt( $deprecated ) ?>

パラメータ

$deprecated is not required.

戻り値

  • If the post does not have an excerpt, this function applies wp_trim_excerpt to the post content and returns that generated string with "[...]" at the end. wp_trim_excerpt is applied via the get_the_excerpt filter and can be removed.
  • For password protected pages it returns a string, which has a default value of "There is no excerpt because this is a protected post." This text can be changed in the function definition.
  • If the post has an excerpt and is not password protected, it returns the excerpt as a string.

用例

get_the_excerpt() can be used to retrieve and store the value in a variable, without outputting it to the page.

<?php
$my_excerpt = get_the_excerpt();
if ( $my_excerpt != '' ) {
	// Some string manipulation performed
}
echo $my_excerpt; // Outputs the processed value to the page
?>

Use get_the_excerpt() to print an excerpt by specifying a maximium number of characters.

<?php
the_excerpt_max_charlength(140);

function the_excerpt_max_charlength($charlength) {
	$excerpt = get_the_excerpt();
	$charlength++;

	if ( mb_strlen( $excerpt ) > $charlength ) {
		$subex = mb_substr( $excerpt, 0, $charlength - 5 );
		$exwords = explode( ' ', $subex );
		$excut = - ( mb_strlen( $exwords[ count( $exwords ) - 1 ] ) );
		if ( $excut < 0 ) {
			echo mb_substr( $subex, 0, $excut );
		} else {
			echo $subex;
		}
		echo '[...]';
	} else {
		echo $excerpt;
	}
}
?>


変更履歴

0.71にて導入されました。


ソースファイル

get_the_excerpt() is located in wp-includes/post-template.php.

the_excerpt()

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


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