Lovro Hrust

<p>Plugin to support navigation by pages – similar to built in function the_posts_navigation() for posts.<br />
Pages in navigation are filtered by provided menu (Primary menu by default) and sorted in the same order as in menu.<br />
By default, main menu is used, but different menu could be used by calling function for displaying with different menu as parameter.</p>
<h3>Disclaimer!</h3>
<p>This plugin works only with classic themes. With FSE themes it will not work, since it depends on classic menus.</p>
<h3>Usage</h3>
<h4>Basic</h4>
<p>Just install and call <code>the_pages_navigation()</code> in your php template. There is also a <code>get_the_pages_navigation()</code> function which returns string with same content.<br />
Arguments to these functions could be supplied, all optional.<br />
* $menu – a menu ID, slug, name, or object (WP_Term) for which to show pages<br />
* $start_position – start position from which position in menu to start navigation<br />
? $end_position – to which position in menu to show navigation</p>
<h4>Advanced</h4>
<p>There are filters that can help to customize plugin output.</p>
<p>Change menu filter</p>
<pre><code>apply_filters('page_nav_menu', $default_menu)
</code></pre>
<p>Filters menu used for navigation.</p>
<ul>
<li>$default_menu – a menu ID, slug, name, or object (WP_Term)</li>
</ul>
<p>Arrow filters</p>
<pre><code>apply_filters( 'page_nav_left_arrow', $HTML )
apply_filters( 'page_nav_right_arrow', $HTML )
</code></pre>
<p>Filters arrow output.</p>
<ul>
<li>$HTML – HTML of arrow, coded as SVG, img or something else.</li>
</ul>
<p>Filter output</p>
<pre><code>apply_filters( 'arrow_wrapper', $HTML_output, $left, $enabled, $output_image, $output_link, $output_div, $output_text )
</code></pre>
<p>Filters whole HTML output.</p>
<ul>
<li>$HTML_output – as the name says</li>
<li>$left – output is for left side (previous)</li>
<li>$enabled – navigation on that side is enabled</li>
<li>$output_image – html of arrow image</li>
<li>$output_link – URL of link to which arrow leads</li>
<li>$output_div – wrapper of text besides arrow</li>
<li>$output_text – text besides arrow</li>
</ul>
<h4>Examples of filtering</h4>
<pre><code>add_filter( 'page_nav_left_arrow', function() {
    return '<svg width="53" height="32" viewBox="0 0 53 32" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M51.77 15.994H1M16.622 31L1 15.998 16.622 1v30z" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></svg>';
} );
</code></pre>


Page navigation by menu

Create navigation to next/previous pages similar to navigation for posts. Previous and next pages are determined from menu.

Scott Reilly

<p>This plugin adds “← Previous” and “Next →” links to the “Edit Post” admin page if a previous and next post are present, respectively. The link titles (visible when hovering over the links) reveal the title of the previous/next post. The links link to the “Edit Post” admin page for the previous/next posts so that you may edit them.</p>
<p>By default, a previous/next post is determined by the next lower/higher valid post based on the date the post was created and which is also a post the user can edit. Other post criteria such as post type (draft, pending, etc), publish date, post author, category, etc, are not taken into consideration when determining the previous or next post.</p>
<p>Users can customize how post navigation ordering is handled via the “Screen Options” panel available at the top of every page when editing a post. A dropdown presents options to order navigation by: ‘ID’, ‘menu_order’, ‘post_date’, ‘post_modified’, ‘post_name’, and ‘post_title’. Post navigation can further be customized via filters (see Filters section).</p>
<p>NOTE: Be sure to save the post currently being edited (if you’ve made any changes) before navigating away to the previous/next post!</p>
<p>Links: <a href="http://coffee2code.com/wp-plugins/admin-post-navigation/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/plugins/admin-post-navigation/" rel="ugc">Plugin Directory Page</a> | <a href="https://github.com/coffe2code/admin-post-navigation/" rel="nofollow ugc">GitHub</a> | <a href="http://coffee2code.com" rel="nofollow ugc">Author Homepage</a></p>
<h3>Filters</h3>
<p>The plugin is further customizable via six filters. Such code should ideally be put into a mu-plugin or site-specific plugin (which is beyond the scope of this readme to explain).</p>
<h4>c2c_admin_post_navigation_orderby (filter)</h4>
<p>The ‘c2c_admin_post_navigation_orderby’ filter allows you to change the post field used in the ORDER BY clause for the SQL to find the previous/next post. By default this is ‘post_date’ for non-hierarchical post types (such as posts) and ‘post_title’ for hierarchical post types (such as pages). If you wish to change this, hook this filter. Note: users can customize the post navigation order field for themselves on a per-post type basis via “Screen Options” (see FAQ and screenshot for more info).</p>
<p>Arguments:</p>
<ul>
<li>$field (string) The current ORDER BY field</li>
<li>$post_type (string) The post type being navigated</li>
<li>$user_id (int) The user’s ID</li>
</ul>
<p>Example:</p>
<pre><code>/**
 * Modify how Admin Post Navigation orders posts for navigation by changing the
 * ordering of pages by 'menu_order'.
 *
 * @param string $field     The field used to order posts for navigation.
 * @param string $post_type The post type being navigated.
 * @param int    $user_id.  The user's ID.
 * @return string
 */
