laraish/pagination

A simple library for generating pagination.

This is a simple PHP library for creating pagination., _(*1)

Basic Usage

Here is an example for creating the pagination in WordPress., _(*2)

global $wp_query;

// The total number of items
$total       = (int)$wp_query->found_posts;

// The number of items are going to be displayed per page.
$perPage     = (int)$wp_query->query_vars['posts_per_page'];

// The current page number.
$currentPage = (int)$wp_query->query_vars['paged'];

// additional options
$options     = ['urlStyle' => 'pretty'];


$paginator   = new Paginator($total, $perPage, $currentPage, $options);

echo $paginator->toHtml();

Customize the markup

If you don't like the default markup, you can specify your own view file to output the markup., _(*3)

$paginator = new Paginator($total, $perPage, $currentPage, ['view'=> '/www/var/example.com/pagination.php']);

You can also specify the view with using the dot notation, for example ['view'=> 'components.pagination']; by using the dot notation it will try to use the Blade Templates if possible., _(*4)

Take a look at the preset views for more details., _(*5)

Options

onEachSide

The number of links on each side of the center link., _(*6)

type

The rendering type., _(*7)

• default
• menu
• simple

view

The path of view file., _(*8)

Could be either a blade template or a regular php file.
If you wish to use a php file, you should add the .php at the end of the string., _(*9)

urlStyle

The link style., _(*10)

• pretty: example.com/news/page/10
• queryString: example.com/news/?page=10

nextPageText

The next page link text., _(*11)

prevPageText

The previous page link text., _(*12)

path

The user-defined base path., _(*13)

suffix

The suffix to be added to the very end of the url. Such as fragment or query-strings., _(*14)