【WordPressテンプレートタグ】the_excerpt():記事の抜粋を表示
公開日: : 最終更新日:2016/03/24 テンプレートタグ
概要
記事の抜粋を表示する。
抜粋の文末には [...](角括弧+三点リーダー)をリンクなしで表示する。 管理画面「投稿の編集」の「抜粋」欄に入力があればその入力を表示し、「抜粋」欄に入力がない場合は投稿本文の最初の55個の単語までを表示する。
書式
パラメーター
なし
位置
ループ内
使用例
初期設定での使用
投稿の抜粋を表示する。
<?php the_excerpt(); ?>
条件分岐タグと併用
カテゴリーページまたはアーカイブページでは抜粋を表示し、それ以外のページでは記事全文を表示する。
<?php if ( is_category() || is_archive() ) { the_excerpt(); } else { the_content(); } ?>
抜粋の長さを変更
デフォルトでは抜粋の長さは55単語なので、単語数を変更するにはfunctions.phpファイルに以下のコードを追加する。
単語数110文字に変更する場合、
function custom_excerpt_length( $length ) { return 110; } add_filter( 'excerpt_length', 'custom_excerpt_length', 999 );
文末の[...]を変更・削除
デフォルトの抜粋文末'[...]'を'【続きを読む】'に変更するには、functions.phpファイルに以下のコードを追加する。
function new_excerpt_more($more) { return '【続きを読む】'; } add_filter('excerpt_more', 'new_excerpt_more');
投稿で "【続きを読む】" リンクを作成する
投稿で "【続きを読む】" リンクを作成するには、functions.phpに以下のコードを追加する。 CSSのread-moreクラスを設定する必要がある。
function new_excerpt_more( $more ) { return ' <a class="read-more" href="'. get_permalink( get_the_ID() ) . '">【続きを読む】</a>'; } add_filter( 'excerpt_more', 'new_excerpt_more' );
MEMO
抜粋のコンテンツからはHTMLタグと画像は取り除かれる。
関連
- wordpressのテンプレートタグ一覧
- is_category()
- is_archive()
- the_content()
関連記事
-
【WordPressテンプレートタグ】comment_author_email_link():コメント投稿者のメールアドレスを、mailto:リンクとして表示
概要 コメント投稿者のメールアドレスをmailto:リンクとして表示する。 管理画面「設定」>「ディ...
-
【WordPressテンプレートタグ】the_author():作成者名を表示
概要 投稿の作成者名を表示する。 書式 <?php the_author(); ?&...
-
【WordPressテンプレートタグ】the_search_query():検索キーワードを表示
概要 検索が行われたとき、検索キーワードを表示する。 書式 <?php the_search_...
-
【WordPressインクルードタグ】get_search_form():「searchform.php」を使用して検索フォームを表示または取得
概要 検索フォームを表示、または文字列として取得する。 テーマにテンプレートファイル「searchf...
-
【WordPressテンプレートタグ】the_tags():投稿の属するタグ名とリンクを表示
概要 投稿につけられたタグ名とタグアーカイブへのリンクを表示する。 書式 <?php the_...
-
【WordPressテンプレートタグ】get_page_link():固定ページのパーマリンクを取得
概要 固定ページのパーマリンクを取得する。固定ページIDを渡せばそのページのURLを取得でき、引数を...
-
【WordPressテンプレートタグ】previous_posts_link():前のアーカイブへのリンクを表示
概要 記事一覧ページ(メインページ・アーカイブページ・カテゴリーなど)の前ページ(日付の新しい記事一...
-
【WordPressテンプレートタグ】get_the_post_thumbnail():アイキャッチ画像を取得
概要 アイキャッチ画像のimgタグを取得する。 書式 <?php get_the_post_t...
-
【WordPressテンプレートタグ】get_the_date():記事の公開日を取得
概要 現在の記事の公開日を取得する。 書式 <?php get_the_date('forma...
-
【WordPressテンプレートタグ】single_term_title():カスタム分類アーカイブのタイトルを表示または取得
概要 現在のページのカスタム分類アーカイブのタイトルを表示または取得する。 書式 <?php ...