<?php /** * Server-side rendering of the `core/post-navigation-link` block. * * @package WordPress */ /** * Renders the `core/post-navigation-link` block on the server. * * @since 5.9.0 * * @param array $attributes Block attributes. * @param string $content Block default content. * * @return string Returns the next or previous post link that is adjacent to the current post. */ function render_block_core_post_navigation_link( $attributes, $content ) { if ( ! is_singular() ) { return ''; } // Get the navigation type to show the proper link. Available options are `next|previous`. $navigation_type = isset( $attributes['type'] ) ? $attributes['type'] : 'next'; // Allow only `next` and `previous` in `$navigation_type`. if ( ! in_array( $navigation_type, array( 'next', 'previous' ), true ) ) { return ''; } $classes = "post-navigation-link-$navigation_type"; if ( isset( $attributes['textAlign'] ) ) { $classes .= " has-text-align-{$attributes['textAlign']}"; } $wrapper_attributes = get_block_wrapper_attributes( array( 'class' => $classes, ) ); // Set default values. $format = '%link'; $link = 'next' === $navigation_type ? _x( 'Next', 'label for next post link' ) : _x( 'Previous', 'label for previous post link' ); $label = ''; // Only use hardcoded values here, otherwise we need to add escaping where these values are used. $arrow_map = array( 'none' => '', 'arrow' => array( 'next' => '→', 'previous' => '←', ), 'chevron' => array( 'next' => '»', 'previous' => '«', ), ); // If a custom label is provided, make this a link. // `$label` is used to prepend the provided label, if we want to show the page title as well. if ( isset( $attributes['label'] ) && ! empty( $attributes['label'] ) ) { $label = "{$attributes['label']}"; $link = $label; } // If we want to also show the page title, make the page title a link and prepend the label. if ( isset( $attributes['showTitle'] ) && $attributes['showTitle'] ) { /* * If the label link option is not enabled but there is a custom label, * display the custom label as text before the linked title. */ if ( ! $attributes['linkLabel'] ) { if ( $label ) { $format = '<span class="post-navigation-link__label">' . wp_kses_post( $label ) . '</span> %link'; } $link = '%title'; } elseif ( isset( $attributes['linkLabel'] ) && $attributes['linkLabel'] ) { // If the label link option is enabled and there is a custom label, display it before the title. if ( $label ) { $link = '<span class="post-navigation-link__label">' . wp_kses_post( $label ) . '</span> <span class="post-navigation-link__title">%title</span>'; } else { /* * If the label link option is enabled and there is no custom label, * add a colon between the label and the post title. */ $label = 'next' === $navigation_type ? _x( 'Next:', 'label before the title of the next post' ) : _x( 'Previous:', 'label before the title of the previous post' ); $link = sprintf( '<span class="post-navigation-link__label">%1$s</span> <span class="post-navigation-link__title">%2$s</span>', wp_kses_post( $label ), '%title' ); } } } // Display arrows. if ( isset( $attributes['arrow'] ) && 'none' !== $attributes['arrow'] && isset( $arrow_map[ $attributes['arrow'] ] ) ) { $arrow = $arrow_map[ $attributes['arrow'] ][ $navigation_type ]; if ( 'next' === $navigation_type ) { $format = '%link<span class="wp-block-post-navigation-link__arrow-next is-arrow-' . $attributes['arrow'] . '" aria-hidden="true">' . $arrow . '</span>'; } else { $format = '<span class="wp-block-post-navigation-link__arrow-previous is-arrow-' . $attributes['arrow'] . '" aria-hidden="true">' . $arrow . '</span>%link'; } } /* * The dynamic portion of the function name, `$navigation_type`, * Refers to the type of adjacency, 'next' or 'previous'. * * @see https://developer.wordpress.org/reference/functions/get_previous_post_link/ * @see https://developer.wordpress.org/reference/functions/get_next_post_link/ */ $get_link_function = "get_{$navigation_type}_post_link"; if ( ! empty( $attributes['taxonomy'] ) ) { $content = $get_link_function( $format, $link, true, '', $attributes['taxonomy'] ); } else { $content = $get_link_function( $format, $link ); } return sprintf( '<div %1$s>%2$s</div>', $wrapper_attributes, $content ); } /** * Registers the `core/post-navigation-link` block on the server. * * @since 5.9.0 */ function register_block_core_post_navigation_link() { register_block_type_from_metadata( __DIR__ . '/post-navigation-link', array( 'render_callback' => 'render_block_core_post_navigation_link', ) ); } add_action( 'init', 'register_block_core_post_navigation_link' );
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
archives | Folder | 0755 |
|
|
audio | Folder | 0755 |
|
|
avatar | Folder | 0755 |
|
|
block | Folder | 0755 |
|
|
button | Folder | 0755 |
|
|
buttons | Folder | 0755 |
|
|
calendar | Folder | 0755 |
|
|
categories | Folder | 0755 |
|
|
code | Folder | 0755 |
|
|
column | Folder | 0755 |
|
|
columns | Folder | 0755 |
|
|
comment-author-name | Folder | 0755 |
|
|
comment-content | Folder | 0755 |
|
|
comment-date | Folder | 0755 |
|
|
comment-edit-link | Folder | 0755 |
|
|
comment-reply-link | Folder | 0755 |
|
|
comment-template | Folder | 0755 |
|
|
comments | Folder | 0755 |
|
|
comments-pagination | Folder | 0755 |
|
|
comments-pagination-next | Folder | 0755 |
|
|
comments-pagination-numbers | Folder | 0755 |
|
|
comments-pagination-previous | Folder | 0755 |
|
|
comments-title | Folder | 0755 |
|
|
cover | Folder | 0755 |
|
|
details | Folder | 0755 |
|
|
embed | Folder | 0755 |
|
|
file | Folder | 0755 |
|
|
footnotes | Folder | 0755 |
|
|
freeform | Folder | 0755 |
|
|
gallery | Folder | 0755 |
|
|
group | Folder | 0755 |
|
|
heading | Folder | 0755 |
|
|
home-link | Folder | 0755 |
|
|
html | Folder | 0755 |
|
|
image | Folder | 0755 |
|
|
latest-comments | Folder | 0755 |
|
|
latest-posts | Folder | 0755 |
|
|
legacy-widget | Folder | 0755 |
|
|
list | Folder | 0755 |
|
|
list-item | Folder | 0755 |
|
|
loginout | Folder | 0755 |
|
|
media-text | Folder | 0755 |
|
|
missing | Folder | 0755 |
|
|
more | Folder | 0755 |
|
|
navigation | Folder | 0755 |
|
|
navigation-link | Folder | 0755 |
|
|
navigation-submenu | Folder | 0755 |
|
|
nextpage | Folder | 0755 |
|
|
page-list | Folder | 0755 |
|
|
page-list-item | Folder | 0755 |
|
|
paragraph | Folder | 0755 |
|
|
pattern | Folder | 0755 |
|
|
post-author | Folder | 0755 |
|
|
post-author-biography | Folder | 0755 |
|
|
post-author-name | Folder | 0755 |
|
|
post-comments-form | Folder | 0755 |
|
|
post-content | Folder | 0755 |
|
|
post-date | Folder | 0755 |
|
|
post-excerpt | Folder | 0755 |
|
|
post-featured-image | Folder | 0755 |
|
|
post-navigation-link | Folder | 0755 |
|
|
post-template | Folder | 0755 |
|
|
post-terms | Folder | 0755 |
|
|
post-title | Folder | 0755 |
|
|
preformatted | Folder | 0755 |
|
|
pullquote | Folder | 0755 |
|
|
query | Folder | 0755 |
|
|
query-no-results | Folder | 0755 |
|
|
query-pagination | Folder | 0755 |
|
|
query-pagination-next | Folder | 0755 |
|
|
query-pagination-numbers | Folder | 0755 |
|
|
query-pagination-previous | Folder | 0755 |
|
|
query-title | Folder | 0755 |
|
|
quote | Folder | 0755 |
|
|
read-more | Folder | 0755 |
|
|
rss | Folder | 0755 |
|
|
search | Folder | 0755 |
|
|
separator | Folder | 0755 |
|
|
shortcode | Folder | 0755 |
|
|
site-logo | Folder | 0755 |
|
|
site-tagline | Folder | 0755 |
|
|
site-title | Folder | 0755 |
|
|
social-link | Folder | 0755 |
|
|
social-links | Folder | 0755 |
|
|
spacer | Folder | 0755 |
|
|
table | Folder | 0755 |
|
|
tag-cloud | Folder | 0755 |
|
|
template-part | Folder | 0755 |
|
|
term-description | Folder | 0755 |
|
|
text-columns | Folder | 0755 |
|
|
verse | Folder | 0755 |
|
|
video | Folder | 0755 |
|
|
widget-group | Folder | 0755 |
|
|
archives.php | File | 2.92 KB | 0644 |
|
avatar.php | File | 5.61 KB | 0644 |
|
block.php | File | 3.13 KB | 0644 |
|
blocks-json.php | File | 182.84 KB | 0644 |
|
button.php | File | 1.76 KB | 0644 |
|
calendar.php | File | 5.93 KB | 0644 |
|
categories.php | File | 3.92 KB | 0644 |
|
comment-author-name.php | File | 2.08 KB | 0644 |
|
comment-content.php | File | 2.4 KB | 0644 |
|
comment-date.php | File | 1.82 KB | 0644 |
|
comment-edit-link.php | File | 1.67 KB | 0644 |
|
comment-reply-link.php | File | 2.03 KB | 0644 |
|
comment-template.php | File | 4.39 KB | 0644 |
|
comments-pagination-next.php | File | 1.88 KB | 0644 |
|
comments-pagination-numbers.php | File | 1.59 KB | 0644 |
|
comments-pagination-previous.php | File | 1.75 KB | 0644 |
|
comments-pagination.php | File | 1.17 KB | 0644 |
|
comments-title.php | File | 2.71 KB | 0644 |
|
comments.php | File | 6.61 KB | 0644 |
|
cover.php | File | 3.04 KB | 0644 |
|
file.php | File | 1.75 KB | 0644 |
|
footnotes.php | File | 3.68 KB | 0644 |
|
gallery.php | File | 6.29 KB | 0644 |
|
heading.php | File | 1.27 KB | 0644 |
|
home-link.php | File | 5.6 KB | 0644 |
|
image.php | File | 11.82 KB | 0644 |
|
index.php | File | 4.99 KB | 0644 |
|
latest-comments.php | File | 4.92 KB | 0644 |
|
latest-posts.php | File | 8.34 KB | 0644 |
|
legacy-widget.php | File | 3.9 KB | 0644 |
|
list.php | File | 1.24 KB | 0644 |
|
loginout.php | File | 1.38 KB | 0644 |
|
media-text.php | File | 4.28 KB | 0644 |
|
navigation-link.php | File | 13.21 KB | 0644 |
|
navigation-submenu.php | File | 9.09 KB | 0644 |
|
navigation.php | File | 57.9 KB | 0644 |
|
page-list-item.php | File | 361 B | 0644 |
|
page-list.php | File | 13.29 KB | 0644 |
|
pattern.php | File | 2.14 KB | 0644 |
|
post-author-biography.php | File | 1.49 KB | 0644 |
|
post-author-name.php | File | 1.78 KB | 0644 |
|
post-author.php | File | 2.54 KB | 0644 |
|
post-comments-form.php | File | 2.74 KB | 0644 |
|
post-content.php | File | 2.11 KB | 0644 |
|
post-date.php | File | 3.05 KB | 0644 |
|
post-excerpt.php | File | 3.37 KB | 0644 |
|
post-featured-image.php | File | 9.14 KB | 0644 |
|
post-navigation-link.php | File | 4.72 KB | 0644 |
|
post-template.php | File | 5.61 KB | 0644 |
|
post-terms.php | File | 3.6 KB | 0644 |
|
post-title.php | File | 2.09 KB | 0644 |
|
query-no-results.php | File | 1.8 KB | 0644 |
|
query-pagination-next.php | File | 3.7 KB | 0644 |
|
query-pagination-numbers.php | File | 4.66 KB | 0644 |
|
query-pagination-previous.php | File | 3.1 KB | 0644 |
|
query-pagination.php | File | 1.15 KB | 0644 |
|
query-title.php | File | 2.05 KB | 0644 |
|
query.php | File | 5.56 KB | 0644 |
|
read-more.php | File | 1.79 KB | 0644 |
|
require-dynamic-blocks.php | File | 4.01 KB | 0644 |
|
require-static-blocks.php | File | 501 B | 0644 |
|
rss.php | File | 3.88 KB | 0644 |
|
search.php | File | 22.51 KB | 0644 |
|
shortcode.php | File | 735 B | 0644 |
|
site-logo.php | File | 6.19 KB | 0644 |
|
site-tagline.php | File | 1.17 KB | 0644 |
|
site-title.php | File | 1.77 KB | 0644 |
|
social-link.php | File | 62.67 KB | 0644 |
|
tag-cloud.php | File | 1.55 KB | 0644 |
|
template-part.php | File | 9.86 KB | 0644 |
|
term-description.php | File | 1.3 KB | 0644 |
|
widget-group.php | File | 2.38 KB | 0644 |
|