Rob Holmes

<p>Test suite for the flux plugin framework</p>
<h4>Documentation</h4>
<h4>Status</h4>


Flux Test Suite

swinton

<p>This plugin is primarily aimed at theme developers, and intends to ease the<br />
creation of semantic, usable pagination controls for WordPress listings pages, such as<br />
arhive, author, category, search, tag listings etc.</p>
<p>Inspired by <a href="https://codex.wordpress.org/The_Loop" rel="nofollow ugc">The Loop</a> and <a href="https://codex.wordpress.org/Function_Reference/WP_Query" rel="nofollow ugc">WP_Query</a>, this plugin stays out of the theme<br />
developer’s way, allowing her to create the markup needed by providing the<br />
following template tags:</p>
<ul>
<li><code>pp_has_pagination</code> – determines whether the current ‘view’ has any pagination to display, i.e. whether the content being browsed spans more than 1 page</li>
<li><code>pp_the_pagination</code> – initiates the pagination context, should be called at the beginning of each loop iteration</li>
<li><code>pp_rewind_pagination</code> – resets the pagination context, so that the pagination loop can be iterated over multiple times</li>
<li><code>pp_is_current_page</code> – for use in the pagination loop, returns a boolean indicating whether the current loop iteration is for the current page</li>
<li><code>pp_has_previous_page</code> – for use in the pagination loop, returns a boolean indicating whether there is a previous page, e.g. when at page 1, there is no previous page</li>
<li><code>pp_has_next_page</code> – for use in the pagination loop, returns a boolean indicating whether there is a next page, e.g. when at page N of N, there is no next page</li>
<li><code>pp_the_page_permalink</code> – for use in the pagination loop, echos the permalink for the current page</li>
<li><code>pp_the_previous_page_permalink</code> – for use in the pagination loop, echos the permalink for the previous page</li>
<li><code>pp_the_next_page_permalink</code> – for use in the pagination loop, echos the permalink for the next page</li>
<li><code>pp_the_first_page_permalink</code> – for use in the pagination loop, echos the permalink for the first page</li>
<li><code>pp_the_last_page_permalink</code> – for use in the pagination loop, echos the permalink for the last page</li>
<li><code>pp_the_page_num</code> – for use in the pagination loop, echos the page number of the current page being iterated over</li>
</ul>
<p>For example, the following arrangement of template tags would provide a rudimentary pagination control:</p>
<pre><code><?php if (pp_has_pagination()) : ?>
    <div class="pagination">

        
        <?php pp_the_pagination(); if (pp_has_previous_page()) : ?>
            <a href="<?php pp_the_previous_page_permalink(); ?>" class="prev">newer stories</a>
        <?php else : ?>
            <span class="current prev">newer stories</span>
        <?php endif; pp_rewind_pagination(); ?>

        
        <?php while(pp_has_pagination()) : pp_the_pagination(); ?>
            <?php if (pp_is_current_page()) : ?>
                <span class="current"><?php pp_the_page_num(); ?></span>
            <?php else : ?>
                <a href="<?php pp_the_page_permalink(); ?>"><?php pp_the_page_num(); ?></a>
            <?php endif; ?>
        <?php endwhile; pp_rewind_pagination(); ?>

        
        <?php pp_the_pagination(); if (pp_has_next_page()) : ?>
            <a href="<?php pp_the_next_page_permalink(); ?>" class="next">older stories</a>
        <?php else : ?>
            <span class="current next">older stories</span>
        <?php endif; pp_rewind_pagination(); ?>

    </div>
<?php endif; ?>
</code></pre>
<p>The template tags on offer by this plugin provide the theme developer with an<br />
unlimited array of possibilities for marking up the pagination control in a<br />
semantic manner.</p>
<p>For more information, see the original <a href="http://www.nixonmcinnes.co.uk/2009/07/27/making-wordpress-navigation-more-usable-through-pagination-patterns/" rel="nofollow ugc">blog post</a>.</p>

Proper Pagination

A flexible framework for creating semantic pagination controls for a listings page based on established usability patterns.

Flux Test Suite vs Proper Pagination