Responsive Pagination

Responsive Pagination plugin lets you configure your paginations to adapt to different screen size. Your paginations can be shown differently based on browser width as in responsive web design concept.

For instance, you might want to have a longer pagination with many page numbers when your site visitors are using desktops and large screens, but need shorter pagination with only Prev and Next link when they’re using phones.

You may try using this plugin when you found your theme is not doing well with the responsive design on its pagination. This plugin lets you configure manually to the desired breakpoints.

Two Different Methods to Apply Responsive Pagination

You can choose the way you want to apply responsive pagination.

Method A : Convert Existing Paginations (No Coding Required)

This method will convert the existing paginations from your theme into responsive paginations without needs to add any WordPress shortcode or PHP code. You only need to fill the selectors (CSS or jQuery-like selector) of the existing pagination elements. You’ll input the selectors in Admin Settings Page (Settings > Responsive Pagination)

Method B : Create new Pagination Programmatically from Scratch

This method will need you to insert PHP code into template files directly using Responsive Pagination API. This method supports queries using WP_Query, or even something more generic without WP_Query.

Responsive Pagination API (For Programmatic Usage)

Note : This API section is a short guide for creating responsive pagination programmatically. However, there is easier solution using this plugin without touching any code – that is by converting your theme’s existing pagination from within Admin Settings Page with just providing its CSS/jQuery selector.

If you want to create responsive pagination programmatically, this plugin adds new function for you to use, which will render a new pagination where you put the function.

Parameters :

• $id: (string) (required) ID for the new pagination you want to create in kebab-case format.

• $args : (WP_Query | array) (required) WP_Query instance, or an associative array contains :

  • $current : (int) Current page
  • $total: (int) Total pages
  • $urlFirstPage : (string) URL for first page
  • $urlPattern: (string) URL pattern for this pagination by using {pagenum} tag.

Note : Pagination settings and Breakpoint Configurations are still configured from within Admin Settings Page.

Example (For Programmatic Usage)

Example for creating pagination for posts within main loop using WP_Query. This also works with custom post type as long as you have WP_Query within loop.

Example for creating a more generic pagination by providing your own data for current page, total pages, URL first page, and URL pattern without WP_Query.

 $my_current_page,   // your current page here
        'total'           => $my_total_pages,    // your total page here
        'url_first_page'  => 'https://www.example.com/archives/',   // URL when current page = 1
        'url_pattern'     => 'https://www.example.com/archives/page/{pagenum}'   // the pattern using {pagenum} tag
      ) );
  }
?>

The installation is pretty standard, just like any other plugins.

1. install the plugin through the WordPress admin on ‘Plugins’ screen directly, or upload the plugin files to the /wp-content/plugins/responsive-pagination directory.
2. Activate the plugin through the ‘Plugins’ screen in WordPress admin.
3. Use “Settings > Responsive Pagination” screen within WordPress admin to configure the plugin.

1. 

   Pagination example on Desktop

2. 

   Pagination example on Tablet

3. 

   Pagination example on Phone

4. 

   Admin - Convert Paginations

5. 

   Admin - Pagination Settings

6. 

   Admin - Pagination Settings (Breakpoint Configurations)

1.4.1

• Fix: Responsive issue on Firefox in 1 pixel below lowest breakpoint

1.4.0

• Feature : Take approach to avoid theme styling interference as possible
• Improvement: Breakpoint Configurations now in separate tab
• Improvement: Change in Pagination Settings looks
• Improvement: Active vertical menu style when in focus
• Improvement: Active vertical menu go to right tab after adding & removing breakpoints
• Improvement: Add footer signature

1.3.0

• Feature: Introduce visual styling feature
• Feature: Different items width for every component in every breakpoint (pagenumbers, prevNext link, and firstLast link)
• Feature: Different items height in every breakpoints
• Feature: Different space between items (gutter) in every breakpoints
• Tweak: Pagination settings initial values

1.2.0

• First public release.