【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テンプレートタグ】has_post_thumbnail():アイキャッチ画像が登録されているかを判別
概要 アイキャッチ画像が登録されているかどうかを判別する。 書式 <?php has_post...
-
【WordPressテンプレートタグ】comment_author_email_link():コメント投稿者のメールアドレスを、mailto:リンクとして表示
概要 コメント投稿者のメールアドレスをmailto:リンクとして表示する。 管理画面「設定」>「ディ...
-
【WordPressテンプレートタグ】comment_author_email():コメント投稿者のメールアドレスをリンクなしで表示
概要 コメント投稿者のメールアドレスをリンクなしで表示する。 管理画面「設定」>「ディスカッション」...
-
【WordPressテンプレートタグ】get_author_posts_url():作成者IDを指定して、作成者別アーカイブURLを取得
概要 投稿の作成者をIDで指定して、作成者別アーカイブページのURLを取得する。 書式 <?p...
-
【WordPressテンプレートタグ】wp_login_url():ログインURLを取得
概要 ログインURLを文字列として取得する。 書式 <?php wp_login_url( '...
-
【WordPressテンプレートタグ】the_author_posts():作成者の総投稿数を表示
概要 作成者の総投稿数を表示する。下書きや非公開の記事はカウントしない。 書式 <?php t...
-
【WordPressテンプレートタグ】get_page_link():固定ページのパーマリンクを取得
概要 固定ページのパーマリンクを取得する。固定ページIDを渡せばそのページのURLを取得でき、引数を...
-
【WordPressテンプレートタグ】edit_comment_link():コメント編集画面へのリンクを表示
概要 コメント編集画面へのリンクを表示する。 書式 <?php edit_comment_li...
-
【WordPressテンプレートタグ】previous_posts_link():前のアーカイブへのリンクを表示
概要 記事一覧ページ(メインページ・アーカイブページ・カテゴリーなど)の前ページ(日付の新しい記事一...
-
【WordPressテンプレートタグ】get_post_thumbnail_id():アイキャッチ画像のIDを取得
概要 アイキャッチ画像のIDを取得する。 書式 <?php get_post_thumbnai...