robfelty

<p>This is a very simple plugin that uses Javascript to form a collapsable set of<br />
links in the sidebar for the pages. Every page corresponding to a given<br />
parent page will be expanded.</p>
<p>It is largely based off of my Collapsing Pages and Collapsing Pages<br />
plugins.</p>
<h3>What’s new?</h3>
<ul>
<li>
<p>2.0.3 (2024.01.01)</p>
<ul>
<li>Fixed issue with subsubpages not closing correctly</li>
<li>Got rid of some more warnings</li>
<li>Tested with 6.4.2</li>
</ul>
</li>
<li>
<p>2.0.2 (2023.12.01)</p>
<ul>
<li>Got rid of some warnings</li>
<li>Updated deprecated property __experimentalGroup</li>
<li>Tested with 6.4.1</li>
</ul>
</li>
<li>
<p>2.0.1 (2023.06.16)</p>
<ul>
<li>Bug fixes</li>
</ul>
</li>
<li>
<p>2.0.0 (2023.03.17)</p>
<ul>
<li>Updated to use Gutenberg block</li>
</ul>
</li>
<li>
<p>1.0.1 (2016.05.09)</p>
<ul>
<li>Fixed bug where sometimes setting accordion to false broke javascript</li>
</ul>
</li>
<li>
<p>1.0 (2015.08.12)</p>
<ul>
<li>Compatible with WordPress 4.3</li>
<li>Fixed bug where expanding symbol showed up at lowest depth specified instead<br />
(thanks to tkibler for pointing it out)</li>
<li>Added option to only display pages of the current subpage</li>
<li>Added option to show top-level page (previously it was always shown)</li>
<li>Added accordion style option</li>
<li>Cleaned up widget settings</li>
<li>improved style management, including the ability to specify style per widget</li>
<li>Switched from unicode symbols to html entities</li>
<li>Not showing tags for title if empty</li>
<li>Fixed bug with title attribute of pages</li>
<li>Totally rewrote javascript</li>
</ul>
</li>
</ul>
<h3>Options</h3>
<p>If using the manual version, you can pass options either as an array, or using<br />
the query style, just like for other wordpress functions such as<br />
    wp_list_pages</p>
<pre><code>  $defaults=array(
    'title' => __('Pages', 'collapsing-pages'), 
    'sortOrder'=> 'ASC' ,
    'sort'=> 'pageName' ,
    'defaultExpand'=> '',
    'expand' => 0,
    'depth' =>-1,
    'inExcludePage' => 'exclude',
    'linkToPage' => true,
    'inExcludePages' => '',
    'showPosts' => false,
    'animate' => 0,
    'useCookies' => true,
    'postTitleLength' => 0,
    'showTopLevel' => true,
    'currentPageOnly' => false,
    'debug' => false,
  );
</code></pre>
<ul>
<li>inExcludePage
<ul>
<li>Whether to include or exclude certain pages
<ul>
<li>‘exclude’ (default) </li>
<li>‘include’</li>
</ul>
</li>
</ul>
</li>
<li>inExcludePages
<ul>
<li>The pages which should be included or excluded</li>
</ul>
</li>
<li>showPosts
<ul>
<li>Whether or not to include posts as well as pages. Default if false</li>
</ul>
</li>
<li>linkToPage
<ul>
<li>True, clicking on a parent page title will link to that page (default)</li>
<li>False, clicking on a parent page will expand to show sub-pages</li>
</ul>
</li>
<li>sort
<ul>
<li>How to sort the pages. Possible values:
<ul>
<li>‘pageName’ the title of the page (default)</li>
<li>‘pageId’ the Id of the page</li>
<li>‘pageSlug’ the url of the page</li>
<li>‘menuOrder’ custom order specified in the pages settings</li>
</ul>
</li>
</ul>
</li>
<li>sortOrder
<ul>
<li>Whether pages should be sorted in normal or reverse<br />
order. Possible values:</p>
<ul>
<li>‘ASC’ normal order (a-z 0-9) (default)</li>
<li>‘DESC’ reverse order (z-a 9-0)  </li>
</ul>
</li>
</ul>
</li>
<li>expand
<ul>
<li>The symbols to be used to mark expanding and collapsing. Possible values:
<ul>
<li>‘0’ Triangles (default)</li>
<li>‘1’ + –</li>
<li>‘2’ [+] [-]</li>
<li>‘3’ images (you can upload your own if you wish)</li>
<li>‘4’ custom symbols</li>
</ul>
</li>
</ul>
</li>
<li>customExpand
<ul>
<li>If you have selected ‘4’ for the expand option, this character will be<br />
used to mark expandable link categories</li>
</ul>
</li>
<li>customCollapse
<ul>
<li>If you have selected ‘4’ for the expand option, this character will be<br />
used to mark collapsible link categories</li>
</ul>
</li>
<li>postTitleLength
<ul>
<li>Truncate post titles to this number of characters (default: 0 = don’t<br />
truncate)</li>
</ul>
</li>
<li>animate
<ul>
<li>When set to true, collapsing and expanding will be animated</li>
</ul>
</li>
<li>useCookies
<ul>
<li>When true, expanding and collapsing of pages is remembered for each<br />
visitor. When false, pages are always display collapsed (unless<br />
explicitly set to auto-expand). Possible values:</p>
<ul>
<li>true (default)</li>
<li>false</li>
</ul>
</li>
</ul>
</li>
<li>showTopLevel
<ul>
<li>True –  show top level pages (default)</li>
<li>False – only display sub-pages and below</li>
</ul>
</li>
<li>currentPageOnly
<ul>
<li>True –  show only parent and sub pages of the current page</li>
<li>False – show all pages (subject to the include or exclude parameters<br />
set) (default)</li>
</ul>
</li>
<li>debug
<ul>
<li>When set to true, extra debugging information will be displayed in the<br />
underlying code of your page (but not visible from the browser). Use<br />
this option if you are having problems</li>
</ul>
</li>
</ul>
<h4>Examples</h4>
<pre><code>collapsPage('animate=true&sort=ASC&expand=3,inExcludePages=about')
</code></pre>
<p>This will produce a list with:<br />
* animation on<br />
* shown in alphabetical order<br />
* using images to mark collapsing and expanding<br />
* exclude page about</p>
<h3>Demo</h3>
<p>I use this plugin in my blog at http://blog.robfelty.com</p>
<h3>CAVEAT</h3>
<p>Currently this plugin relies on Javascript to expand and collapse the links.<br />
If a user’s browser doesn’t support javascript they won’t see the links to the<br />
posts, but the links to the pages will still work (which is the default<br />
behavior in wordpress anyways)</p>


Collapsing Pages

This plugin uses Javascript to dynamically expand or collapsable the set of pages for each parent page.

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.

Collapsing Pages vs WP-PageNavi