scribu

Lester Chan

<p>Want to replace the old <em>← Older posts | Newer posts →</em> links with some page links?</p>
<p>This plugin provides the <code>wp_pagenavi()</code> template tag which generates fancy pagination links.</p>
<h3>Usage</h3>
<p>In your theme, you need to find calls to next_posts_link() and previous_posts_link() and replace them.</p>
<p>In the Twentyten theme, it looks like this:</p>
<pre><code><div class="nav-previous"><?php next_posts_link( __( '<span class="meta-nav">&larr;</span> Older posts', 'twentyten' ) ); ?></div>
<div class="nav-next"><?php previous_posts_link( __( 'Newer posts <span class="meta-nav">&rarr;</span>', 'twentyten' ) ); ?></div>
</code></pre>
<p>You would replace those two lines with this:</p>
<pre><code><?php wp_pagenavi(); ?>
</code></pre>
<p>For multipart pages, you would look for code like this:</p>
<pre><code><?php wp_link_pages( ... ); ?>
</code></pre>
<p>and replace it with this:</p>
<pre><code><?php wp_pagenavi( array( 'type' => 'multipart' ) ); ?>
</code></pre>
<p>Go to <em>WP-Admin -> Settings -> PageNavi</em> for configuration.</p>
<h3>Changing the CSS</h3>
<p>If you need to configure the CSS style of WP-PageNavi, you can copy the <code>pagenavi-css.css</code> file from the plugin directory to your theme’s directory and make your modifications there. This way, you won’t lose your changes when you update the plugin.</p>
<p>Alternatively, you can uncheck the “Use pagenavi.css?” option from the settings page and add the styles to your theme’s style.css file directly.</p>
<h3>Changing Class Names</h3>
<p>There are <a href="https://codex.wordpress.org/Glossary#Filter" rel="nofollow ugc">filters</a> that can be used to change the default class names that are assigned to page navigation elements.</p>
<h4>Filters</h4>
<ul>
<li><code>wp_pagenavi_class_pages</code></li>
<li><code>wp_pagenavi_class_first</code></li>
<li><code>wp_pagenavi_class_previouspostslink</code></li>
<li><code>wp_pagenavi_class_extend</code></li>
<li><code>wp_pagenavi_class_smaller</code></li>
<li><code>wp_pagenavi_class_page</code></li>
<li><code>wp_pagenavi_class_current</code></li>
<li><code>wp_pagenavi_class_larger</code></li>
<li><code>wp_pagenavi_class_nextpostslink</code></li>
<li><code>wp_pagenavi_class_last</code></li>
</ul>
<h4>Filter Usage</h4>
<pre><code>// Simple Usage - 1 callback per filter
add_filter('wp_pagenavi_class_previouspostslink', 'theme_pagination_previouspostslink_class');
add_filter('wp_pagenavi_class_nextpostslink', 'theme_pagination_nextpostslink_class');
add_filter('wp_pagenavi_class_page', 'theme_pagination_page_class');

function theme_pagination_previouspostslink_class($class_name) {
  return 'pagination__control-link pagination__control-link--previous';
}

function theme_pagination_nextpostslink_class($class_name) {
  return 'pagination__control-link pagination__control-link--next';
}

function theme_pagination_page_class($class_name) {
  return 'pagination__current-page';
}


// More Concise Usage - 1 callback for all filters
add_filter('wp_pagenavi_class_previouspostslink', 'theme_pagination_class');
add_filter('wp_pagenavi_class_nextpostslink', 'theme_pagination_class');
add_filter('wp_pagenavi_class_page', 'theme_pagination_class');

