関数リファレンス/get extended

説明

投稿本文を <!--more--> で区切った内容を各々取得します。戻り値は main と extend のキーからなる連想配列です。main キーの配列には <!--more--> より前の本文、extend キーの配列には <!--more--> より後の本文が入っています。

2つ目のダッシュ（-）と 'more' の間にはスペースは入れないでください。'more' の後のスペースは無視されます。

「続きを読む」のカスタマイズ も見てください。

使い方

<?php get_extended( $post_content ) ?>

パラメータ

$post_content

（文字列） （必須） 投稿の本文

初期値： なし

戻り値

(array) 

<!--more--> の前 ('main') と後 ('extended') の投稿本文。

用例

最新の投稿から抜粋を表示する

If you want to display the latest posts on your WordPress blog, but only the content which comes before the <!--more--> tag, you can use this:

<ul>
<?php
global $post;
$args = array( 'numberposts' => 5 );
$myposts = get_posts( $args );
foreach( $myposts as $post ) : setup_postdata( $post );  
    $content_arr = get_extended (get_the_content() ); ?>
    <li>
       <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
       </br>
       <?php echo $content_arr['main']; //Display the part before the more tag  ?>   
    </li>
<?php endforeach; ?>
</ul>

Note: $content_arr['extended'] contains the contents after the more tag.

注

投稿本文中に <!--more--> が無い場合は、array['main'] に投稿全文が入り、array['extended'] は空文字になります。

変更履歴

• 1.0 : 新規導入

ソースファイル

get_extended() は wp-includes/post.php に含まれています。

関連

• the_excerpt()
• get_the_excerpt()

記事

• 記事: ループ - WordPress ループ内でのクエリの使い方に関する基本的概要。
• 記事: クエリ概要 - どのクエリが WordPress で生成されているかを判断するための説明。
• 記事: フックを使ったクエリのカスタマイズ
• 記事: MYSQL カスタムセレクトクエリ /en
• 記事: 高度なタクソノミークエリ /en
• 記事: オフセット・ペジネーションを使ったカスタムクエリ /en

コードドキュメンテーション

• クラス: WP_Query - WP_Query クエリの詳細概要
• オブジェクト: $wpdb - $wpdb オブジェクトの使い方概要
• 関数: get_query_var()
• 関数: query_posts() - 追加カスタムクエリの作成
• 関数: get_post() - 項目の ID を使ってその投稿のレコードをデータベースから取得する
• 関数: get_posts() - 項目の配列を返す特別な関数。
• 関数: get_pages() - ページの配列を返す特別な関数。
• 関数: have posts() - クエリが記事を返すかどうか判断する条件分岐。
• 関数: the_post() - クエリの後に自動的にループを設定するのに使われる。
• 関数: rewind_posts() - 現在のループをクリアする。
• 関数: setup_postdata() - ループ内で単一クエリ結果のデータを設定する。
• 関数: wp_reset_postdata() - 以前のクエリを復元する（通常、ループ内のもう一つのループで使われる）。
• 関数: wp_reset_query()
• 関数: is_main_query() - 変更するのがメインクエリであるよう保証する。
• アクションフック: pre_get_posts - 実行される前に WordPress クエリを変更する。
• アクションフック: the_post - 投稿オブジェクトをクエリの後に変更する。
• フィルターフック: found_posts - found_posts WP_Query オブジェクトの値を変更する

関連

固定ページ: get_all_page_ids(), get_ancestors(), get_page_link(), get_page_by_path(), get_page_by_title(), get_page_children(), get_page_hierarchy(), get_page_uri() /en, get_pages(), is_page(), page_uri_index() /en, wp_list_pages(), wp_page_menu()

リスト・ドロップダウン関数： wp_list_authors(), wp_list_categories(), wp_list_pages(), wp_list_bookmarks(), wp_list_comments(), wp_get_archives(), wp_page_menu(), wp_dropdown_pages(), wp_dropdown_categories(), wp_dropdown_users()

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

最新英語版： WordPress Codex » Function Reference/get extended （最新版との差分）