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.

David Powell

<p>Retain Author allows you to force your “next” and “previous” blog posts to stay within the same category and the same author.</p>


Retain Author

Prevent mixing authors in your next and previous post links.

Page navigation by menu vs Retain Author