function theme_pagination_class($class_name) {
  switch($class_name) {
    case 'previouspostslink':
      $class_name = 'pagination__control-link pagination__control-link--previous';
      break;
    case 'nextpostslink':
      $class_name = 'pagination__control-link pagination__control-link--next';
      break;
    case 'page':
      $class_name = 'pagination__current'
      break;
  }
  return $class_name;
}
</code></pre>
<h3>Development</h3>
<ul>
<li><a href="https://github.com/lesterchan/wp-pagenavi" title="https://github.com/lesterchan/wp-pagenavi" rel="nofollow ugc">https://github.com/lesterchan/wp-pagenavi</a></li>
</ul>
<h3>Credits</h3>
<ul>
<li>Plugin icon by <a href="http://www.simpleicon.com" rel="nofollow ugc">SimpleIcon</a> from <a href="http://www.flaticon.com" rel="nofollow ugc">Flaticon</a></li>
</ul>
<h3>Donations</h3>
<p>I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appreciate it. If not feel free to use it without any obligations.</p>


WP-PageNavi

Adds a more advanced paging navigation interface.

strix-bubol5

<p>This plugin’s page-list has an input box that allows you to directly specify the page number you wish to display.</p>
<p>This plugin has a setting to display page-list in reverse order</p>
<p>You can specify style-sheet and some options at each page.</p>
<p>This plugin has several sample stylesheets by default.</p>
<p>By passing an array of options to the function as arguments on each page, it is possible to change the appearance of multiple linked listings within the same page, except for the style.</p>
<p>It is common to have two linked lists, one at the top of the page and one at the bottom. In such cases, when the function is called a second time, the list created the first time is reused from memory to avoid having the same process performed twice.</p>
<p>This plugin has a custom block for Gutenberg Block Editor.</p>
<p>Even if you don’t know much html or php, this plugin has the ability to insert linked list at the beginning and end of an html element using Javascript by specifying the ID of the html element where you want to display it.<br />
Furthermore, if you have no idea about the ID of html elements, etc., go into the plugin’s options settings page and try typing “search” in the “Page-lists outputted by javascript” field. When the page is displayed, the plugin uses javascript to find the html elements of the main content, and if it is lucky enough to find it, it will use Javascript to insert a page-lists at the beginning and end of that HTML element. Perhaps it might work.</p>
<h3>Arbitrary section 1</h3>
<p>Explanation of errors detected by the plugin “Plugin Check (PCP)”<br />
*file： \simplistic-page-navi\simplistic_pagenavi.php</p>
<p>1:881行     ERROR   WordPress.Security.EscapeOutput.OutputNotEscaped    All output should be run through an escaping function (see the Security sections in the WordPress Developer Handbooks), found ‘$ret’.</p>
<p>＞This variable $ret contains the assembled pagination and is pointed out as not being escaped in the final output. The option values ​​set by the user are sanitized when saved and are also sanitized individually when actually used. The tags that are incorporated into the pagination are only pre-defined ones, and I understand that there is no need to escape the final assembly..</p>
<p>2:410行     WARNING     WordPress.Security.NonceVerification.Recommended    Processing form data without nonce verification.</p>
<p>＞This is a function that gets the parameters (query) of the accessed URL. Because it only gets values ​​that exist in public_query_vars set by WordPress, I think that nonce verification is not necessary.</p>
<p>3:860行     ERROR   WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound   Global variables defined by a theme/plugin should start with the theme/plugin prefix. Found: “$simplistic_page_navi_start”.</p>
<p>4:888行     ERROR   WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedFunctionFound   Functions declared in the global namespace by a theme/plugin should start with the theme/plugin prefix. Found: “direct_splcpn_style”.</p>
<p>＞The plugin is encapsulated in a class, but these variables and functions are outside of that class. I could add a prefix as instructed, but I’ve left it as it is because it might already be in use.。</p>
<p>5:The plugin is encapsulated by a class, and for most of the variables in the files included by the methods in that class, an error occurs saying “Because it is a global variable, you must add a prefix.”。</p>
<p>＞However, since these variables are used within methods inside a class, they cannot possibly be global. I believe this is a false positive that undermines reliability. It’s annoying, so I’m handling it with “// phpcs:ignoreFile”.。</p>


Simplistic page navi

This plugin displays a linked list by page number. It is simple but has several features.

WP-PageNavi vs Simplistic page navi