Pagination

Fernando Briano edited this page Jul 18, 2018 · 6 revisions

Pagination

To use pagination, you need to set the following parameters in the shortcode:

  • pagination set it to yes. [catlist pagination=yes]

  • numberposts - Posts per page are set with the numberposts parameter. [catlist pagination=yes numberposts=5]

  • instance (only necessary when using the shortcode with pagination more than once in the same page/post) - a number or name to identify the instance where you are using pagination. Since you can use the shortcode several times in the same page or post, you need to identify the instance so that you paginate only that instance.

Example:

[catlist id=3 numberposts=5 pagination=yes instance=1]

[catlist id=5 numberposts=15 pagination=yes instance=2]

Bookmarks in pagination links

Pagination links are automatically appended with bookmarks to the list they are part of, i.e. lcp_instance. While this is desirable by many users, it can cause a real mess in many (badly written 😉 ) themes and plugins. So @zymeth25 proposed the pagination_bookmarks shortcode parameter. If present and set to no the plugin won't append bookmarks to pagination URLs.

Default example link http://example.org?lcp_page0=2#lcp_instance_0

With pagination_bookmarks=no http://example.org?lcp_page0=2

Next and Previous buttons

You can customize what to show for the "next" and "previous" buttons in the pagination navigation. Use the following params:

  • pagination_prev - Replace the "<<" characters in the "previous" button in the pagination navigation with a custom text.
  • pagination_next - Replace the ">>" characters in the "next" button in the pagination navigation with a custom text.

Default Options

You can also set a default value for pagination in the Options Page. This will apply every time you use the shortcode. You can override the option by using pagination='yes' and pagination='no' in the shortcode. Note: for full backward compatibility pagination='true' and pagination='false' work as well.

Changing the pagination CSS

If you want to customize the way the pagination is displayed, you can copy the lcp_paginator.css file from the plugin's directory to your theme's directory and customize it. Do not customize the file on the plugin's directory since this file will be overwritten every time you update the plugin.

The current page in pagination has its own CSS class:

<li class='lcp_currentpage'>current_page</li>

"Previous" and "next" links in pagination navigation have their own classes too:

<a href="[next page URL]" class='lcp_nextlink'>>></a>

<a href="[previous page URL]" class='lcp_prevlink'><<</a>

So you can style the current page number and "next"/"previous" buttons differently if you want to.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.