Visual Paginator

Visual paginator for Nette Framework

Installation

The best way to install ipub/visual-paginator is using Composer:

{
"require": {
"ipub/visual-paginator": "dev-master"
}
}

or

$ composer require ipub/visual-paginator:@dev

After that you have to register extension in config.neon.

extensions:visualPaginator:IPub\VisualPaginator\DI\VisualPaginatorExtension

Usage

Implementing into Presenter or Component

useIPub\VisualPaginator\ComponentsasVisualPaginator;
class SomePresenter extendsNette\Application\UI\Presenter
{
/** * @var Model */private$dataModel;
publicfunctionrenderDefault()
{
$someItemsList = $this->dataModel->findAll();
// Get visual paginator components$visualPaginator = $this['visualPaginator'];
// Get paginator form visual paginator$paginator = $visualPaginator->getPaginator();
// Define items count per one page$paginator->itemsPerPage = 10;
// Define total items in list$paginator->itemCount = $someItemsList->count();
// Apply limits to list$someItemsList->limit($paginator->itemsPerPage, $paginator->offset);
}
/** * Create items paginator * * @return VisualPaginator\Control */protectedfunctioncreateComponentVisualPaginator()
{
// Init visual paginator$control = newVisualPaginator\Control;
return$control;
}
}

Enabling or disabling ajax support

This component bring ajax support. When ajax is enabled, then ajax class is inserted into links.

useIPub\VisualPaginator\ComponentsasVisualPaginator;
class SomePresenter extendsNette\Application\UI\Presenter
{
/** * Create items paginator * * @return VisualPaginator\Control */protectedfunctioncreateComponentVisualPaginator()
{
// Init visual paginator$control = newVisualPaginator\Control;
// Enable ajax (by default)$control->enableAjax();
// Or disable ajax$control->disableAjax();
return$control;
}
}

And now you have to define events what to do when next or previous page is loaded via Ajax request:

useIPub\VisualPaginator\ComponentsasVisualPaginator;
class SomePresenter extendsNette\Application\UI\Presenter
{
publicfunctionrenderDefault()
{
$that = $this;
//....// Define event for example to redraw snippets$this['visualPaginator']->onShowPage[] = (function ($component, $page) use ($that) {
if ($that->isAjax()){
$that->invalidateControl();
}
});
}
}

Using templates

This component come with two default templates. One is basic default template, with some basic classes and the second one is Bootstrap FW template. And also you can use your own template:

useIPub\VisualPaginator\ComponentsasVisualPaginator;
class SomePresenter extendsNette\Application\UI\Presenter
{
/** * Create items paginator * * @return VisualPaginator\Control */protectedfunctioncreateComponentVisualPaginator()
{
// Init visual paginator$control = newVisualPaginator\Control;
// To use bootstrap default template$control->setTemplateFile('bootstrap.latte');
// To use your own template$control->setTemplateFile('path/to/your/latte/file.latte');
return$control;
}
}