[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-includes/blocks/ -> comments-pagination-next.php (source)

   1  <?php
   2  /**
   3   * Server-side rendering of the `core/comments-pagination-next` block.
   4   *
   5   * @package WordPress
   6   */
   7  
   8  /**
   9   * Renders the `core/comments-pagination-next` block on the server.
  10   *
  11   * @since 6.0.0
  12   *
  13   * @param array    $attributes Block attributes.
  14   * @param string   $content    Block default content.
  15   * @param WP_Block $block      Block instance.
  16   *
  17   * @return string Returns the next comments link for the query pagination.
  18   */
  19  function render_block_core_comments_pagination_next( $attributes, $content, $block ) {
  20      // Bail out early if the post ID is not set for some reason.
  21      if ( empty( $block->context['postId'] ) ) {
  22          return '';
  23      }
  24  
  25      $comment_vars     = build_comment_query_vars_from_block( $block );
  26      $max_page         = ( new WP_Comment_Query( $comment_vars ) )->max_num_pages;
  27      $default_label    = __( 'Newer Comments' );
  28      $label            = ! empty( $attributes['label'] ) ? $attributes['label'] : $default_label;
  29      $pagination_arrow = get_comments_pagination_arrow( $block, 'next' );
  30  
  31      $filter_link_attributes = static function () {
  32          return get_block_wrapper_attributes();
  33      };
  34      add_filter( 'next_comments_link_attributes', $filter_link_attributes );
  35  
  36      // Escaping early as the pagination arrow usually returns HTML and shouldn't be escaped.
  37      $label = esc_html( $label );
  38      if ( $pagination_arrow ) {
  39          $label .= $pagination_arrow;
  40      }
  41  
  42      $next_comments_link = get_next_comments_link( $label, $max_page, $comment_vars['paged'] ?? null );
  43  
  44      remove_filter( 'next_posts_link_attributes', $filter_link_attributes );
  45  
  46      if ( ! isset( $next_comments_link ) ) {
  47          return '';
  48      }
  49      return $next_comments_link;
  50  }
  51  
  52  
  53  /**
  54   * Registers the `core/comments-pagination-next` block on the server.
  55   *
  56   * @since 6.0.0
  57   */
  58  function register_block_core_comments_pagination_next() {
  59      register_block_type_from_metadata(
  60          __DIR__ . '/comments-pagination-next',
  61          array(
  62              'render_callback' => 'render_block_core_comments_pagination_next',
  63          )
  64      );
  65  }
  66  add_action( 'init', 'register_block_core_comments_pagination_next' );


Generated : Tue Nov 17 08:20:01 2026 Cross-referenced by PHPXref