Description
LCP Ajax Pagination is an add-on plugin for List Category Posts.
Many users have requested the AJAX pagination feature and it is now possible with this extension.
Two modes are currently supported:
- Ajax pagination
- Load more posts
IMPORTANT: Requires List Category Posts version 0.84.1 or greater.
Ajax pagination
Usage: [catlist ajax_pagination=yes]
The result is as if you used [catlist pagination=yes]
but clicking pagination links does not trigger page reloads.
Instead, new posts are fetched asynchronously and the list is updated without a reload.
No other features of LCP pagination are modified,
you can apply your pagination CSS, or other customisations, same as you have before.
Load more
Usage: [catlist ajax_loadmore=yes]
This transforms vanilla LCP pagination by replacing pagination links with a “Load more” link. Note that this
first release does not allow specifying how many posts to fetch and uses the numberposts
shortcode parameter
same as vanilla pagination.
This will change in a future release.
You can customise the link’s text using LCP’s pagination_next
parameter:
[catlist ajax_loadmore=yes pagination_next=”Show more posts”]
General notes
- IMPORTANT: If you have multiple shortcodes on a page, those using AJAX must have the
instance
parameter set
as per the documentation.
[catlist ajax_loadmore=yes instance=1] - You do not have to use LCP’s
pagination
parameter, usingajax_loadmore
orajax_pagination
is enough. - Make sure your shortcode contains only one option:
ajax_loadmore
orajax_pagination
, otherwise the plugin will not work.
CSS customisations
The plugin uses the following CSS classes:
- AJAX pagination
<ul>
has the originallcp_paginator
class, this plugin also addslcpax-pagination
. - Wrapper around the load more link is:
<div class="lcpax-nextlink-wrapper">
, the link itself is left unchanged
as delivered by LCP, so it has thelcp_nextlink
class. - The SVG spinner displayed while waiting for ‘load more’ to finish has the
lcpax-spinner
class.
Development
LCP Ajax is open source software. You can find the
development version of the plugin on Github.
All suggestions and contributions are welcome 🙂 Fork it, read the respository’s
readme and start helping with the development!
Support the plugin
If you have found this plugin useful and would like to support its further development please consider
sponsoring it on GitHub or donating on PayPal 🙂
User Support
Please use the support forum for questions about using the plugin. Use Github issues for discussing code changes and bugs.
Installation
Please note that this is an add-on plugin which requires List Category Posts to be installed and activated.
Reviews
Contributors & Developers
“LCP Ajax Pagination” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “LCP Ajax Pagination” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.1.5
- Updated dependencies.
0.1.4
- Updated dependencies.
0.1.3
- Updated dependencies.
0.1.2
- Fixed load more link remaining active before previous fetch is finished.
0.1.0
- Initial release