render_block_core_comments_pagination_next( array $attributes, string $content, WP_Block $block ): string

Parameters

$attributesarray

Block attributes.

$contentstring

Block default content.

$blockWP_Block

Block instance.

Return

string

Returns the next comments link for the query pagination.

Uses · 8

• build_comment_query_vars_from_block()Helper function that constructs a comment query vars array from the passed block properties.
• __()Retrieves the translation of $text.
• get_comments_pagination_arrow()Helper function that returns the proper pagination arrow HTML for `CommentsPaginationNext` and `CommentsPaginationPrevious` blocks based on the provided `paginationArrow` from `CommentsPagination` context.
• get_block_wrapper_attributes()Generates a string of attributes by applying to the current block being rendered all of the features that the block supports.
• add_filter()Adds a callback function to a filter hook.
• get_next_comments_link()Retrieves the link to the next comments page.
• remove_filter()Removes a callback function from a filter hook.
• WP_Comment_Query::__construct()Constructor.

Source

View on Trac ↗View on GitHub ↗

19function 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            = isset( $attributes['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	if ( $pagination_arrow ) {37		$label .= $pagination_arrow;38	}39 40	$next_comments_link = get_next_comments_link( $label, $max_page, $comment_vars['paged'] ?? null );41 42	remove_filter( 'next_posts_link_attributes', $filter_link_attributes );43 44	if ( ! isset( $next_comments_link ) ) {45		return '';46	}47	return $next_comments_link;48}

History

Introduced in 6.0.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-includes/blocks/comments-pagination-next.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.