Download the PHP package yidas/pagination without Composer

php Pagination

PHP Paginator with Pager Widget (pure PHP, CI, Yii, Laravel support)

Features

• Compatible with pure PHP, Codeigniter, Yii & Laravel

• SOLID principle with Yii 2 pattern like

• Pagination Widget (View Block) included

OUTLINE

• Demonstration
• Requirements
  • PDO with pure PHP
  • Codeiginter 3 Framework
  • Widget Render
• Installation
  • Codeigniter 3
• Configuration
  • Inheritance
• Usage
  • Widget
    • Customized View
    • Inheritance
  • Build URL
• API Documentation
• Examples
  • PDO with pure PHP
  • Codeiginter 3 Framework
• References

DEMONSTRATION

PDO with pure PHP

Codeiginter 3 Framework

Widget Render

$pagination is the object of yidas\data\Pagination.

REQUIREMENTS

This library requires the following:

• PHP 5.4.0+

INSTALLATION

Run Composer in your project:

composer require yidas/pagination

Then initialize it at the bootstrap of application such as config file:

Codeigniter 3

Run Composer in your Codeigniter project under the folder \application:

composer require yidas/pagination

Check Codeigniter application/config/config.php:

You could customize the vendor path into $config['composer_autoload']

CONFIGURATION

The simple config and usage could refer to Demonstration.

When you are dealing with pagination, you could new yidas\data\Pagination with configuration to get pager information for data query. For example:

For more parameters, you could refer to API Documentation.

Inheritance

You could build your application data Pagination with styles Inherited from yidas\data\Pagination. For example:

USAGE

When there are too much data to be displayed on a single page, a common strategy is to display them in multiple pages and on each page only display a small portion of the data. This strategy is known as pagination.

This library uses a yidas\data\Pagination object to represent the information about a pagination scheme. In particular,

• total count specifies the total number of data items. Note that this is usually much more than the number of data items needed to display on a single page.
• page size specifies how many data items each page contains. The default value is 20.
• current page gives the current page number (not zero-based). The default value is 1, meaning the first page.

With a fully specified yidas\data\Pagination object, you can retrieve and display data partially. For example, if you are fetching data from a database, you can specify the OFFSET and LIMIT clause of the DB query with the corresponding values provided by the pagination. Below is an example:

Widget

To facilitate building the UI element that supports pagination, This library provides the yii\widgets\Pagination widget that displays a list of page buttons upon which users can click to indicate which page of data should be displayed. The widget takes a pagination object so that it knows what is the current page and how many page buttons should be displayed. For example,

$pagination is a yidas\data\Pagination object for data provider.

Customized View

The default widget view is for Bootstrap(bootstrap), you could choose a template view for your Pagination Widget:

You can also use your customized view for Pagination widget:

Inheritance

You could build your application Pagination Widget with styles Inherited from yidas\widgets\Pagination. For example:

Build URL

If you want to build UI element manually, you may use yidas\data\Pagination::createUrl() to create URLs that would lead to different pages. The method requires a page parameter and will create a properly formatted URL containing the page parameter. For example:

The formatted URL pattern is //{current-host-uri}{parameters-with-pagination}

You could also build a per-page setting URL for changing per-page when perPageParam is set:

EXAMPLES

PDO with Pure PHP

LinkPager display:

Codeiginter 3 Framework

Codeiginter 3 Framework with yidas/codeigniter-model:

LinkPager in view:

API DOCUMENTATION

Data Pagination

Widget Pagination

REFERENCES

Yii 2 PHP Framework - Displaying Data: Pagination

Yii 2 PHP Framework - Class yii\data\Pagination