PHPackages                             seblhaire/bootstrappaginator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. seblhaire/bootstrappaginator

ActiveLibrary

seblhaire/bootstrappaginator
============================

A Laravel library to generate paginations

1.4.0(1mo ago)338MITPHPPHP >=8.4

Since Oct 12Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/seblhaire/bootstrappaginator)[ Packagist](https://packagist.org/packages/seblhaire/bootstrappaginator)[ Docs](https://github.com/seblhaire/bootstrappaginator)[ RSS](/packages/seblhaire-bootstrappaginator/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (2)Versions (18)Used By (0)

Bootstrap Paginator
===================

[](#bootstrap-paginator)

[By Sébastien L'haire](http://sebastien.lhaire.org)

A Laravel library to generate paginations with [Bootstrap](https://getbootstrap.com/) 4 or 5 CSS Framework.

This library provides two different paginators:

- a classical paginator with page numbers and previous and next button. [![paginator image](paginator.png)](paginator.png)
- an alphabetical paginator with letters [![paginator alpha image](paginatoralpha.png)](paginatoralpha.png)

Both paginators can be used in same page.

Demo site available [here](https://sebastien.lhaire.org/paginator).

Installation
============

[](#installation)

1. `composer require seblhaire/bootstrappaginator`
2. Optionally install Boostrap using `npm install bootstrap`
3. Composer will automatically link the package with Laravel. But you still can explicitely add provider and facade to your `config/app.php`:

```
  'providers' => [
    ...
      Seblhaire\BootstrapPaginator\BootstrapPaginatorServiceProvider::class,
      ...
    ],
    'aliases' => [
        ...
        'BootstrapPaginator' => Seblhaire\BootstrapPaginator\BootstrapPaginator::class,
      ]
```

4. Publish package (optionally).

```
$ php artisan vendor:publish
```

5. Add a translation to Laravel existing `pagination.php` translation file in directory `resources/lang/en/`. Simply add key:

```
'all' => 'All',

```

Usage
=====

[](#usage)

Declare Facade in Controller headers:

```
 use Seblhaire\BootstrapPaginator\BootstrapPaginator;

```

Your route must contain a parameter for page in last segment:

```
Route::get('/issues/{page?}', 'MainController@issues')->name('issues');

```

Eg: you can have a route `https://test.site/issues/9`, route `https://test.site/issues` should display page 1. Controller method can be declared like this:

```
function issues($page = 1){ ...}

```

If you include paginator alpha, last segment will be an initial:

```
Route::get('/authors/{initial?}', 'MainController@authors')->name('authors');

```

Eg: you can have a route `https://test.site/authors/D` would display all authors beginning with D. `https://test.site/authors` will display all items. Controller method can be declared like this:

```
public function authors($initial = config('bootstrappaginator.valueforall')){ ... }

```

You can combine both paginators in a single page. In this case, initial will be in the before last position and page parameter in the last position:

```
Route::get('/authors/{initial?}/{page?}', 'MainController@authors')->name('authors');

```

In this case `https://test.site/authors` displays first page of all items. `https://test.site/authors/all/3` will display third page of all items. `https://test.site/authors/D` will display first page of items beginning with D. And `https://test.site/authors/D/3` will display third page of items beginning with D. Initialize your method with default parameters and use them in your code:

```
public function authors($initial = null, $page =1){
  ....
   $initial = is_null($initial) ? config('bootstrappaginator.valueforall') : $initial;
   $route = 'authors';
   $options = ['nbpages' => 4, 'params' => ['initial' => $initial]];
   $optionalpha = ['type' => 'alpha'];
   $paginator = BootstrapPaginator::init($page, $route, $options);
   $paginatoralpha = BootstrapPaginator::init($initiale, $route, $optionalpha);
   ....
   return view('pages.authors', [
       ...
       'paginator' => $paginator,
       'paginatoralpha' => $paginatoralpha,
       ...
  ]);
}

```

In this example, numeric paginator will contain current initial in the link urls. Alpha paginator's links will direct web page users to the first page with the initial they contain. Then in the view, print your paginator like this:

`{!! $paginator->render() !!}`

or simply

`{!! $paginator !!}`

Parameters
----------

[](#parameters)

- `$page` : current page number or initial letter;
- `$route`: current route id;
- `$options` : array of values to replace default values in config file:
    - `type`: either `numeric` or `alpha`;
    - `params` : default `[]`. Array of parameters used by `route()` helper to issue urls in paginator. See above examples;
    - `getparams` : default `[]`. GET parameters that will be added to path. Eg: `['search' => 'dummy', 'type' => 'global']` will be translated into `url?search=dummy&type=global`
    - numeric paginator specific parameters:
        - `pageparam` : default `page`. Id of page parameter in route.
        - `nbpages`: Default 1. Number of pages that will be displayed.
        - `withoutdots`: default `false`. Display all pages without spacing ranges by dots;
        - `max_pages_without_dots`: default `9`. Maximum number of pages without dot separation.
        - `items_before_after_current`: default `2`. Number of pages to display before and after page item.
    - alpha paginator specific parameters:
        - `initialparam`: default `initial`. Id of initial parameter in route;
        - `valueforall` : delault `all`. Value used to display all items instead of items beginnig with a certain parameter.
    - `class`: default `pagination justify-content-center`. Class of `` surrounding pagination.
    - `itemclass`: default `page-item`. Class of `` element.
    - `linkclass`: default `page-link`. Class of `` element.
    - `activelink`: default ` active`. Class added to current element.
    - `disabledlink`: default ` disabled`. Class of disabled button.
    - `srcurrent` default: ` (current)`- Element added to current element for speech aid tools.
    - `previousbuttoncontent`: default `«`. Content for previous button.
    - `nextbuttoncontent`: default `»`. Content for next button.

Config files
------------

[](#config-files)

Config files are available, either in package directory in vendor\\seblhaire/bootstrappaginator or in your app config directory if you publish config.

```
config('bootstrappaginator')
```

Questions? Contributions?
=========================

[](#questions-contributions)

Feel free to send feature requests or merge request to the author or simply to ask questions.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance92

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~142 days

Recently: every ~274 days

Total

15

Last Release

40d ago

PHP version history (3 changes)1.0PHP >=5.6

1.3.1PHP >=8.2

1.4.0PHP >=8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/72663124?v=4)[Sébastien L'haire](/maintainers/seblhaire)[@seblhaire](https://github.com/seblhaire)

---

Top Contributors

[![seblhaire](https://avatars.githubusercontent.com/u/72663124?v=4)](https://github.com/seblhaire "seblhaire (30 commits)")

---

Tags

bootstrap-paginatorlaravel-packagepaginatorpaginator-alpha

### Embed Badge

![Health badge](/badges/seblhaire-bootstrappaginator/health.svg)

```
[![Health](https://phpackages.com/badges/seblhaire-bootstrappaginator/health.svg)](https://phpackages.com/packages/seblhaire-bootstrappaginator)
```

###  Alternatives

[tymon/jwt-auth

JSON Web Token Authentication for Laravel and Lumen

11.5k49.1M347](/packages/tymon-jwt-auth)[laravel/reverb

Laravel Reverb provides a real-time WebSocket communication backend for Laravel applications.

1.5k9.4M48](/packages/laravel-reverb)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[api-platform/laravel

API Platform support for Laravel

59126.4k6](/packages/api-platform-laravel)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)