scharrier/li3_pagination

Lithium pagination that doesn't suck

li3_pagination

I'm sorry, this li3 package isn't still maintained. If someone wants to take the lead, just ping me., _(*1)

Lithium doesn't suck. This is a fact. But hey, what's about pagination ? Not natively included in the framework, all the existing plugins are just wrong. Pagination is a really common thing : we, developers, have to paginate everything, everytime., _(*2)

It has to be simple. And you know what ? With li3_pagination, it is., _(*3)

Install

The easiest way to install li3_pagination is to use composer, adding this lines in your composer.json file:, _(*4)

{
    "require" : {
        "scharrier/li3_pagination" : "dev-master"
    }
}

Tell composer to install it :, _(*5)

composer install

And finally, load the library:, _(*6)

// config/bootstrap/libraries.php
Libraries::add('li3_pagination') ;

Using li3_pagination

In your model, just use the good trait :, _(*7)

class MyModel extends \lithium\data\Model {

    use \li3_pagination\extensions\data\Paginable ;

}

The trait add a method paginate() to your model. Now, call it directly from your controller instead of a standard find() :, _(*8)

public function index() {
    $records = Records::paginate($this->request, [
        'limit' => 20,
        'order' => ['field' => 'asc'],
        'conditions' => [
            'your' => ['custom' => 'conditions']
        ]
    ]);
}

And finally, just call paginate() :, _(*9)

$this->pagination->paginate() ;

Yep. That's all., _(*10)

Help and support

Fork it, play with it, commit if needed and pull request ! Ask your questions or tell me more about problems you have in the repo issues., _(*11)