a-dob/preview-paginator

Laravel pagination with different size for first page (preview-paginator)

1.0.0 2021-07-19 22:36 UTC

Requires

• php: ^7.4|^8.0

MIT

• Anatoly Dobychin

README

This package allows you to add a local scope to your Model.
The Pagination class implements the Illuminate\Pagination\AbstractPaginator contract and it is similar to the basic simplePaginate method.

Installation

composer require a-dob/preview-paginator

Add PreviewPaginated trait to models

Add Adob\PreviewPaginator\PreviewPaginated trait to your model you want to paginate

use Illuminate\Database\Eloquent\Model;
use Adob\PreviewPaginator\PreviewPaginated;

class Post extends Model
{
    use PreviewPaginated;

    protected $initialQuantity = 2;
    
    protected $perPage = 5;

The $initialQuantity property sets the number of returned models on the first page by default.

The $perPage property sets the number of returned models on the remaining pages by default.

Usage

You may paginate Eloquent queries. In this example, we will paginate the App\Models\User model and indicate that we plan to display 5 records on first page and 15 records on the remaining pages. As you can see, the syntax is nearly identical to paginating query builder results:

use App\Models\User;

$users = User::previewPaginate(5, 15);

Of course, you may call the previewPaginate method after setting other constraints on the query, such as where clauses:

$users = User::where('votes', '>', 100)->previewPaginate(5, 15);

You may also use the previewPaginate method when paginating Eloquent models:

$users = User::where('votes', '>', 100)->previewPaginate(5, 15);

The first argument of the previewPaginated method specifies the number of returned models on the first page.

The second argument of the previewPaginated method specifies the number of returned models on the remaining pages.

If null is passed as the first argument, the initial quantity will be defined from the specified model property. If this property is not defined in the model the initial quantity will be 5