Alex Kuimov

Special Pack Framework – Feature set for fast website development

SP Framework

Special Pack Framework - Feature set for fast website development

swinton

This plugin is primarily aimed at theme developers, and intends to ease the 
creation of semantic, usable pagination controls for WordPress listings pages, such as 
arhive, author, category, search, tag listings etc.
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 
developer’s way, allowing her to create the markup needed by providing the 
following template tags:
<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>
For example, the following arrangement of template tags would provide a rudimentary pagination control:
<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 : ?>
 newer stories
 <?php endif; pp_rewind_pagination(); ?>

 
 <?php while(pp_has_pagination()) : pp_the_pagination(); ?>
 <?php if (pp_is_current_page()) : ?>
 <?php pp_the_page_num(); ?>
 <?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 : ?>
 older stories
 <?php endif; pp_rewind_pagination(); ?>

 </div>
<?php endif; ?>
</code></pre>
The template tags on offer by this plugin provide the theme developer with an 
unlimited array of possibilities for marking up the pagination control in a 
semantic manner.
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>.

Proper Pagination

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

SP Framework vs Proper Pagination