function custom_order_apn( $field, $post_type, $user_id ) {
    // Only change the order for the 'page' post type.
    if ( 'page' === $post_type ) {
        $field = 'menu_order';
    }

    return $field;
}
add_filter( 'c2c_admin_post_navigation_orderby', 'custom_order_apn', 10, 3 );
</code></pre>
<h4>c2c_admin_post_navigation_post_statuses (filter)</h4>
<p>The ‘c2c_admin_post_navigation_post_statuses’ filter allows you to modify the list of post_statuses used as part of the search for the prev/next post. By default this array includes ‘draft’, ‘future’, ‘pending’, ‘private’, and ‘publish’. If you wish to change this, hook this filter. This is not typical usage for most users.</p>
<p>Arguments:</p>
<ul>
<li>$post_statuses (array) The array of valid post_statuses</li>
<li>$post_type (string) The post type</li>
</ul>
<p>Example:</p>
<pre><code>/**
 * Modify Admin Post Navigation to allow and disallow certain post statuses from being navigated.
 *
 * @param array  $post_statuses Post statuses permitted for admin navigation.
 * @param string $post_type     The post type.
 * @return array
 */
function change_apn_post_status( $post_statuses, $post_type ) {
    // Add a post status.
    // Note: by default these are already in the $post_statuses array: 'draft', 'future', 'pending', 'private', 'publish'
    $post_statuses[] = 'trash';

    // Remove post status(es).
    $post_statuses_to_remove = array( 'draft' ); // Customize here.
    if ( 'page' === $post_type ) {
        $post_statuses_to_remove[] = 'pending';
    }
    foreach ( $post_statuses_to_remove as $remove ) {
        if ( false !== $index = array_search( $remove, $post_statuses ) ) {
            unset( $post_statuses[ $index ] );
        }
    }

    return array_values( $post_statuses );
}
add_filter( 'c2c_admin_post_navigation_post_statuses', 'change_apn_post_status', 10, 2 );
</code></pre>
<h4>c2c_admin_post_navigation_post_types (filter)</h4>
<p>The ‘c2c_admin_post_navigation_post_types’ filter allows you to modify the list of post_types used as part of the search for the prev/next post. By default this array includes all available post types. If you wish to change this, hook this filter.</p>
<p>Arguments:</p>
<ul>
<li>$post_types (array) The array of valid post_types</li>
</ul>
<p>Examples:</p>
<pre><code>/**
 * Modify Admin Post Navigation to only allow navigating strictly for posts.
 *
 * @param array $post_types Post types that should have admin post navigation.
 * @return array
 */
function change_apn_post_types( $post_types ) {
    return array( 'post' );
}
add_filter( 'c2c_admin_post_navigation_post_types', 'change_apn_post_types' );



/**
 * Modify Admin Post Navigation to disallow navigation for the 'recipe' post type.
 *
 * @param array $post_types Post types that should have admin post navigation.
 * @return array
 */
function remove_recipe_apn_post_types( $post_types ) {
    if ( isset( $post_types['recipe'] ) ) {
        unset( $post_types['recipe'] ); // Removing a post type
    }
    return $post_types;
}
add_filter( 'c2c_admin_post_navigation_post_types', 'remove_recipe_apn_post_types' );
</code></pre>
<h4>c2c_admin_post_navigation_prev_text (filter)</h4>
<p>The ‘c2c_admin_post_navigation_prev_text’ filter allows you to change the link text used for the ‘Previous’ link. By default this is ‘← Previous’.</p>
<p>Arguments:</p>
<ul>
<li>$text (string) The ‘previous’ link text.</li>
</ul>
<p>Example:</p>
<pre><code>/**
 * Changes the text for the 'previous' link to 'Older' output by the Admin Post Navigation plugin.
 *
 * @param string $text The text used to indicate the 'next' post.
 * @return string
 */
function my_c2c_admin_post_navigation_prev_text( $text ) {
    return 'Older';
}
add_filter( 'c2c_admin_post_navigation_prev_text', 'my_c2c_admin_post_navigation_prev_text' );
</code></pre>
<h4>c2c_admin_post_navigation_next_text (filter)</h4>
<p>The ‘c2c_admin_post_navigation_next_text’ filter allows you to change the link text used for the ‘Next’ link. By default this is ‘Next →’.</p>
<p>Arguments:</p>
<ul>
<li>$text (string) The ‘next’ link text.</li>
</ul>
<p>Example:</p>
<pre><code>/**
 * Changes the text for the 'next' link to 'Newer' output by the Admin Post Navigation plugin.
 *
 * @param string $text The text used to indicate the 'next' post.
 * @return string
 */
function my_c2c_admin_post_navigation_next_text( $text ) {
    return 'Newer';
}
add_filter( 'c2c_admin_post_navigation_next_text', 'my_c2c_admin_post_navigation_next_text' );
</code></pre>
<h4>c2c_admin_post_navigation_display (filter)</h4>
<p>The ‘c2c_admin_post_navigation_display’ filter allows you to customize the output links for the post navigation.</p>
<p>Arguments:</p>
<ul>
<li>$text (string) The current output for the prev/next navigation link</li>
</ul>
<p>Example:</p>
<pre><code>/**
 * Change the markup displayed by the Admin Post Navigation plugin.
 *
 * @param string $text The text being output by the plugin.
 * @return string
 */
function override_apn_display( $text ) {
    // Simplistic example. You could preferably make the text bold using CSS.
    return '<strong>' . $text . '</strong>';
}
add_filter( 'c2c_admin_post_navigation_display', 'override_apn_display' );
</code></pre>


Admin Post Navigation

Adds links to navigate to the next and previous posts when editing a post in the WordPress admin.

Page navigation by menu vs Admin Post Navigation