| Dir : /home/ngamzghe/hexomodo.com/wp-content__92e43fe/themes/genesis/lib/structure/ |
| Server: Linux server1.ngambekcore.com 4.18.0-553.51.1.el8_10.x86_64 #1 SMP Wed Apr 30 04:00:07 EDT 2025 x86_64 IP: 159.198.77.92 |
| Dir : /home/ngamzghe/hexomodo.com/wp-content__92e43fe/themes/genesis/lib/structure/post.php |
<?php
/**
* Genesis Framework.
*
* WARNING: This file is part of the core Genesis Framework. DO NOT edit this file under any circumstances.
* Please do all modifications in the form of a child theme.
*
* @package Genesis\Entry
* @author StudioPress
* @license GPL-2.0-or-later
* @link https://my.studiopress.com/themes/genesis/
*/
/**
* Restore all default post loop output by re-hooking all default functions.
*
* Useful in the event that you need to unhook something in a particular context, but don't want to restore it for all
* subsequent loop instances.
*
* Calls `genesis_reset_loops` action after everything has been re-hooked.
*
* @since 1.5.0
*
* @global array $_genesis_loop_args Associative array for grid loop configuration.
*/
function genesis_reset_loops() {
// HTML5 Hooks.
add_action( 'genesis_entry_header', 'genesis_do_post_format_image', 4 );
add_action( 'genesis_entry_header', 'genesis_entry_header_markup_open', 5 );
add_action( 'genesis_entry_header', 'genesis_entry_header_markup_close', 15 );
add_action( 'genesis_entry_header', 'genesis_do_post_title' );
add_action( 'genesis_entry_header', 'genesis_post_info', 12 );
add_action( 'genesis_entry_content', 'genesis_do_post_image', 8 );
add_action( 'genesis_entry_content', 'genesis_do_post_content' );
add_action( 'genesis_entry_content', 'genesis_do_post_content_nav', 12 );
add_action( 'genesis_entry_content', 'genesis_do_post_permalink', 14 );
add_action( 'genesis_entry_footer', 'genesis_entry_footer_markup_open', 5 );
add_action( 'genesis_entry_footer', 'genesis_entry_footer_markup_close', 15 );
add_action( 'genesis_entry_footer', 'genesis_post_meta' );
add_action( 'genesis_after_entry', 'genesis_do_author_box_single', 8 );
add_action( 'genesis_after_entry', 'genesis_adjacent_entry_nav' );
add_action( 'genesis_after_entry', 'genesis_get_comments_template' );
// Other.
add_action( 'genesis_loop_else', 'genesis_do_noposts' );
add_action( 'genesis_after_endwhile', 'genesis_posts_nav' );
// Reset loop args.
global $_genesis_loop_args;
$_genesis_loop_args = [];
/**
* Fires after resetting the loop actions back to their defaults.
*
* @since 1.6.0
*/
do_action( 'genesis_reset_loops' );
}
add_filter( 'post_class', 'genesis_entry_post_class' );
/**
* Add `entry` post class, remove `hentry` post class if HTML5.
*
* @since 1.9.0
*
* @param array $classes Existing post classes.
* @return array Amended post classes. Not modified if in WP admin, or doing Ajax request.
*/
function genesis_entry_post_class( $classes ) {
if ( ! ( defined( 'DOING_AJAX' ) && DOING_AJAX ) && is_admin() ) {
return $classes;
}
// Add "entry" to the post class array.
$classes[] = 'entry';
$classes = array_diff( $classes, [ 'hentry' ] );
return $classes;
}
add_filter( 'post_class', 'genesis_custom_post_class', 15 );
/**
* Add a custom post class, saved as a custom field.
*
* @since 1.4.0
*
* @param array $classes Existing post classes.
* @return array Amended post classes. Not modified if in WP admin.
*/
function genesis_custom_post_class( array $classes ) {
if ( is_admin() ) {
return $classes;
}
$new_class = genesis_get_custom_field( '_genesis_custom_post_class' );
if ( $new_class ) {
$classes[] = esc_attr( $new_class );
}
return $classes;
}
add_filter( 'post_class', 'genesis_featured_image_post_class' );
/**
* Featured Image Post Class
*
* @since 2.2.0
*
* @param array $classes Existing post classes.
* @return array Amended post classes. Not modified if in WP admin.
*/
function genesis_featured_image_post_class( $classes ) {
if ( is_admin() ) {
return $classes;
}
$image = genesis_get_image();
if ( $image && ! is_singular() && genesis_get_option( 'content_archive_thumbnail' ) && ! in_array( 'has-post-thumbnail', $classes, true ) ) {
$classes[] = 'has-post-thumbnail';
}
return $classes;
}
add_action( 'genesis_entry_header', 'genesis_do_post_format_image', 4 );
/**
* Add a post format icon.
*
* Adds an image, corresponding to the post format, before the post title.
*
* @since 1.4.0
*
* @return void Return early if `post-formats` or `genesis-post-format-images` are not supported.
*/
function genesis_do_post_format_image() {
// Do nothing if post formats aren't supported.
if ( ! current_theme_supports( 'post-formats' ) || ! current_theme_supports( 'genesis-post-format-images' ) ) {
return;
}
// Get post format.
$post_format = get_post_format();
if ( $post_format && file_exists( sprintf( '%s/images/post-formats/%s.png', CHILD_DIR, $post_format ) ) ) {
// If post format is set, look for post format image.
printf( '<a href="%s" rel="bookmark"><img src="%s" class="post-format-image" alt="%s" /></a>', esc_url( get_permalink() ), sprintf( '%s/images/post-formats/%s.png', esc_url( CHILD_URL ), esc_html( $post_format ) ), esc_html( $post_format ) );
} elseif ( file_exists( sprintf( '%s/images/post-formats/default.png', CHILD_DIR ) ) ) {
// Else, look for the default post format image.
printf( '<a href="%s" rel="bookmark"><img src="%s/images/post-formats/default.png" class="post-format-image" alt="%s" /></a>', esc_url( get_permalink() ), esc_url( CHILD_URL ), 'post' );
}
}
/**
* Is the entry header hidden for the current page?
*
* Indicates that the “Hide title” checkbox is enabled and checked.
*
* @since 3.1.0
*
* @return bool True if title is hidden, false otherwise.
*/
function genesis_entry_header_hidden_on_current_page() {
/**
* Override hide title state for the current page.
*
* @since 3.1.0
*
* @param bool $genesis_title_hidden True to hide title, false to show it.
*/
$genesis_title_hidden = apply_filters( 'genesis_title_hidden', null );
if ( is_bool( $genesis_title_hidden ) ) {
return $genesis_title_hidden;
}
// The “hide title” option is currently offered on singulars
// and on the blog posts page.
if ( ! is_singular() && ! ( is_home() && ! is_front_page() ) ) {
return false;
}
/**
* Prevents the “hide title” checkbox from appearing or functioning by returning false.
*
* @since 3.1.0
*
* @param bool $title_toggle_enabled True if title toggle is enabled, false otherwise.
*/
$title_toggle_enabled = apply_filters( 'genesis_title_toggle_enabled', true );
if ( ! $title_toggle_enabled ) {
return false;
}
return get_post_meta( get_queried_object_id(), '_genesis_hide_title', true );
}
add_action( 'genesis_entry_header', 'genesis_entry_header_markup_open', 5 );
/**
* Echo the opening structural markup for the entry header.
*
* @since 3.1.0 Suppress output if “hide title” checkbox is ticked.
* @since 2.0.0
*/
function genesis_entry_header_markup_open() {
if ( ! is_home() && genesis_entry_header_hidden_on_current_page() ) {
return;
}
printf( '<header %s>', genesis_attr( 'entry-header' ) );
}
add_action( 'genesis_entry_header', 'genesis_entry_header_markup_close', 15 );
/**
* Echo the closing structural markup for the entry header.
*
* @since 3.1.0 Suppress output if “hide title” checkbox is ticked.
* @since 2.0.0
*/
function genesis_entry_header_markup_close() {
if ( ! is_home() && genesis_entry_header_hidden_on_current_page() ) {
return;
}
echo '</header>';
}
add_action( 'genesis_entry_header', 'genesis_do_post_title' );
/**
* Echo the title of a post.
*
* The `genesis_post_title_text` filter is applied on the text of the title, while the `genesis_post_title_output`
* filter is applied on the echoed markup.
*
* @since 3.1.0 Suppress output if “hide title” checkbox is ticked.
* @since 1.1.0
*
* @return void Return early if the filtered trimmed title is an empty string.
*/
function genesis_do_post_title() {
if ( ! is_home() && genesis_entry_header_hidden_on_current_page() ) {
return;
}
$title = apply_filters( 'genesis_post_title_text', get_the_title() );
if ( '' === trim( $title ) ) {
return;
}
// Link it, if necessary.
if ( ! is_singular() && apply_filters( 'genesis_link_post_title', true ) ) {
$title = genesis_markup(
[
'open' => '<a %s>',
'close' => '</a>',
'content' => $title,
'context' => 'entry-title-link',
'echo' => false,
]
);
}
// Wrap in H1 on singular pages.
$wrap = is_singular() ? 'h1' : 'h2';
// Also, if HTML5 with semantic headings, wrap in H1.
$wrap = genesis_get_seo_option( 'semantic_headings' ) ? 'h1' : $wrap;
// Wrap in H2 on static homepages if Primary Title H1 is set to title or description.
if (
is_front_page()
&& ! is_home()
&& genesis_seo_active()
&& 'neither' !== genesis_get_seo_option( 'home_h1_on' )
) {
$wrap = 'h2';
}
/**
* Entry title wrapping element.
*
* The wrapping element for the entry title.
*
* @since 2.2.3
*
* @param string $wrap The wrapping element (h1, h2, p, etc.).
*/
$wrap = apply_filters( 'genesis_entry_title_wrap', $wrap );
// Build the output.
$output = genesis_markup(
[
'open' => "<{$wrap} %s>",
'close' => "</{$wrap}>",
'content' => $title,
'context' => 'entry-title',
'params' => [
'wrap' => $wrap,
],
'echo' => false,
]
);
echo apply_filters( 'genesis_post_title_output', $output, $wrap, $title ) . "\n"; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- title output is left unescaped to accommodate trusted user input. See https://codex.wordpress.org/Function_Reference/the_title#Security_considerations.
}
add_filter( 'genesis_post_info', 'do_shortcode', 20 );
add_action( 'genesis_entry_header', 'genesis_post_info', 12 );
/**
* Echo the post info (byline) under the post title.
*
* By default, only does post info on posts.
*
* The post info makes use of several shortcodes by default, and the whole output
* is filtered via `genesis_post_info` before echoing.
*
* @since 1.0.0
*
* @return void Return early if post type lacks support for `genesis-entry-meta-before-content`.
*/
function genesis_post_info() {
if ( ! post_type_supports( get_post_type(), 'genesis-entry-meta-before-content' ) ) {
return;
}
$post_info = wp_kses_post( genesis_get_option( 'entry_meta_before_content' ) );
$filtered = apply_filters( 'genesis_post_info', $post_info );
if ( '' === trim( $filtered ) ) {
return;
}
genesis_markup(
[
'open' => '<p %s>',
'close' => '</p>',
'content' => genesis_strip_p_tags( $filtered ),
'context' => 'entry-meta-before-content',
]
);
}
add_action( 'genesis_entry_content', 'genesis_do_post_image', 8 );
/**
* Echo the post image on archive pages.
*
* If this an archive page and the option is set to show thumbnail, then it gets the image size as per the theme
* setting, wraps it in the post permalink and echoes it.
*
* @since 1.1.0
*/
function genesis_do_post_image() {
if ( ! is_singular() && genesis_get_option( 'content_archive_thumbnail' ) ) {
$img = genesis_get_image(
[
'format' => 'html',
'size' => genesis_get_option( 'image_size' ),
'context' => 'archive',
'attr' => genesis_parse_attr( 'entry-image', [] ),
]
);
if ( ! empty( $img ) ) {
genesis_markup(
[
'open' => '<a %s>',
'close' => '</a>',
'content' => $img,
'context' => 'entry-image-link',
]
);
}
}
}
/**
* Gets the singular image for the current post.
*
* Applies the `genesis_singular_image_size` filter.
*
* @since 3.1.1.
*
* @return string|bool Singular image element HTML or `false`.
*/
function genesis_get_singular_image() {
$post_type = get_post_type();
$sizes = genesis_get_image_sizes();
$size = ( isset( $sizes[ "genesis-singular-image-{$post_type}" ] ) ) ? "genesis-singular-image-{$post_type}" : 'genesis-singular-images';
if ( 'genesis-singular-images' === $size && ! isset( $sizes['genesis-singular-images'] ) ) {
$size = genesis_get_option( 'image_size' );
}
/**
* Overrides the singular image size.
*
* @since 3.1.1 Pass $post_type as additional argument.
* @since 3.1.0
*
* @param string $size The image size to use for the singular image.
*/
$size = apply_filters( 'genesis_singular_image_size', $size, $post_type );
return genesis_get_image(
[
'format' => 'html',
'size' => $size,
'attr' => genesis_parse_attr( 'singular-entry-image', [] ),
]
);
}
add_action( 'genesis_entry_content', 'genesis_do_singular_image', 8 );
/**
* Echoes the post image on singular pages.
*
* If this is a singular page and the option is set to show the features image, then it gets the image size
* as per the post type supports and echoes it.
*
* @since 3.1.0
*/
function genesis_do_singular_image() {
if ( ! is_singular() ) {
return;
}
if ( genesis_singular_image_hidden_on_current_page() ) {
return;
}
$img = genesis_get_singular_image();
if ( ! empty( $img ) ) {
genesis_markup(
[
'content' => $img,
'context' => 'singular-entry-image',
]
);
}
}
add_action( 'genesis_entry_content', 'genesis_do_post_content' );
/**
* Echo the post content.
*
* On single posts or pages it echoes the full content, and optionally the trackback string if enabled. On single pages,
* also adds the edit link after the content.
*
* Elsewhere it displays either the excerpt, limited content, or full content.
*
* Applies the `genesis_edit_post_link` filter.
*
* @since 1.1.0
*/
function genesis_do_post_content() {
if ( is_singular() ) {
the_content();
if ( is_single() && 'open' === get_option( 'default_ping_status' ) && post_type_supports( get_post_type(), 'trackbacks' ) ) {
echo '<!--';
trackback_rdf();
echo '-->' . "\n";
}
if ( is_page() && apply_filters( 'genesis_edit_post_link', true ) ) {
edit_post_link( __( '(Edit)', 'genesis' ), '', '' );
}
return;
}
if ( 'excerpts' === genesis_get_option( 'content_archive' ) ) {
the_excerpt();
return;
}
/**
* Filters the more text used with the_content_limit() and the_content.
*
* @since 2.7.0
*
* @param string $more_text The more text after going through genesis_a11y_more_link().
*/
$more_text = apply_filters( 'genesis_more_text', genesis_a11y_more_link( __( '[Read more...]', 'genesis' ) ) );
if ( genesis_get_option( 'content_archive_limit' ) ) {
the_content_limit( (int) genesis_get_option( 'content_archive_limit' ), $more_text );
return;
}
the_content( $more_text );
}
add_action( 'genesis_entry_content', 'genesis_do_post_content_nav', 12 );
/**
* Display page links for paginated posts (i.e. includes the <!--nextpage--> Quicktag one or more times).
*
* @since 2.0.0
*/
function genesis_do_post_content_nav() {
wp_link_pages(
[
'before' => genesis_markup(
[
'open' => '<div %s>',
'context' => 'entry-pagination',
'echo' => false,
]
) . __( 'Pages:', 'genesis' ),
'after' => genesis_markup(
[
'close' => '</div>',
'context' => 'entry-pagination',
'echo' => false,
]
),
'link_before' => genesis_a11y() ? '<span class="screen-reader-text">' . __( 'Page ', 'genesis' ) . '</span>' : '',
]
);
}
add_action( 'genesis_entry_content', 'genesis_do_post_permalink', 14 );
/**
* Show permalink if no title.
*
* If the entry has no title, this is a way to display a link to the full post.
*
* Applies the `genesis_post_permalink` filter.
*
* @since 2.0.0
*/
function genesis_do_post_permalink() {
// Don't show on singular views, or if the entry has a title.
if ( is_singular() || get_the_title() ) {
return;
}
$permalink = get_permalink();
$output = wp_kses_post(
sprintf(
'<p class="entry-permalink"><a href="%s" rel="bookmark">%s</a></p>',
esc_url( $permalink ),
esc_html( $permalink )
)
);
/**
* Entry permalink filter.
*
* Allows you to filter the entry permalink.
*
* @since ???
*
* @param string $output Assembled permalink.
*/
$output = apply_filters( 'genesis_post_permalink', $output );
echo $output; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- sanitize done prior to filter application
}
add_action( 'genesis_loop_else', 'genesis_do_noposts' );
/**
* Echo filterable content when there are no posts to show.
*
* The applied filter is `genesis_noposts_text`.
*
* @since 1.1.0
*/
function genesis_do_noposts() {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Text Produced by a third party
printf( '<div class="entry"><p>%s</p></div>', apply_filters( 'genesis_noposts_text', __( 'Sorry, no content matched your criteria.', 'genesis' ) ) );
}
add_action( 'genesis_entry_footer', 'genesis_entry_footer_markup_open', 5 );
/**
* Echo the opening structural markup for the entry footer.
*
* @since 2.0.0
*/
function genesis_entry_footer_markup_open() {
if ( post_type_supports( get_post_type(), 'genesis-entry-meta-after-content' ) ) {
printf( '<footer %s>', genesis_attr( 'entry-footer' ) );
}
}
add_action( 'genesis_entry_footer', 'genesis_entry_footer_markup_close', 15 );
/**
* Echo the closing structural markup for the entry footer.
*
* @since 2.0.0
*/
function genesis_entry_footer_markup_close() {
if ( post_type_supports( get_post_type(), 'genesis-entry-meta-after-content' ) ) {
echo '</footer>';
}
}
add_filter( 'genesis_post_meta', 'do_shortcode', 20 );
add_action( 'genesis_entry_footer', 'genesis_post_meta' );
/**
* Echo the post meta after the post content.
*
* By default, does post meta on all public post types except page.
*
* The post info makes use of a couple of shortcodes by default, and the whole output is filtered via
* `genesis_post_meta` before echoing.
*
* @since 1.0.0
*
* @return void Return early if post type lacks support for `genesis-entry-meta-after-content`.
*/
function genesis_post_meta() {
if ( ! post_type_supports( get_post_type(), 'genesis-entry-meta-after-content' ) ) {
return;
}
$post_meta = wp_kses_post( genesis_get_option( 'entry_meta_after_content' ) );
$filtered = apply_filters( 'genesis_post_meta', $post_meta );
if ( '' === trim( $filtered ) ) {
return;
}
genesis_markup(
[
'open' => '<p %s>',
'close' => '</p>',
'content' => genesis_strip_p_tags( $filtered ),
'context' => 'entry-meta-after-content',
]
);
}
add_action( 'genesis_after_entry', 'genesis_do_author_box_single', 8 );
/**
* Conditionally add the author box after single posts or pages.
*
* @since 1.0.0
*
* @return void Return early if not a single post or page, or post type does not support `author`.
*/
function genesis_do_author_box_single() {
if ( ! is_single() || ! post_type_supports( get_post_type(), 'author' ) ) {
return;
}
if ( get_the_author_meta( 'genesis_author_box_single', get_the_author_meta( 'ID' ) ) ) {
genesis_author_box( 'single' );
}
}
/**
* Return the author box and its contents.
*
* @since 2.7.0
*
* @global WP_User $authordata Author (user) object.
*
* @param string $context Optional. Allows different author box markup for different contexts, specifically 'single'.
* Default is empty string.
* @return string HTML for author box.
*/
function genesis_get_author_box( $context = '' ) {
global $authordata;
$user_id = is_object( $authordata ) ? $authordata->ID : (int) get_query_var( 'author' );
return genesis_get_author_box_by_user( $user_id, $context );
}
/**
* Return the author box and its contents by WP_User ID.
*
* The title is filterable via `genesis_author_box_title`,
* the description is filterable via `genesis_author_box_description`,
* and the gravatar size is filterable via `genesis_author_box_gravatar_size`.
*
* The final output is filterable via `genesis_author_box`, which passes many variables through.
*
* @since 2.7.0
*
* @param int $user_id Required. The user ID to get the author box from.
* @param string $context Optional. Allows different author box markup for different contexts, specifically 'single'.
* Default is empty string.
* @return string HTML for author box.
*/
function genesis_get_author_box_by_user( $user_id, $context = '' ) {
$gravatar_size = apply_filters( 'genesis_author_box_gravatar_size', 70, $context, $user_id );
$gravatar = get_avatar( get_the_author_meta( 'email', $user_id ), $gravatar_size );
$description = apply_filters( 'genesis_author_box_description', wpautop( get_the_author_meta( 'description', $user_id ) ), $context, $user_id );
// The author box markup, contextual.
$title = __( 'About', 'genesis' ) . ' <span itemprop="name">' . get_the_author_meta( 'display_name', $user_id ) . '</span>';
/**
* Author box title filter.
*
* Allows you to filter the title of the author box. $context passed as second parameter to allow for contextual filtering.
*
* @since unknown
*
* @param string $title Assembled Title.
* @param string $context Context.
* @param int $user_id User ID.
*/
$title = apply_filters( 'genesis_author_box_title', $title, $context, $user_id );
$heading_element = 'h1';
if ( 'archive' === $context ) {
$heading_element = 'h2';
} elseif ( 'single' === $context && ! genesis_get_seo_option( 'semantic_headings' ) ) {
$heading_element = 'h4';
} elseif ( genesis_a11y( 'headings' ) || get_the_author_meta( 'headline', $user_id ) ) {
$heading_element = 'h4';
}
$pattern = sprintf( '<section %s>', genesis_attr( 'author-box' ) );
$pattern .= '%s<' . $heading_element . ' class="author-box-title">%s</' . $heading_element . '>';
$pattern .= '<div class="author-box-content" itemprop="description">%s</div>';
$pattern .= '</section>';
$output = sprintf( $pattern, $gravatar, $title, $description );
/**
* Author box output filter.
*
* Allows you to filter the full output of the author box.
*
* @since unknown
*
* @param string $output Assembled output.
* @param string $context Context.
* @param string $pattern (s)printf pattern.
* @param string $gravatar Gravatar.
* @param string $title Title.
* @param string $description Description.
* @param int $user_id User ID.
*/
$output = apply_filters( 'genesis_author_box', $output, $context, $pattern, $gravatar, $title, $description, $user_id );
return $output;
}
/**
* Echo the author box and its contents.
*
* The title is filterable via `genesis_author_box_title`, and the gravatar size is filterable via
* `genesis_author_box_gravatar_size`.
*
* The final output is filterable via `genesis_author_box`, which passes many variables through.
*
* @since 1.3.0
* @since 2.7.0 Logic moved to `genesis_get_author_box()` and second parameter deprecated.
*
* @param string $context Optional. Allows different author box markup for different contexts, specifically 'single'.
* Default is empty string.
* @param bool $deprecated Deprecated.
* @return string HTML for author box if `$deprecated` param is falsy.
*/
function genesis_author_box( $context = '', $deprecated = null ) {
if ( null !== $deprecated ) {
$message = __( 'The default is true, so remove the second argument.', 'genesis' );
if ( false === (bool) $deprecated ) {
$message = __( 'Use `genesis_get_author_box()` instead.', 'genesis' );
}
_deprecated_argument( __FUNCTION__, '2.7.0', esc_html( $message ) );
}
$output = genesis_get_author_box( $context );
// Apply original default value.
$deprecated = null === $deprecated ? true : $deprecated;
if ( false === (bool) $deprecated ) { // Kept for backwards compatibility.
return $output;
}
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo $output;
}
add_action( 'genesis_after_entry', 'genesis_after_entry_widget_area' );
/**
* Display after-entry widget area on the genesis_after_entry action hook.
*
* @since 2.1.0
*
* @return void Return early if not singular, or post type does not support after entry widget area.
*/
function genesis_after_entry_widget_area() {
if ( ! is_singular() || ! post_type_supports( get_post_type(), 'genesis-after-entry-widget-area' ) ) {
return;
}
genesis_widget_area(
'after-entry',
[
'before' => '<div class="after-entry widget-area">',
'after' => '</div>',
]
);
}
add_action( 'genesis_after_endwhile', 'genesis_posts_nav' );
/**
* Conditionally echo archive pagination in a format dependent on chosen setting.
*
* This is shown at the end of archives to get to another page of entries.
*
* @since 1.0.0
*/
function genesis_posts_nav() {
if ( 'numeric' === genesis_get_option( 'posts_nav' ) ) {
genesis_numeric_posts_nav();
} else {
genesis_prev_next_posts_nav();
}
}
/**
* Echo archive pagination in Previous Posts / Next Posts format.
*
* Applies `genesis_prev_link_text` and `genesis_next_link_text` filters.
*
* @since 1.0.0
*/
function genesis_prev_next_posts_nav() {
$prev_link = get_previous_posts_link( apply_filters( 'genesis_prev_link_text', '« ' . __( 'Previous Page', 'genesis' ) ) );
$next_link = get_next_posts_link( apply_filters( 'genesis_next_link_text', __( 'Next Page', 'genesis' ) . ' »' ) );
if ( $prev_link || $next_link ) {
$pagination = $prev_link ? sprintf( '<div class="pagination-previous alignleft">%s</div>', $prev_link ) : '';
$pagination .= $next_link ? sprintf( '<div class="pagination-next alignright">%s</div>', $next_link ) : '';
genesis_markup(
[
'open' => '<div %s>',
'close' => '</div>',
'content' => $pagination,
'context' => 'archive-pagination',
]
);
}
}
/**
* Echo archive pagination in page numbers format.
*
* Applies the `genesis_prev_link_text` and `genesis_next_link_text` filters.
*
* The links, if needed, are ordered as:
*
* * previous page arrow,
* * first page,
* * up to two pages before current page,
* * current page,
* * up to two pages after the current page,
* * last page,
* * next page arrow.
*
* @since 1.0.0
*
* @global WP_Query $wp_query Query object.
*
* @return void Return early if on a single post or page, or only one page exists.
*/
function genesis_numeric_posts_nav() {
if ( is_singular() ) {
return;
}
global $wp_query;
// Stop execution if there's only one page.
if ( $wp_query->max_num_pages <= 1 ) {
return;
}
$paged = get_query_var( 'paged' ) ? absint( get_query_var( 'paged' ) ) : 1;
$max = (int) $wp_query->max_num_pages;
// Add current page to the array.
if ( $paged >= 1 ) {
$links[] = $paged;
}
// Add the pages around the current page to the array.
if ( $paged >= 3 ) {
$links[] = $paged - 1;
$links[] = $paged - 2;
}
if ( ( $paged + 2 ) <= $max ) {
$links[] = $paged + 2;
$links[] = $paged + 1;
}
$atts = [
'role' => 'navigation',
'aria-label' => esc_attr__( 'Pagination', 'genesis' ),
];
genesis_markup(
[
'open' => '<div %s>',
'context' => 'archive-pagination',
'atts' => genesis_a11y() ? $atts : '',
]
);
$before_number = genesis_a11y() ? '<span class="screen-reader-text">' . __( 'Page', 'genesis' ) . '</span>' : '';
echo '<ul>';
// Previous Post Link.
if ( get_previous_posts_link() ) {
$ally_label = __( '<span class="screen-reader-text">Go to</span> Previous Page', 'genesis' );
$label = genesis_a11y() ? $ally_label : __( 'Previous Page', 'genesis' );
$link = get_previous_posts_link( apply_filters( 'genesis_prev_link_text', '« ' . $label ) );
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Value is hardcoded and safe, not set via input.
printf( '<li class="pagination-previous">%s</li>' . "\n", $link );
}
// Link to first page, plus ellipses if necessary.
if ( ! in_array( 1, $links, true ) ) {
$class = 1 === $paged ? ' class="active"' : '';
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Value is known to be safe, not set via input.
printf( '<li%s><a href="%s">%s</a></li>' . "\n", $class, get_pagenum_link( 1 ), trim( $before_number . ' 1' ) );
if ( ! in_array( 2, $links, true ) ) {
$a11y_label = sprintf( '<span class="screen-reader-text">%s</span> …', __( 'Interim pages omitted', 'genesis' ) );
$label = genesis_a11y() ? $a11y_label : '…';
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Value is known to be safe, not set via input.
printf( '<li class="pagination-omission">%s</li> ' . "\n", $label );
}
}
// Link to current page, plus 2 pages in either direction if necessary.
sort( $links );
foreach ( (array) $links as $link ) {
$class = '';
$aria = '';
if ( $paged === $link ) {
$class = ' class="active" ';
$aria = ' aria-current="page"';
}
printf(
'<li%s><a href="%s"%s>%s</a></li>' . "\n",
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Value is safe, not set via input.
$class,
esc_url( get_pagenum_link( $link ) ),
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Value is safe, not set via input.
$aria,
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Value is safe, not set via input.
trim( $before_number . ' ' . $link )
);
}
// Link to last page, plus ellipses if necessary.
if ( ! in_array( $max, $links, true ) ) {
if ( ! in_array( $max - 1, $links, true ) ) {
$a11y_label = sprintf( '<span class="screen-reader-text">%s</span> …', __( 'Interim pages omitted', 'genesis' ) );
$label = genesis_a11y() ? $a11y_label : '…';
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Value is known to be safe, not set via input.
printf( '<li class="pagination-omission">%s</li> ' . "\n", $label );
}
$class = $paged === $max ? ' class="active"' : '';
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Value is safe, not set via input.
printf( '<li%s><a href="%s">%s</a></li>' . "\n", $class, get_pagenum_link( $max ), trim( $before_number . ' ' . $max ) );
}
// Next Post Link.
if ( get_next_posts_link() ) {
$ally_label = __( '<span class="screen-reader-text">Go to</span> Next Page', 'genesis' );
$label = genesis_a11y() ? $ally_label : __( 'Next Page', 'genesis' );
$link = get_next_posts_link( apply_filters( 'genesis_next_link_text', $label . ' »' ) );
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Value is hardcoded and safe, not set via input.
printf( '<li class="pagination-next">%s</li>' . "\n", $link );
}
echo '</ul>';
genesis_markup(
[
'close' => '</div>',
'context' => 'archive-pagination',
]
);
echo "\n";
}
add_action( 'genesis_after_entry', 'genesis_adjacent_entry_nav' );
/**
* Display links to previous and next entry.
*
* @since 2.3.0
*
* @return void Return early if not singular or post type doesn't support `genesis-adjacent-entry-nav`.
*/
function genesis_adjacent_entry_nav() {
if ( ! is_singular() || ! post_type_supports( get_post_type(), 'genesis-adjacent-entry-nav' ) ) {
return;
}
genesis_markup(
[
'open' => '<div %s>',
'context' => 'adjacent-entry-pagination',
]
);
$previous_post_text = '<span class="adjacent-post-link">« %title</span>';
if ( genesis_a11y() ) {
$previous_post_text = '<span class="screen-reader-text">' . esc_html__( 'Previous Post:', 'genesis' ) . ' </span>' . $previous_post_text;
}
genesis_markup(
[
'open' => '<div %s>',
'context' => 'pagination-previous',
'content' => get_previous_post_link( '%link', $previous_post_text ),
'close' => '</div>',
]
);
$next_post_text = '<span class="adjacent-post-link">%title »</span>';
if ( genesis_a11y() ) {
$next_post_text = '<span class="screen-reader-text">' . esc_html__( 'Next Post:', 'genesis' ) . ' </span>' . $next_post_text;
}
genesis_markup(
[
'open' => '<div %s>',
'context' => 'pagination-next',
'content' => get_next_post_link( '%link', $next_post_text ),
'close' => '</div>',
]
);
genesis_markup(
[
'close' => '</div>',
'context' => 'adjacent-entry-pagination',
]
);
}
/**
* Helper function to display adjacent entry navigation on single posts. Must be hooked to `genesis_after_entry` at priority 10 or earlier to work properly.
*
* @since 1.5.1
*/
function genesis_prev_next_post_nav() {
add_post_type_support( 'post', 'genesis-adjacent-entry-nav' );
}