get_boundary_post()

関数get_boundary_post()は、WordPressで指定された投稿の前後にある投稿情報を取得するために使用されます。

シンタックス

get_boundary_post( string $in_same_term = false, string $excluded_terms = '', string $start = true, string $taxonomy = 'category' )

引数の説明:

• $in_same_term (bool) — 同じタクソノミー内で投稿を検索するかどうか。
• $excluded_terms (string) — 除外するタームID。複数のIDはカンマで区切ります。
• $start (bool) — 最初の投稿または最後の投稿を取得するかを指定します。
• $taxonomy (string) — 使用するタクソノミー。デフォルトは'category'です。

例1: 最初の投稿情報を取得する

投稿が属するカテゴリー内で最初の投稿を取得します。

<?php $first_post = get_boundary_post( true, '', true ); ?>
<?php echo $first_post->post_title; ?>

例2: 同じカテゴリーの最後の投稿を取得する

同じカテゴリー内で最後の投稿タイトルを取得します。

<?php $last_post = get_boundary_post( true, '', false ); ?>
<?php echo $last_post->post_title; ?>

例3: 特定のタクソノミーを使用して取得する

カスタムタクソノミー「product_category」内で最初の投稿を取得します。

<?php $first_product = get_boundary_post( true, '', true, 'product_category' ); ?>
<?php echo $first_product->post_title; ?>

例4: 除外タームを指定する

特定のタームID（10と15）を除外し、最初の投稿を取得します。

<?php $boundary_post = get_boundary_post( true, '10,15', true ); ?>
<?php echo $boundary_post->post_title; ?>

例5: 同じターム外の最初の投稿を取得する

カテゴリー外で最初の投稿を取得します。

<?php $post = get_boundary_post( false, '', true ); ?>
<?php echo $post->post_title; ?>

注意事項

• get_boundary_post()は投稿が存在しない場合nullを返します。
• 引数$taxonomyを指定しない場合、デフォルトでカテゴリーが使用されます。