fromholdio/silverstripe-paged

A small SilverStripe module that applies pagination functionalities to a Controller and its datalist/s.

Installs: 965

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0

Type:silverstripe-vendormodule

1.2.0 2023-05-23 07:26 UTC

This package is auto-updated.

Last update: 2024-11-23 10:32:57 UTC


README

A small SilverStripe module that applies pagination functionalities to a Controller and its datalist/s.

  • Extends the core PaginatedList to also have AbsoluteNextLink and AbsolutePrevLink (in addition to regular NextLink and PrevLink)
  • Adds (int) PagedLimit to the extended Page
  • Extends the PageController to get a DataList, wrap it in a PaginatedList, applies the PagedLimit and returns it

Note that you do not need to extend a Page, you can simply add the extension to a Controller that is already returning a DataList and the extension will provide the pagination capability.

This module is really just a timesaver for otherwise repetitive and often used functionality.

Requirements

Installation

composer require fromholdio/silverstripe-paged

Details & Usage

Install, and then apply:

  • PagedSiteTreeExtension to your Page class (or subclass)
  • PagedControllerExtension to your PageController class (or subclass)

On your extended Controller, you must set the following config variable to point the pagination to the source DataList:

MyNamespace\MyControllerClass:
  paged_source_method: 'getMyFullDataList'

If you do not have a page associated to the controller, you can define a per-page-limit on the controller too:

MyNamespace\MyControllerClass:
  paged_limit: 12

Review the source, you'll find some hooks in there to update the paginated list and or limit from your base/extended classes, too.

More thorough docs to come. In the meantime please submit questions as issues.

To Do

  • Better docs