Release 8.x-2.1

Need a 8.x-2.1 release to support Drupal 9.2.0, since fixes where required after core's #1202484: Improve usage of 'pager.manager' service in PagerSelectExtender, allow code to know the pager element ID used.

In this context:

• drop support for D8.8 and D9.0
• check if any deprecated test methods can be replaced

Release notes draft

This version is compatible with Drupal 9.2. Changed introduced in Drupal core by #1202484: Improve usage of 'pager.manager' service in PagerSelectExtender, allow code to know the pager element ID used required adjustment in Pagerer. Support for Drupal 8.8.x and 9.0.x is dropped in this release.

Requirements

• The module *MUST* be installed using Composer, see Download contributed modules and themes using Composer. This will also ensure that the JQuery UI dependency modules get downloaded.
• PHP 7.1 or higher
• Drupal 8.9.x and 9.1.x or higher
• Some of the JQuery UI replacement modules, loaded by Composer

Project page update

Pagerer is a module providing a collection of pager styles to enhance Drupal and Views standard pagers.

Administrators or site builders can preset multiple pager configurations. Each 'preset' allows a pager to be made up of three 'panes': left, center, and right. Each pane can contain (or not) a pager style. This way there is plenty of possibilities to combine different elements to satisfy complex requirements.

Pagerer allows to override Drupal's core pager with any of the preset configurations. Also, a built-in pager plugin for Views allows to use any of the preset pagers within any view.

Pagerer uses standard Drupal pager classes to render the pagers, so styling is preserved.

Module developers can also directly render pagerer styles in code, thus allowing even more complex scenarios.

Features:

• multi-pane pager
• Views pager plugin
• control whether to display links to pages, to items, or to item ranges
• direct input of the page to go to through an input widget
• selection of the page to go to through a jQuery UI slider
• selection of the page to go to through a client-side scrolling pager
• links to progressively more distant pages (like +10, + 20, +100, +200)
• adaptive logic links
• specify text to be used to render page separators (like a vertical bar) and page breakers (like an ellipsis)
• supports Views' AJAX enabled pager
• (since 8.x-2.0) allow page numbers in URL querystrings to start counting from 1

Styles:

• Standard - alike standard Drupal pager theme
• Progressive - provides links to pages progressively more distant from current
• Adaptive - provides links to pages following an adaptive logic
• Mini - minimal pager, providing direct page entry
• Basic - similar to Views mini pager (Drupal 8 version only)
• Scrollpane - provides page navigation through a scrolling pager
• Slider - provides page navigation through a jQuery UI slider
• A multi-pane (left, center, and right) pager style, enabling each pane to contain one of the styles above

Requirements - Drupal 7 version:

• Drupal 7
• the Views pager plugin integrates with Views 3
• jQuery update module (for Mini, Scrollpane and Slider styles)
• for Microsoft Internet Explorer browsers, the Slider and Scrollpane styles require IE 9+

Requirements - Drupal 8 version:

• The module *MUST* be installed using Composer, see Download contributed modules and themes using Composer. This will also ensure that the JQuery UI dependency modules get downloaded.
• PHP 7.1 or higher
• Drupal 8.9.x and 9.1.x or higher
• Some of the JQuery UI replacement modules, loaded by Composer

Previous releases of the module run with lower versions of Drupal 8 and 9, but are no longer maintained.

Instructions:

• Install and enable the module.
• Check the Configuration page to setup.
• Create and configure any number of 'preset' pagers.
• Select a preset to use as a general replacement of Drupal core pager, or use a preset as a pager in Views.
• (since 8.x-2.0) to change URL querystrings to start page count from one, go to
  the URL settings tab, select the URL querystring checkbox, and One-based from Page index base.

URL querystring override:

Since Pagerer 8.x-2.0 it is possible to override Drupal core's querystring so to use dots instead of commas to separate the values, and to start the page count from one instead of zero, so that the URL query ?page=0%2C2%2C0 will look like this instead: ?pg=1.3.1.
Note that the standard ?page=0 format will keep working when passed in to a HTTP request, but it will no longer be output in rendered links.

Views pager plugin:

The pager plugin for Views introduces a 'Paged output, Pagerer' option in the list of possible pagers to be used for a view.

It behaves like a 'full pager', with the additional option to select the Pagerer preset to be used for rendering the pager - so that every view could use a different preset, but also many views could use the same preset.

Documentation:

Developers can find documentations on Pagerer here.

Credits:

The ‘Mini’ style concept and its javascript code is originally inspired by the Minimax pager module for Drupal 6 (i.e. proudly copied, thanks mattyoung).

Tutorials:

• A step-by-step tutorial for the D8 version is available, thanks to Open Source Training.