the_excerpt()

関数の概要

the_excerpt() は、WordPressテーマ内で投稿やページの抜粋（概要）を表示するために使用される関数です。この関数は、ループ内やテンプレートファイル内で呼び出され、現在の投稿やページの抜粋を画面に出力します。抜粋は、投稿の概要やイントロダクションを表示するために使用され、訪問者に投稿の内容を簡単に理解させるのに役立ちます。

パラメータの説明

the_excerpt() 関数は引数を受け取りませんが、フィルターフックやカスタム関数で出力をカスタマイズすることができます。

使用例

以下は、the_excerpt() 関数を使用して投稿やページの抜粋を表示する基本的な例です：

<?php the_excerpt(); ?>

関連する関数

• get_the_excerpt(): 抜粋を取得し、返しますが、表示はしません。the_excerpt() 関数と異なり、抜粋を変数に格納するために使用されます。
• the_content(): 投稿やページのメインコンテンツを表示するために使用されます。抜粋よりも詳細な内容を表示します。
• the_title(): 投稿やページのタイトルを表示するために使用されます。
• the_permalink(): 投稿やページのパーマリンク（URL）を表示するために使用されます。

抜粋のカスタマイズ

WordPressでは、抜粋の長さや末尾に表示される文字列（例：[…]）をカスタマイズすることができます。以下は、フィルターフックを使用して抜粋の長さを変更する例です：

function custom_excerpt_length( $length ) {
    return 20; // 抜粋の長さを20語に設定
}
add_filter( 'excerpt_length', 'custom_excerpt_length', 999 );

次に、抜粋の末尾に表示される文字列をカスタマイズする例です：

function custom_excerpt_more( $more ) {
    return '...'; // 末尾に表示する文字列を'...'に設定
}
add_filter( 'excerpt_more', 'custom_excerpt_more' );

the_excerpt() 関数を使用することで、テーマのテンプレートファイル内で投稿やページの概要を簡単に表示することができます。これにより、訪問者に投稿内容の要点を素早く伝え、興味を引くことができます。