├── src
    ├── Languages
    │   ├── en
    │   │   └── pagination.php
    │   ├── es
    │   │   └── pagination.php
    │   └── pt-br
    │   │   └── pagination.php
    ├── Views
    │   ├── head.php
    │   ├── header.php
    │   ├── foundation-short.php
    │   ├── w3-short.php
    │   ├── semantic-ui-short.php
    │   ├── bootstrap-short.php
    │   ├── bulma-short.php
    │   ├── pagination-short.php
    │   ├── tailwind-short.php
    │   ├── materialize-short.php
    │   ├── primer-short.php
    │   ├── foundation.php
    │   ├── semantic-ui.php
    │   ├── w3.php
    │   ├── pagination.php
    │   ├── bootstrap.php
    │   ├── materialize.php
    │   ├── bulma.php
    │   ├── primer.php
    │   └── tailwind.php
    └── Pager.php
├── README.md
├── LICENSE
├── .phpstorm.meta.php
└── composer.json


/src/Languages/en/pagination.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | return [
11 |     'first' => 'First',
12 |     'last' => 'Last',
13 |     'next' => 'Next',
14 |     'previous' => 'Previous',
15 | ];
16 | 


--------------------------------------------------------------------------------
/src/Languages/es/pagination.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | return [
11 |     'first' => 'Primera',
12 |     'last' => 'Última',
13 |     'next' => 'Siguiente',
14 |     'previous' => 'Anterior',
15 | ];
16 | 


--------------------------------------------------------------------------------
/src/Languages/pt-br/pagination.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | return [
11 |     'first' => 'Primeira',
12 |     'last' => 'Última',
13 |     'next' => 'Próxima',
14 |     'previous' => 'Anterior',
15 | ];
16 | 


--------------------------------------------------------------------------------
/src/Views/head.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | ?>
14 | 
15 | <?php if ($pager->getPreviousPage()) : ?>
16 |     <link rel="prev" href="<?= $pager->getPreviousPageUrl() ?>">
17 | <?php endif ?>
18 | <link rel="canonical" href="<?= $pager->getCurrentPageUrl() ?>">
19 | <?php if ($pager->getNextPage()) : ?>
20 |     <link rel="next" href="<?= $pager->getNextPageUrl() ?>">
21 | <?php endif ?>
22 | 


--------------------------------------------------------------------------------
/src/Views/header.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * HTTP Header Link.
12 |  *
13 |  * @see https://tools.ietf.org/html/rfc5988
14 |  *
15 |  * @var Framework\Pagination\Pager $pager
16 |  */
17 | $links = '';
18 | 
19 | if ($pager->getPreviousPage()) {
20 |     $links .= '<' . $pager->getFirstPageUrl() . '>; rel="first",';
21 |     $links .= '<' . $pager->getPreviousPageUrl() . '>; rel="prev"';
22 | }
23 | 
24 | if ($pager->getNextPage()) {
25 |     if ($links !== '') {
26 |         $links .= ',';
27 |     }
28 |     $links .= '<' . $pager->getNextPageUrl() . '>; rel="next",';
29 |     $links .= '<' . $pager->getLastPageUrl() . '>; rel="last"';
30 | }
31 | 
32 | echo $links;
33 | 


--------------------------------------------------------------------------------
/src/Views/foundation-short.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <ul class="pagination text-center">
16 |     <?php if ($pager->getPreviousPage()) : ?>
17 |         <li>
18 |             <a rel="prev" href="<?= $pager->getPreviousPageUrl() ?>">
19 |                 <?= $language->render('pagination', 'previous') ?>
20 |             </a>
21 |         </li>
22 |     <?php endif ?>
23 | 
24 |     <?php if ($pager->getNextPage()) : ?>
25 |         <li>
26 |             <a rel="next" href="<?= $pager->getNextPageUrl() ?>">
27 |                 <?= $language->render('pagination', 'next') ?>
28 |             </a>
29 |         </li>
30 |     <?php endif ?>
31 | </ul>
32 | 


--------------------------------------------------------------------------------
/src/Views/w3-short.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <div class="w3-center">
16 |     <div class="w3-bar">
17 |         <?php if ($pager->getPreviousPage()) : ?>
18 |             <a rel="prev" href="<?= $pager->getPreviousPageUrl() ?>" class="w3-button">
19 |                 <?= $language->render('pagination', 'previous') ?>
20 |             </a>
21 |         <?php endif ?>
22 | 
23 |         <?php if ($pager->getNextPage()) : ?>
24 |             <a rel="next" href="<?= $pager->getNextPageUrl() ?>" class="w3-button">
25 |                 <?= $language->render('pagination', 'next') ?>
26 |             </a>
27 |         <?php endif ?>
28 |     </div>
29 | </div>
30 | 


--------------------------------------------------------------------------------
/src/Views/semantic-ui-short.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <div class="ui container center aligned">
16 |     <div class="ui pagination menu">
17 |         <?php if ($pager->getPreviousPage()) : ?>
18 |             <a class="item" rel="prev" href="<?= $pager->getPreviousPageUrl() ?>">
19 |                 <?= $language->render('pagination', 'previous') ?>
20 |             </a>
21 |         <?php endif ?>
22 | 
23 |         <?php if ($pager->getNextPage()) : ?>
24 |             <a class="item" rel="next" href="<?= $pager->getNextPageUrl() ?>">
25 |                 <?= $language->render('pagination', 'next') ?>
26 |             </a>
27 |         <?php endif ?>
28 |     </div>
29 | </div>
30 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | <a href="https://github.com/aplus-framework/pagination"><img src="https://raw.githubusercontent.com/aplus-framework/pagination/master/guide/image.png" alt="Aplus Framework Pagination Library" align="right" width="100"></a>
 2 | 
 3 | # Aplus Framework Pagination Library
 4 | 
 5 | - [Home](https://aplus-framework.com/packages/pagination)
 6 | - [User Guide](https://docs.aplus-framework.com/guides/libraries/pagination/index.html)
 7 | - [API Documentation](https://docs.aplus-framework.com/packages/pagination.html)
 8 | 
 9 | [![tests](https://github.com/aplus-framework/pagination/actions/workflows/tests.yml/badge.svg)](https://github.com/aplus-framework/pagination/actions/workflows/tests.yml)
10 | [![coverage](https://coveralls.io/repos/github/aplus-framework/pagination/badge.svg?branch=master)](https://coveralls.io/github/aplus-framework/pagination?branch=master)
11 | [![packagist](https://img.shields.io/packagist/v/aplus/pagination)](https://packagist.org/packages/aplus/pagination)
12 | [![open-source](https://img.shields.io/badge/open--source-sponsor-magenta)](https://aplus-framework.com/sponsor)
13 | 


--------------------------------------------------------------------------------
/src/Views/bootstrap-short.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <ul class="pagination justify-content-center">
16 |     <?php if ($pager->getPreviousPage()) : ?>
17 |         <li class="page-item">
18 |             <a class="page-link" rel="prev" href="<?= $pager->getPreviousPageUrl() ?>">
19 |                 <?= $language->render('pagination', 'previous') ?>
20 |             </a>
21 |         </li>
22 |     <?php endif ?>
23 | 
24 |     <?php if ($pager->getNextPage()) : ?>
25 |         <li class="page-item">
26 |             <a class="page-link" rel="next" href="<?= $pager->getNextPageUrl() ?>">
27 |                 <?= $language->render('pagination', 'next') ?>
28 |             </a>
29 |         </li>
30 |     <?php endif ?>
31 | </ul>
32 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2019 Natan Felles
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/src/Views/bulma-short.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <nav class="pagination is-centered">
16 |     <ul class="pagination-list">
17 |         <?php if ($pager->getPreviousPage()) : ?>
18 |             <li>
19 |                 <a class="pagination-link" rel="prev" href="<?= $pager->getPreviousPageUrl() ?>">
20 |                     <?= $language->render('pagination', 'previous') ?>
21 |                 </a>
22 |             </li>
23 |         <?php endif ?>
24 | 
25 |         <?php if ($pager->getNextPage()) : ?>
26 |             <li>
27 |                 <a class="pagination-link" rel="next" href="<?= $pager->getNextPageUrl() ?>">
28 |                     <?= $language->render('pagination', 'next') ?>
29 |                 </a>
30 |             </li>
31 |         <?php endif ?>
32 |     </ul>
33 | </nav>
34 | 


--------------------------------------------------------------------------------
/src/Views/pagination-short.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <ul class="pagination">
16 |     <?php if ($pager->getPreviousPage()) : ?>
17 |         <li>
18 |             <a rel="prev" href="<?= $pager->getPreviousPageUrl() ?>" title="<?= $pager->getLanguage()
19 |         ->render('pagination', 'previous') ?>">
20 |                 &laquo; <?= $language->render('pagination', 'previous') ?>
21 |             </a>
22 |         </li>
23 |     <?php endif ?>
24 | 
25 |     <?php if ($pager->getNextPage()) : ?>
26 |         <li>
27 |             <a rel="next" href="<?= $pager->getNextPageUrl() ?>" title="<?= $pager->getLanguage()
28 |         ->render('pagination', 'next') ?>">
29 |                 <?= $language->render('pagination', 'next') ?> &raquo; </a>
30 |         </li>
31 |     <?php endif ?>
32 | </ul>
33 | 


--------------------------------------------------------------------------------
/src/Views/tailwind-short.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <div class="text-center">
16 |     <?php if ($pager->getPreviousPage()) : ?>
17 |         <a href="<?= $pager->getPreviousPageUrl() ?>" class="relative inline-flex items-center px-2 py-2 rounded-md border border-gray-300 bg-white text-sm font-medium text-gray-500 hover:bg-gray-50">
18 |             <?= $language->render('pagination', 'previous') ?>
19 |         </a>
20 |     <?php endif ?>
21 | 
22 |     <?php if ($pager->getNextPage()) : ?>
23 |         <a href="<?= $pager->getNextPageUrl() ?>" class="relative inline-flex items-center px-2 py-2 rounded-md border border-gray-300 bg-white text-sm font-medium text-gray-500 hover:bg-gray-50">
24 |             <?= $language->render('pagination', 'next') ?>
25 |         </a>
26 |     <?php endif ?>
27 | </div>
28 | 


--------------------------------------------------------------------------------
/src/Views/materialize-short.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <ul class="pagination center-align">
16 |     <?php if ($pager->getPreviousPage()) : ?>
17 |         <li class="waves-effect">
18 |             <a rel="prev" href="<?= $pager->getPreviousPageUrl() ?>" title="<?=
19 |             $language->render('pagination', 'previous') ?>">
20 |                 <i class="material-icons">chevron_left</i>
21 |             </a>
22 |         </li>
23 |     <?php endif ?>
24 | 
25 |     <?php if ($pager->getNextPage()) : ?>
26 |         <li class="waves-effect">
27 |             <a rel="next" href="<?= $pager->getNextPageUrl() ?>" title="<?=
28 |             $language->render('pagination', 'next') ?>">
29 |                 <i class="material-icons">chevron_right</i>
30 |             </a>
31 |         </li>
32 |     <?php endif ?>
33 | </ul>
34 | 


--------------------------------------------------------------------------------
/src/Views/primer-short.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <nav class="paginate-container" aria-label="Pagination">
16 |     <div class="pagination">
17 |         <?php if ($pager->getPreviousPage()) : ?>
18 |             <a class="previous_page" rel="prev" href="<?= $pager->getPreviousPageUrl() ?>" aria-label="Previous Page">
19 |                 <?= $language->render('pagination', 'previous') ?>
20 |             </a>
21 |         <?php else: ?>
22 |             <span class="previous_page" aria-disabled="true">
23 |                 <?= $language->render('pagination', 'previous') ?>
24 |             </span>
25 |         <?php endif ?>
26 | 
27 |         <?php if ($pager->getNextPage()) : ?>
28 |             <a class="next_page" rel="next" href="<?= $pager->getNextPageUrl() ?>" aria-label="Next Page">
29 |                 <?= $language->render('pagination', 'next') ?>
30 |             </a>
31 |         <?php else: ?>
32 |             <span class="next_page" aria-disabled="true">
33 |                 <?= $language->render('pagination', 'next') ?>
34 |             </span>
35 |         <?php endif ?>
36 |     </div>
37 | </nav>
38 | 


--------------------------------------------------------------------------------
/.phpstorm.meta.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | namespace PHPSTORM_META;
11 | 
12 | registerArgumentsSet(
13 |     'views',
14 |     'head',
15 |     'header',
16 |     'pager',
17 |     'pagination',
18 |     'pagination-short',
19 |     'bootstrap',
20 |     'bootstrap-short',
21 |     'bootstrap5',
22 |     'bootstrap5-short',
23 |     'bulma',
24 |     'bulma-short',
25 |     'bulma1',
26 |     'bulma1-short',
27 |     'foundation',
28 |     'foundation-short',
29 |     'foundation6',
30 |     'foundation6-short',
31 |     'materialize',
32 |     'materialize-short',
33 |     'materialize1',
34 |     'materialize1-short',
35 |     'primer',
36 |     'primer-short',
37 |     'primer20',
38 |     'primer20-short',
39 |     'semantic-ui',
40 |     'semantic-ui-short',
41 |     'semantic-ui2',
42 |     'semantic-ui2-short',
43 |     'tailwind',
44 |     'tailwind-short',
45 |     'tailwind3',
46 |     'tailwind3-short',
47 |     'w3',
48 |     'w3-short',
49 |     'w34',
50 |     'w34-short',
51 | );
52 | expectedArguments(
53 |     \Framework\Pagination\Pager::getView(),
54 |     0,
55 |     argumentsSet('views')
56 | );
57 | expectedArguments(
58 |     \Framework\Pagination\Pager::render(),
59 |     0,
60 |     argumentsSet('views')
61 | );
62 | expectedArguments(
63 |     \Framework\Pagination\Pager::setDefaultView(),
64 |     0,
65 |     argumentsSet('views')
66 | );
67 | expectedArguments(
68 |     \Framework\Pagination\Pager::setView(),
69 |     0,
70 |     argumentsSet('views')
71 | );
72 | 


--------------------------------------------------------------------------------
/src/Views/foundation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <ul class="pagination text-center">
16 |     <?php if ($pager->getCurrentPage() - $pager->getSurround() > 1) : ?>
17 |         <li>
18 |             <a href="<?= $pager->getFirstPageUrl() ?>"><?= $pager->getLanguage()
19 |         ->render('pagination', 'first') ?></a>
20 |         </li>
21 |     <?php endif ?>
22 | 
23 |     <?php if ($pager->getPreviousPage()) : ?>
24 |         <li>
25 |             <a href="<?= $pager->getPreviousPageUrl() ?>" rel="prev" title="<?=
26 |             $language->render('pagination', 'previous') ?>">&laquo;</a>
27 |         </li>
28 |     <?php endif ?>
29 | 
30 |     <?php foreach ($pager->getPreviousPagesUrls() as $p => $url) : ?>
31 |         <li>
32 |             <a href="<?= $url ?>"><?= $p ?></a>
33 |         </li>
34 |     <?php endforeach ?>
35 | 
36 |     <li class="current">
37 |         <?= $pager->getCurrentPage() ?>
38 |     </li>
39 | 
40 |     <?php foreach ($pager->getNextPagesUrls() as $p => $url) : ?>
41 |         <li>
42 |             <a href="<?= $url ?>"><?= $p ?></a>
43 |         </li>
44 |     <?php endforeach ?>
45 | 
46 |     <?php if ($pager->getNextPage() && $pager->getNextPage() < $pager->getLastPage() + 1) : ?>
47 |         <li>
48 |             <a href="<?= $pager->getNextPageUrl() ?>" rel="next" title="<?=
49 |             $language->render('pagination', 'next') ?>">&raquo;</a>
50 |         </li>
51 |     <?php endif ?>
52 | 
53 |     <?php if ($pager->getLastPage()
54 |         && $pager->getCurrentPage() + $pager->getSurround() < $pager->getLastPage()
55 |     ) : ?>
56 |         <li>
57 |             <a href="<?= $pager->getLastPageUrl() ?>"><?= $pager->getLanguage()
58 |         ->render('pagination', 'last') ?></a>
59 |         </li>
60 |     <?php endif ?>
61 | </ul>
62 | 


--------------------------------------------------------------------------------
/src/Views/semantic-ui.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <div class="ui container center aligned">
16 |     <div class="ui pagination menu">
17 |         <?php if ($pager->getCurrentPage() - $pager->getSurround() > 1) : ?>
18 |             <a class="item" href="<?= $pager->getFirstPageUrl() ?>"><?= $pager->getLanguage()
19 |             ->render('pagination', 'first') ?></a>
20 |         <?php endif ?>
21 | 
22 |         <?php if ($pager->getPreviousPage()) : ?>
23 |             <a class="item" rel="prev" href="<?= $pager->getPreviousPageUrl() ?>" title="<?=
24 |             $language->render('pagination', 'previous') ?>">&laquo;</a>
25 |         <?php endif ?>
26 | 
27 |         <?php foreach ($pager->getPreviousPagesUrls() as $p => $url) : ?>
28 |             <a class="item" href="<?= $url ?>"><?= $p ?></a>
29 |         <?php endforeach ?>
30 | 
31 |         <a class="item active" rel="canonical" href="<?= $pager->getCurrentPageUrl() ?>">
32 |             <?= $pager->getCurrentPage() ?>
33 |         </a>
34 | 
35 |         <?php foreach ($pager->getNextPagesUrls() as $p => $url) : ?>
36 |             <a class="item" href="<?= $url ?>"><?= $p ?></a>
37 |         <?php endforeach ?>
38 | 
39 |         <?php if ($pager->getNextPage() && $pager->getNextPage() < $pager->getLastPage() + 1) : ?>
40 |             <a class="item" rel="next" href="<?= $pager->getNextPageUrl() ?>" title="<?=
41 |             $language->render('pagination', 'next') ?>">&raquo;</a>
42 |         <?php endif ?>
43 | 
44 |         <?php if ($pager->getLastPage()
45 |             && $pager->getCurrentPage() + $pager->getSurround() < $pager->getLastPage()
46 |         ) : ?>
47 |             <a class="item" href="<?= $pager->getLastPageUrl() ?>"><?= $pager->getLanguage()
48 |             ->render('pagination', 'last') ?></a>
49 |         <?php endif ?>
50 |     </div>
51 | </div>
52 | 


--------------------------------------------------------------------------------
/src/Views/w3.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <div class="w3-center">
16 |     <div class="w3-bar">
17 |         <?php if ($pager->getCurrentPage() - $pager->getSurround() > 1) : ?>
18 |             <a class="w3-button" href="<?= $pager->getFirstPageUrl() ?>"><?= $pager->getLanguage()
19 |             ->render('pagination', 'first') ?></a>
20 |         <?php endif ?>
21 | 
22 |         <?php if ($pager->getPreviousPage()) : ?>
23 |             <a class="w3-button" rel="prev" href="<?= $pager->getPreviousPageUrl() ?>" title="<?=
24 |             $language->render('pagination', 'previous') ?>">&laquo;</a>
25 |         <?php endif ?>
26 | 
27 |         <?php foreach ($pager->getPreviousPagesUrls() as $p => $url) : ?>
28 |             <a href="<?= $url ?>" class="w3-button"><?= $p ?></a>
29 |         <?php endforeach ?>
30 | 
31 |         <a href="<?= $pager->getCurrentPageUrl() ?>" rel="canonical" class="w3-button w3-blue w3-hover-blue">
32 |             <?= $pager->getCurrentPage() ?>
33 |         </a>
34 | 
35 |         <?php foreach ($pager->getNextPagesUrls() as $p => $url) : ?>
36 |             <a href="<?= $url ?>" class="w3-button"><?= $p ?></a>
37 |         <?php endforeach ?>
38 | 
39 |         <?php if ($pager->getNextPage() && $pager->getNextPage() < $pager->getLastPage() + 1) : ?>
40 |             <a class="w3-button" rel="next" href="<?= $pager->getNextPageUrl() ?>" title="<?=
41 |             $language->render('pagination', 'next') ?>">&raquo;</a>
42 |         <?php endif ?>
43 | 
44 |         <?php if ($pager->getLastPage()
45 |             && $pager->getCurrentPage() + $pager->getSurround() < $pager->getLastPage()
46 |         ) : ?>
47 |             <a class="w3-button" href="<?= $pager->getLastPageUrl() ?>"><?= $pager->getLanguage()
48 |             ->render('pagination', 'last') ?></a>
49 |         <?php endif ?>
50 |     </div>
51 | </div>
52 | 


--------------------------------------------------------------------------------
/src/Views/pagination.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <ul class="pagination">
16 |     <?php if ($pager->getCurrentPage() - $pager->getSurround() > 1) : ?>
17 |         <li>
18 |             <a href="<?= $pager->getFirstPageUrl() ?>"><?= $pager->getLanguage()
19 |         ->render('pagination', 'first') ?></a>
20 |         </li>
21 |     <?php endif ?>
22 | 
23 |     <?php if ($pager->getPreviousPage()) : ?>
24 |         <li>
25 |             <a rel="prev" href="<?= $pager->getPreviousPageUrl() ?>" title="<?=
26 |             $language->render('pagination', 'previous') ?>">&laquo;</a>
27 |         </li>
28 |     <?php endif ?>
29 | 
30 |     <?php foreach ($pager->getPreviousPagesUrls() as $p => $url) : ?>
31 |         <li>
32 |             <a href="<?= $url ?>"><?= $p ?></a>
33 |         </li>
34 |     <?php endforeach ?>
35 | 
36 |     <li>
37 |         <a rel="canonical" href="<?= $pager->getCurrentPageUrl() ?>" class="active">
38 |             <?= $pager->getCurrentPage() ?>
39 |         </a>
40 |     </li>
41 | 
42 |     <?php foreach ($pager->getNextPagesUrls() as $p => $url) : ?>
43 |         <li>
44 |             <a href="<?= $url ?>"><?= $p ?></a>
45 |         </li>
46 |     <?php endforeach ?>
47 | 
48 |     <?php if ($pager->getNextPage() && $pager->getNextPage() < $pager->getLastPage() + 1) : ?>
49 |         <li>
50 |             <a rel="next" href="<?= $pager->getNextPageUrl() ?>" title="<?=
51 |             $language->render('pagination', 'next') ?>">&raquo;</a>
52 |         </li>
53 |     <?php endif ?>
54 | 
55 |     <?php if ($pager->getLastPage()
56 |         && $pager->getCurrentPage() + $pager->getSurround() < $pager->getLastPage()
57 |     ) : ?>
58 |         <li>
59 |             <a href="<?= $pager->getLastPageUrl() ?>"><?= $pager->getLanguage()
60 |         ->render('pagination', 'last') ?></a>
61 |         </li>
62 |     <?php endif ?>
63 | </ul>
64 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "aplus/pagination",
 3 |     "description": "Aplus Framework Pagination Library",
 4 |     "license": "MIT",
 5 |     "type": "library",
 6 |     "keywords": [
 7 |         "pager",
 8 |         "pagination",
 9 |         "bootstrap",
10 |         "bulma",
11 |         "semantic-ui",
12 |         "tailwind",
13 |         "foundation"
14 |     ],
15 |     "authors": [
16 |         {
17 |             "name": "Natan Felles",
18 |             "email": "natanfelles@gmail.com",
19 |             "homepage": "https://natanfelles.github.io"
20 |         }
21 |     ],
22 |     "homepage": "https://aplus-framework.com/packages/pagination",
23 |     "support": {
24 |         "email": "support@aplus-framework.com",
25 |         "issues": "https://github.com/aplus-framework/pagination/issues",
26 |         "forum": "https://aplus-framework.com/forum",
27 |         "source": "https://github.com/aplus-framework/pagination",
28 |         "docs": "https://docs.aplus-framework.com/guides/libraries/pagination/"
29 |     },
30 |     "funding": [
31 |         {
32 |             "type": "Aplus Sponsor",
33 |             "url": "https://aplus-framework.com/sponsor"
34 |         }
35 |     ],
36 |     "require": {
37 |         "php": ">=8.3",
38 |         "ext-json": "*",
39 |         "aplus/helpers": "^4.0",
40 |         "aplus/http": "^6.0",
41 |         "aplus/language": "^4.0"
42 |     },
43 |     "require-dev": {
44 |         "ext-xdebug": "*",
45 |         "aplus/coding-standard": "^2.8",
46 |         "ergebnis/composer-normalize": "^2.25",
47 |         "jetbrains/phpstorm-attributes": "^1.0",
48 |         "phpmd/phpmd": "^2.13",
49 |         "phpstan/phpstan": "^1.5",
50 |         "phpunit/phpunit": "^10.5"
51 |     },
52 |     "minimum-stability": "dev",
53 |     "prefer-stable": true,
54 |     "autoload": {
55 |         "psr-4": {
56 |             "Framework\\Pagination\\": "src/"
57 |         }
58 |     },
59 |     "autoload-dev": {
60 |         "psr-4": {
61 |             "Tests\\Pagination\\": "tests/"
62 |         }
63 |     },
64 |     "config": {
65 |         "allow-plugins": {
66 |             "ergebnis/composer-normalize": true
67 |         },
68 |         "optimize-autoloader": true,
69 |         "preferred-install": "dist",
70 |         "sort-packages": true
71 |     }
72 | }
73 | 


--------------------------------------------------------------------------------
/src/Views/bootstrap.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <ul class="pagination justify-content-center">
16 |     <?php if ($pager->getCurrentPage() - $pager->getSurround() > 1) : ?>
17 |         <li class="page-item">
18 |             <a class="page-link" href="<?= $pager->getFirstPageUrl() ?>"><?= $pager->getLanguage()
19 |         ->render('pagination', 'first') ?></a>
20 |         </li>
21 |     <?php endif ?>
22 | 
23 |     <?php if ($pager->getPreviousPage()) : ?>
24 |         <li class="page-item">
25 |             <a class="page-link" rel="prev" href="<?= $pager->getPreviousPageUrl() ?>" title="<?=
26 |             $language->render('pagination', 'previous') ?>">&laquo;</a>
27 |         </li>
28 |     <?php endif ?>
29 | 
30 |     <?php foreach ($pager->getPreviousPagesUrls() as $p => $url) : ?>
31 |         <li class="page-item">
32 |             <a class="page-link" href="<?= $url ?>"><?= $p ?></a>
33 |         </li>
34 |     <?php endforeach ?>
35 | 
36 |     <li class="page-item active">
37 |         <a class="page-link" rel="canonical" href="<?= $pager->getCurrentPageUrl() ?>">
38 |             <?= $pager->getCurrentPage() ?>
39 |         </a>
40 |     </li>
41 | 
42 |     <?php foreach ($pager->getNextPagesUrls() as $p => $url) : ?>
43 |         <li class="page-item">
44 |             <a class="page-link" href="<?= $url ?>"><?= $p ?></a>
45 |         </li>
46 |     <?php endforeach ?>
47 | 
48 |     <?php if ($pager->getNextPage() && $pager->getNextPage() < $pager->getLastPage() + 1) : ?>
49 |         <li class="page-item">
50 |             <a class="page-link" rel="next" href="<?= $pager->getNextPageUrl() ?>" title="<?=
51 |             $language->render('pagination', 'next') ?>">&raquo;</a>
52 |         </li>
53 |     <?php endif ?>
54 | 
55 |     <?php if ($pager->getLastPage()
56 |         && $pager->getCurrentPage() + $pager->getSurround() < $pager->getLastPage()
57 |     ) : ?>
58 |         <li class="page-item">
59 |             <a class="page-link" href="<?= $pager->getLastPageUrl() ?>"><?= $pager->getLanguage()
60 |         ->render('pagination', 'last') ?></a>
61 |         </li>
62 |     <?php endif ?>
63 | </ul>
64 | 


--------------------------------------------------------------------------------
/src/Views/materialize.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <ul class="pagination center-align">
16 |     <?php if ($pager->getCurrentPage() - $pager->getSurround() > 1) : ?>
17 |         <li class="waves-effect">
18 |             <a href="<?= $pager->getFirstPageUrl() ?>"><?= $pager->getLanguage()
19 |         ->render('pagination', 'first') ?></a>
20 |         </li>
21 |     <?php endif ?>
22 | 
23 |     <?php if ($pager->getPreviousPage()) : ?>
24 |         <li class="waves-effect">
25 |             <a rel="prev" href="<?= $pager->getPreviousPageUrl() ?>" title="<?=
26 |             $language->render('pagination', 'previous') ?>">
27 |                 <i class="material-icons">chevron_left</i>
28 |             </a>
29 |         </li>
30 |     <?php endif ?>
31 | 
32 |     <?php foreach ($pager->getPreviousPagesUrls() as $p => $url) : ?>
33 |         <li class="waves-effect">
34 |             <a href="<?= $url ?>"><?= $p ?></a>
35 |         </li>
36 |     <?php endforeach ?>
37 | 
38 |     <li class="active">
39 |         <a rel="canonical" href="<?= $pager->getCurrentPageUrl() ?>">
40 |             <?= $pager->getCurrentPage() ?>
41 |         </a>
42 |     </li>
43 | 
44 |     <?php foreach ($pager->getNextPagesUrls() as $p => $url) : ?>
45 |         <li class="waves-effect">
46 |             <a href="<?= $url ?>"><?= $p ?></a>
47 |         </li>
48 |     <?php endforeach ?>
49 | 
50 |     <?php if ($pager->getNextPage() && $pager->getNextPage() < $pager->getLastPage() + 1) : ?>
51 |         <li class="waves-effect">
52 |             <a rel="next" href="<?= $pager->getNextPageUrl() ?>" title="<?=
53 |             $language->render('pagination', 'next') ?>">
54 |                 <i class="material-icons">chevron_right</i>
55 |             </a>
56 |         </li>
57 |     <?php endif ?>
58 | 
59 |     <?php if ($pager->getLastPage()
60 |         && $pager->getCurrentPage() + $pager->getSurround() < $pager->getLastPage()
61 |     ) : ?>
62 |         <li class="waves-effect">
63 |             <a href="<?= $pager->getLastPageUrl() ?>"><?= $pager->getLanguage()
64 |         ->render('pagination', 'last') ?></a>
65 |         </li>
66 |     <?php endif ?>
67 | </ul>
68 | 
69 | 


--------------------------------------------------------------------------------
/src/Views/bulma.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <nav class="pagination is-centered">
16 |     <ul class="pagination-list">
17 |         <?php if ($pager->getCurrentPage() - $pager->getSurround() > 1) : ?>
18 |             <li>
19 |                 <a class="pagination-link" href="<?= $pager->getFirstPageUrl() ?>"><?= $pager->getLanguage()
20 |             ->render('pagination', 'first') ?></a>
21 |             </li>
22 |         <?php endif ?>
23 | 
24 |         <?php if ($pager->getPreviousPage()) : ?>
25 |             <li>
26 |                 <a class="pagination-link" rel="prev" href="<?= $pager->getPreviousPageUrl(); ?>" title="<?=
27 |                 $language->render('pagination', 'previous') ?>">&laquo;</a>
28 |             </li>
29 |         <?php endif ?>
30 | 
31 |         <?php foreach ($pager->getPreviousPagesUrls() as $p => $url) : ?>
32 |             <li>
33 |                 <a class="pagination-link" href="<?= $url ?>"><?= $p ?></a>
34 |             </li>
35 |         <?php endforeach ?>
36 | 
37 |         <li>
38 |             <a class="pagination-link is-current" rel="canonical" href="<?= $pager->getCurrentPageUrl() ?>">
39 |                 <?= $pager->getCurrentPage() ?>
40 |             </a>
41 |         </li>
42 | 
43 |         <?php foreach ($pager->getNextPagesUrls() as $p => $url) : ?>
44 |             <li>
45 |                 <a class="pagination-link" href="<?= $url ?>"><?= $p ?></a>
46 |             </li>
47 |         <?php endforeach ?>
48 | 
49 |         <?php if ($pager->getNextPage() && $pager->getNextPage() < $pager->getLastPage() + 1) : ?>
50 |             <li>
51 |                 <a class="pagination-link" rel="next" href="<?= $pager->getNextPageUrl() ?>" title="<?=
52 |                 $language->render('pagination', 'next') ?>">&raquo;</a>
53 |             </li>
54 |         <?php endif ?>
55 | 
56 |         <?php if ($pager->getLastPage()
57 |             && $pager->getCurrentPage() + $pager->getSurround() < $pager->getLastPage()
58 |         ) : ?>
59 |             <li>
60 |                 <a class="pagination-link" href="<?= $pager->getLastPageUrl() ?>"><?= $pager->getLanguage()
61 |             ->render('pagination', 'last') ?></a>
62 |             </li>
63 |         <?php endif ?>
64 |     </ul>
65 | </nav>
66 | 


--------------------------------------------------------------------------------
/src/Views/primer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | ?>
15 | <nav class="paginate-container" aria-label="Pagination">
16 |     <div class="pagination">
17 | 
18 |         <?php if ($pager->getPreviousPage()) : ?>
19 |             <a class="previous_page" rel="prev" href="<?=
20 |             $pager->getPreviousPageUrl() ?>" aria-label="<?=
21 |             $language->render('pagination', 'previous') ?>"><?=
22 |                 $language->render('pagination', 'previous') ?></a>
23 |         <?php else: ?>
24 |             <span class="previous_page" aria-disabled="true"><?=
25 |                 $language->render('pagination', 'previous') ?></span>
26 |         <?php endif ?>
27 | 
28 |         <?php
29 |         $page = array_key_first($pager->getPreviousPagesUrls());
30 | ?>
31 |         <?php if ($page > 1): ?>
32 |             <a href="<?= $pager->getFirstPageUrl() ?>" aria-label="Page <?= $pager->getFirstPage() ?>" title="<?=
33 |     $pager->getLanguage()->render('pagination', 'first') ?>">
34 |                 <?= $pager->getFirstPage() ?>
35 |             </a>
36 |             <?php if ($page > 2): ?>
37 |                 <a href="<?= $pager->getPageUrl(2) ?>" aria-label="Page 2">
38 |                     2
39 |                 </a>
40 |                 <?php if ($page > 3): ?>
41 |                     <span class="gap">…</span>
42 |                 <?php endif ?>
43 |             <?php endif ?>
44 |         <?php endif ?>
45 | 
46 |         <?php foreach ($pager->getPreviousPagesUrls() as $p => $url) : ?>
47 |             <a href="<?= $url ?>" aria-label="Page <?= $p ?>"><?= $p ?></a>
48 |         <?php endforeach ?>
49 | 
50 |         <em aria-current="page"><?= $pager->getCurrentPage() ?></em>
51 | 
52 |         <?php foreach ($pager->getNextPagesUrls() as $p => $url) : ?>
53 |             <a href="<?= $url ?>" aria-label="Page <?= $p ?>"><?= $p ?></a>
54 |         <?php endforeach ?>
55 | 
56 |         <?php
57 | $page = array_key_last($pager->getNextPagesUrls());
58 | $lastPage = $pager->getLastPage();
59 | ?>
60 |         <?php if ($page >= $pager->getCurrentPage()): ?>
61 |             <?php if ($page < $lastPage - 2): ?>
62 |                 <span class="gap">…</span>
63 |             <?php endif ?>
64 |             <?php if ($page < $lastPage - 1): ?>
65 |                 <a href="<?= $pager->getPageUrl($lastPage - 1) ?>" aria-label="Page <?= $lastPage - 1 ?>">
66 |                     <?= $lastPage - 1 ?>
67 |                 </a>
68 |             <?php endif ?>
69 |             <?php if ($page < $lastPage): ?>
70 |                 <a href="<?= $pager->getLastPageUrl() ?>" aria-label="Page <?= $pager->getLastPage() ?>" title="<?=
71 |         $pager->getLanguage()->render('pagination', 'last') ?>">
72 |                     <?= $pager->getLastPage() ?>
73 |                 </a>
74 |             <?php endif ?>
75 |         <?php endif ?>
76 | 
77 |         <?php if ($pager->getNextPage() && $pager->getNextPage() < $pager->getLastPage() + 1) : ?>
78 |             <a class="next_page" rel="next" href="<?=
79 |     $pager->getNextPageUrl() ?>" aria-label="<?=
80 |     $language->render('pagination', 'next') ?>"><?=
81 |         $language->render('pagination', 'next') ?></a>
82 |         <?php else: ?>
83 |             <span class="next_page" aria-disabled="true"><?=
84 |         $language->render('pagination', 'next') ?></span>
85 |         <?php endif ?>
86 | 
87 |     </div>
88 | </nav>
89 | 


--------------------------------------------------------------------------------
/src/Views/tailwind.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * This file is part of Aplus Framework Pagination Library.
 4 |  *
 5 |  * (c) Natan Felles <natanfelles@gmail.com>
 6 |  *
 7 |  * For the full copyright and license information, please view the LICENSE
 8 |  * file that was distributed with this source code.
 9 |  */
10 | /**
11 |  * @var Framework\Pagination\Pager $pager
12 |  */
13 | $language = $pager->getLanguage();
14 | $hasFirst = $pager->getCurrentPage() - $pager->getSurround() > 1;
15 | $hasLast = $pager->getLastPage()
16 |     && $pager->getCurrentPage() + $pager->getSurround() < $pager->getLastPage();
17 | $hasPrev = $pager->getPreviousPage();
18 | ?>
19 | <div class="text-center">
20 |     <nav class="relative z-0 inline-flex rounded-md shadow-sm -space-x-px">
21 |         <?php if ($hasFirst) : ?>
22 |             <a href="<?= $pager->getFirstPageUrl() ?>" class="relative inline-flex items-center px-2 py-2 rounded-l-md border border-gray-300 bg-white text-sm font-medium text-gray-500 hover:bg-gray-50">
23 |                 <?= $language->render('pagination', 'first') ?>
24 |             </a>
25 |         <?php endif ?>
26 | 
27 |         <?php if ($hasPrev) : ?>
28 |             <a href="<?= $pager->getPreviousPageUrl() ?>" class="relative inline-flex items-center px-2 py-2<?= $hasFirst
29 |                 ? ''
30 |                 : ' rounded-l-md' ?> border border-gray-300 bg-white text-sm font-medium text-gray-500 hover:bg-gray-50" title="<?= $pager->getLanguage()
31 |                     ->render('pagination', 'previous') ?>">
32 |                 <span class="sr-only"><?= $pager->getLanguage()
33 |                     ->render('pagination', 'previous') ?></span>
34 |                 <svg class="h-5 w-5" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true">
35 |                     <path fill-rule="evenodd" d="M12.707 5.293a1 1 0 010 1.414L9.414 10l3.293 3.293a1 1 0 01-1.414 1.414l-4-4a1 1 0 010-1.414l4-4a1 1 0 011.414 0z" clip-rule="evenodd"/>
36 |                 </svg>
37 |             </a>
38 |         <?php endif ?>
39 | 
40 |         <?php foreach ($pager->getPreviousPagesUrls() as $p => $url) : ?>
41 |             <a href="<?= $url ?>" class="bg-white border-gray-300 text-gray-500 hover:bg-gray-50 relative inline-flex items-center px-4 py-2 border text-sm font-medium">
42 |                 <?= $p ?>
43 |             </a>
44 |         <?php endforeach ?>
45 | 
46 |         <a href="<?= $pager->getCurrentPageUrl() ?>" rel="canonical" aria-current="page" class="z-10 bg-indigo-50 border-indigo-500 text-indigo-600 relative inline-flex items-center px-4 py-2<?= $hasPrev
47 |             ? ''
48 |             : ' rounded-l-md' ?><?= $pager->getNextPage() ? ''
49 |             : ' rounded-r-md' ?> border text-sm font-medium">
50 |             <?= $pager->getCurrentPage() ?>
51 |         </a>
52 | 
53 |         <?php foreach ($pager->getNextPagesUrls() as $p => $url) : ?>
54 |             <a href="<?= $url ?>" class="bg-white border-gray-300 text-gray-500 hover:bg-gray-50 relative inline-flex items-center px-4 py-2 border text-sm font-medium">
55 |                 <?= $p ?>
56 |             </a>
57 |         <?php endforeach ?>
58 | 
59 |         <?php if ($pager->getNextPage() && $pager->getNextPage() < $pager->getLastPage() + 1) : ?>
60 |             <a href="<?= $pager->getNextPageUrl() ?>" class="relative inline-flex items-center px-2 py-2<?= $hasLast
61 |                 ? ''
62 |                 : ' rounded-r-md' ?> border border-gray-300 bg-white text-sm font-medium text-gray-500 hover:bg-gray-50" title="<?= $pager->getLanguage()
63 |                     ->render('pagination', 'next') ?>">
64 |                 <span class="sr-only"><?= $pager->getLanguage()
65 |                     ->render('pagination', 'next') ?></span>
66 |                 <svg class="h-5 w-5" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true">
67 |                     <path fill-rule="evenodd" d="M7.293 14.707a1 1 0 010-1.414L10.586 10 7.293 6.707a1 1 0 011.414-1.414l4 4a1 1 0 010 1.414l-4 4a1 1 0 01-1.414 0z" clip-rule="evenodd"/>
68 |                 </svg>
69 |             </a>
70 |         <?php endif ?>
71 | 
72 |         <?php if ($hasLast) : ?>
73 |             <a href="<?= $pager->getLastPageUrl() ?>" class="relative inline-flex items-center px-2 py-2 rounded-r-md border border-gray-300 bg-white text-sm font-medium text-gray-500 hover:bg-gray-50">
74 |                 <?= $language->render('pagination', 'last') ?>
75 |             </a>
76 |         <?php endif ?>
77 |     </nav>
78 | </div>
79 | 
80 | 


--------------------------------------------------------------------------------
/src/Pager.php:
--------------------------------------------------------------------------------
  1 | <?php declare(strict_types=1);
  2 | /*
  3 |  * This file is part of Aplus Framework Pagination Library.
  4 |  *
  5 |  * (c) Natan Felles <natanfelles@gmail.com>
  6 |  *
  7 |  * For the full copyright and license information, please view the LICENSE
  8 |  * file that was distributed with this source code.
  9 |  */
 10 | namespace Framework\Pagination;
 11 | 
 12 | use Framework\Helpers\Isolation;
 13 | use Framework\HTTP\URL;
 14 | use Framework\Language\Language;
 15 | use InvalidArgumentException;
 16 | use JetBrains\PhpStorm\ArrayShape;
 17 | use JetBrains\PhpStorm\Pure;
 18 | use JsonSerializable;
 19 | use LogicException;
 20 | use Stringable;
 21 | 
 22 | /**
 23 |  * Class Pager.
 24 |  *
 25 |  * @package pagination
 26 |  */
 27 | class Pager implements JsonSerializable, Stringable
 28 | {
 29 |     protected int $currentPage;
 30 |     protected ?int $previousPage = null;
 31 |     protected ?int $nextPage = null;
 32 |     protected int $lastPage;
 33 |     protected int $itemsPerPage;
 34 |     protected int $totalItems;
 35 |     protected int $surround = 2;
 36 |     /**
 37 |      * @var array<string,string>
 38 |      */
 39 |     protected array $views = [
 40 |         // HTML Head
 41 |         'head' => __DIR__ . '/Views/head.php',
 42 |         // HTTP Header
 43 |         'header' => __DIR__ . '/Views/header.php',
 44 |         // HTML Previous and Next
 45 |         'pager' => __DIR__ . '/Views/pagination-short.php',
 46 |         // HTML Full
 47 |         'pagination' => __DIR__ . '/Views/pagination.php',
 48 |         'pagination-short' => __DIR__ . '/Views/pagination-short.php',
 49 |         // Bootstrap 5
 50 |         'bootstrap' => __DIR__ . '/Views/bootstrap.php',
 51 |         'bootstrap-short' => __DIR__ . '/Views/bootstrap-short.php',
 52 |         'bootstrap5' => __DIR__ . '/Views/bootstrap.php',
 53 |         'bootstrap5-short' => __DIR__ . '/Views/bootstrap-short.php',
 54 |         // Bulma 1
 55 |         'bulma' => __DIR__ . '/Views/bulma.php',
 56 |         'bulma-short' => __DIR__ . '/Views/bulma-short.php',
 57 |         'bulma1' => __DIR__ . '/Views/bulma.php',
 58 |         'bulma1-short' => __DIR__ . '/Views/bulma-short.php',
 59 |         // Foundation 6
 60 |         'foundation' => __DIR__ . '/Views/foundation.php',
 61 |         'foundation-short' => __DIR__ . '/Views/foundation-short.php',
 62 |         'foundation6' => __DIR__ . '/Views/foundation.php',
 63 |         'foundation6-short' => __DIR__ . '/Views/foundation-short.php',
 64 |         // Materialize 1
 65 |         'materialize' => __DIR__ . '/Views/materialize.php',
 66 |         'materialize-short' => __DIR__ . '/Views/materialize-short.php',
 67 |         'materialize1' => __DIR__ . '/Views/materialize.php',
 68 |         'materialize1-short' => __DIR__ . '/Views/materialize-short.php',
 69 |         // Primer 20
 70 |         'primer' => __DIR__ . '/Views/primer.php',
 71 |         'primer-short' => __DIR__ . '/Views/primer-short.php',
 72 |         'primer20' => __DIR__ . '/Views/primer.php',
 73 |         'primer20-short' => __DIR__ . '/Views/primer-short.php',
 74 |         // Semantic UI 2
 75 |         'semantic-ui' => __DIR__ . '/Views/semantic-ui.php',
 76 |         'semantic-ui-short' => __DIR__ . '/Views/semantic-ui-short.php',
 77 |         'semantic-ui2' => __DIR__ . '/Views/semantic-ui.php',
 78 |         'semantic-ui2-short' => __DIR__ . '/Views/semantic-ui-short.php',
 79 |         // Tailwind CSS 3
 80 |         'tailwind' => __DIR__ . '/Views/tailwind.php',
 81 |         'tailwind-short' => __DIR__ . '/Views/tailwind-short.php',
 82 |         'tailwind3' => __DIR__ . '/Views/tailwind.php',
 83 |         'tailwind3-short' => __DIR__ . '/Views/tailwind-short.php',
 84 |         // W3.CSS 4
 85 |         'w3' => __DIR__ . '/Views/w3.php',
 86 |         'w3-short' => __DIR__ . '/Views/w3-short.php',
 87 |         'w34' => __DIR__ . '/Views/w3.php',
 88 |         'w34-short' => __DIR__ . '/Views/w3-short.php',
 89 |     ];
 90 |     protected string $defaultView = 'pagination';
 91 |     protected URL $url;
 92 |     protected string $oldUrl;
 93 |     protected string $query = 'page';
 94 |     protected Language $language;
 95 | 
 96 |     /**
 97 |      * Pager constructor.
 98 |      *
 99 |      * @param int|string $currentPage
100 |      * @param int|string $itemsPerPage
101 |      * @param int $totalItems
102 |      * @param Language|null $language Language instance
103 |      * @param string|null $url
104 |      */
105 |     public function __construct(
106 |         int | string $currentPage,
107 |         int | string $itemsPerPage,
108 |         int $totalItems,
109 |         ?Language $language = null,
110 |         ?string $url = null
111 |     ) {
112 |         if ($language) {
113 |             $this->setLanguage($language);
114 |         }
115 |         $this->setCurrentPage(static::sanitize($currentPage))
116 |             ->setItemsPerPage(static::sanitize($itemsPerPage))
117 |             ->setTotalItems($totalItems);
118 |         $lastPage = (int) \ceil($this->getTotalItems() / $this->getItemsPerPage());
119 |         $this->setLastPage(static::sanitize($lastPage));
120 |         if ($this->getCurrentPage() > 1) {
121 |             if ($this->getCurrentPage() - 1 <= $this->getLastPage()) {
122 |                 $this->setPreviousPage($this->getCurrentPage() - 1);
123 |             } elseif ($this->getLastPage() > 1) {
124 |                 $this->setPreviousPage($this->getLastPage());
125 |             }
126 |         }
127 |         if ($this->getCurrentPage() < $this->getLastPage()) {
128 |             $this->setNextPage($this->getCurrentPage() + 1);
129 |         }
130 |         isset($url) ? $this->setUrl($url) : $this->prepareUrl();
131 |     }
132 | 
133 |     public function __toString() : string
134 |     {
135 |         return $this->render();
136 |     }
137 | 
138 |     /**
139 |      * @since 3.5
140 |      *
141 |      * @return int
142 |      */
143 |     public function getItemsPerPage() : int
144 |     {
145 |         return $this->itemsPerPage;
146 |     }
147 | 
148 |     /**
149 |      * @since 3.5
150 |      *
151 |      * @param int $itemsPerPage
152 |      *
153 |      * @return static
154 |      */
155 |     protected function setItemsPerPage(int $itemsPerPage) : static
156 |     {
157 |         $this->itemsPerPage = $itemsPerPage;
158 |         return $this;
159 |     }
160 | 
161 |     /**
162 |      * @since 3.5
163 |      *
164 |      * @return int
165 |      */
166 |     public function getTotalItems() : int
167 |     {
168 |         return $this->totalItems;
169 |     }
170 | 
171 |     /**
172 |      * @since 3.5
173 |      *
174 |      * @param int $totalItems
175 |      *
176 |      * @return static
177 |      */
178 |     protected function setTotalItems(int $totalItems) : static
179 |     {
180 |         $this->totalItems = $totalItems;
181 |         return $this;
182 |     }
183 | 
184 |     /**
185 |      * @param Language|null $language
186 |      *
187 |      * @return static
188 |      */
189 |     public function setLanguage(?Language $language = null) : static
190 |     {
191 |         $this->language = $language ?? new Language();
192 |         $this->language->addDirectory(__DIR__ . '/Languages');
193 |         return $this;
194 |     }
195 | 
196 |     /**
197 |      * @return Language
198 |      */
199 |     public function getLanguage() : Language
200 |     {
201 |         if (!isset($this->language)) {
202 |             $this->setLanguage();
203 |         }
204 |         return $this->language;
205 |     }
206 | 
207 |     /**
208 |      * @param string $name
209 |      * @param string $filepath
210 |      *
211 |      * @return static
212 |      */
213 |     public function setView(string $name, string $filepath) : static
214 |     {
215 |         if (!\is_file($filepath)) {
216 |             throw new InvalidArgumentException('Invalid Pager view filepath: ' . $filepath);
217 |         }
218 |         $this->views[$name] = $filepath;
219 |         return $this;
220 |     }
221 | 
222 |     /**
223 |      * Get a view filepath.
224 |      *
225 |      * @param string $name The view name. Default names are: head, header, pager and pagination
226 |      *
227 |      * @return string
228 |      */
229 |     public function getView(string $name) : string
230 |     {
231 |         if (empty($this->views[$name])) {
232 |             throw new InvalidArgumentException('Pager view not found: ' . $name);
233 |         }
234 |         return $this->views[$name];
235 |     }
236 | 
237 |     /**
238 |      * @return array<string,string>
239 |      */
240 |     #[Pure]
241 |     public function getViews() : array
242 |     {
243 |         return $this->views;
244 |     }
245 | 
246 |     /**
247 |      * @return int
248 |      */
249 |     #[Pure]
250 |     public function getSurround() : int
251 |     {
252 |         return $this->surround;
253 |     }
254 | 
255 |     /**
256 |      * @param int $surround
257 |      *
258 |      * @return static
259 |      */
260 |     public function setSurround(int $surround) : static
261 |     {
262 |         $this->surround = \max($surround, 0);
263 |         return $this;
264 |     }
265 | 
266 |     /**
267 |      * @param string $query
268 |      *
269 |      * @return static
270 |      */
271 |     public function setQuery(string $query = 'page') : static
272 |     {
273 |         $this->query = $query;
274 |         return $this;
275 |     }
276 | 
277 |     #[Pure]
278 |     public function getQuery() : string
279 |     {
280 |         return $this->query;
281 |     }
282 | 
283 |     /**
284 |      * @param array<string>|null $allowed List of queries, an empty array
285 |      *  to allow only the default or null to allow all
286 |      *
287 |      * @return static
288 |      */
289 |     public function setAllowedQueries(?array $allowed) : static
290 |     {
291 |         $this->setUrl($this->oldUrl, $allowed);
292 |         return $this;
293 |     }
294 | 
295 |     protected function prepareUrl() : static
296 |     {
297 |         $scheme = ((isset($_SERVER['REQUEST_SCHEME']) && $_SERVER['REQUEST_SCHEME'] === 'https')
298 |             || (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on'))
299 |             ? 'https'
300 |             : 'http';
301 |         $this->setUrl($scheme . '://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI']);
302 |         return $this;
303 |     }
304 | 
305 |     /**
306 |      * @param URL|string $currentPageUrl
307 |      * @param array<string>|null $allowedQueries List of queries, an empty array
308 |      * to allow only the default or null to allow all
309 |      *
310 |      * @return static
311 |      */
312 |     public function setUrl(URL | string $currentPageUrl, ?array $allowedQueries = null) : static
313 |     {
314 |         $currentPageUrl = $currentPageUrl instanceof URL
315 |             ? clone $currentPageUrl
316 |             : new URL($currentPageUrl);
317 |         $this->oldUrl = $currentPageUrl->toString();
318 |         if ($allowedQueries !== null) {
319 |             $allowedQueries[] = $this->getQuery();
320 |         }
321 |         $currentPageUrl->setQuery(
322 |             $currentPageUrl->getQuery() ?? '',
323 |             $allowedQueries ?? []
324 |         );
325 |         $this->url = $currentPageUrl;
326 |         return $this;
327 |     }
328 | 
329 |     public function getUrl() : URL
330 |     {
331 |         return $this->url;
332 |     }
333 | 
334 |     public function getPageUrl(?int $page) : ?string
335 |     {
336 |         if ($page === null || $page === 0) {
337 |             return null;
338 |         }
339 |         return $this->url->addQuery($this->getQuery(), $page)->toString();
340 |     }
341 | 
342 |     public function getCurrentPage() : int
343 |     {
344 |         return $this->currentPage;
345 |     }
346 | 
347 |     /**
348 |      * @since 3.5
349 |      *
350 |      * @param int $currentPage
351 |      *
352 |      * @return static
353 |      */
354 |     protected function setCurrentPage(int $currentPage) : static
355 |     {
356 |         $this->currentPage = $currentPage;
357 |         return $this;
358 |     }
359 | 
360 |     public function getCurrentPageUrl() : string
361 |     {
362 |         return $this->getPageUrl($this->currentPage);
363 |     }
364 | 
365 |     #[Pure]
366 |     public function getFirstPage() : int
367 |     {
368 |         return 1;
369 |     }
370 | 
371 |     public function getFirstPageUrl() : string
372 |     {
373 |         return $this->getPageUrl($this->getFirstPage());
374 |     }
375 | 
376 |     #[Pure]
377 |     public function getLastPage() : int
378 |     {
379 |         return $this->lastPage;
380 |     }
381 | 
382 |     /**
383 |      * @since 3.5
384 |      *
385 |      * @param int $lastPage
386 |      *
387 |      * @return static
388 |      */
389 |     protected function setLastPage(int $lastPage) : static
390 |     {
391 |         $this->lastPage = $lastPage;
392 |         return $this;
393 |     }
394 | 
395 |     public function getLastPageUrl() : string
396 |     {
397 |         return $this->getPageUrl($this->getLastPage());
398 |     }
399 | 
400 |     #[Pure]
401 |     public function getPreviousPage() : ?int
402 |     {
403 |         return $this->previousPage;
404 |     }
405 | 
406 |     /**
407 |      * @since 3.5
408 |      *
409 |      * @param int $previousPage
410 |      *
411 |      * @return static
412 |      */
413 |     protected function setPreviousPage(int $previousPage) : static
414 |     {
415 |         $this->previousPage = $previousPage;
416 |         return $this;
417 |     }
418 | 
419 |     public function getPreviousPageUrl() : ?string
420 |     {
421 |         return $this->getPageUrl($this->getPreviousPage());
422 |     }
423 | 
424 |     #[Pure]
425 |     public function getNextPage() : ?int
426 |     {
427 |         return $this->nextPage;
428 |     }
429 | 
430 |     /**
431 |      * @since 3.5
432 |      *
433 |      * @param int $nextPage
434 |      *
435 |      * @return static
436 |      */
437 |     protected function setNextPage(int $nextPage) : static
438 |     {
439 |         $this->nextPage = $nextPage;
440 |         return $this;
441 |     }
442 | 
443 |     public function getNextPageUrl() : ?string
444 |     {
445 |         return $this->getPageUrl($this->getNextPage());
446 |     }
447 | 
448 |     /**
449 |      * @return array<int,string>
450 |      */
451 |     public function getPreviousPagesUrls() : array
452 |     {
453 |         $urls = [];
454 |         if ($this->currentPage > 1 && $this->currentPage <= $this->lastPage) {
455 |             $range = \range($this->currentPage - $this->surround, $this->currentPage - 1);
456 |             foreach ($range as $page) {
457 |                 if ($page < 1) {
458 |                     continue;
459 |                 }
460 |                 $urls[$page] = $this->getPageUrl($page);
461 |             }
462 |         }
463 |         return $urls;
464 |     }
465 | 
466 |     /**
467 |      * @return array<int,string>
468 |      */
469 |     public function getNextPagesUrls() : array
470 |     {
471 |         $urls = [];
472 |         if ($this->currentPage < $this->lastPage) {
473 |             $range = \range($this->currentPage + 1, $this->currentPage + $this->surround);
474 |             foreach ($range as $page) {
475 |                 if ($page > $this->lastPage) {
476 |                     break;
477 |                 }
478 |                 $urls[$page] = $this->getPageUrl($page);
479 |             }
480 |         }
481 |         return $urls;
482 |     }
483 | 
484 |     /**
485 |      * @return array<string,int|null>
486 |      */
487 |     #[ArrayShape([
488 |         'self' => 'int',
489 |         'first' => 'int',
490 |         'prev' => 'int|null',
491 |         'next' => 'int|null',
492 |         'last' => 'int',
493 |     ])]
494 |     #[Pure]
495 |     public function get() : array
496 |     {
497 |         return [
498 |             'self' => $this->getCurrentPage(),
499 |             'first' => $this->getFirstPage(),
500 |             'prev' => $this->getPreviousPage(),
501 |             'next' => $this->getNextPage(),
502 |             'last' => $this->getLastPage(),
503 |         ];
504 |     }
505 | 
506 |     /**
507 |      * @return array<string,string|null>
508 |      */
509 |     #[ArrayShape([
510 |         'self' => 'string',
511 |         'first' => 'string',
512 |         'prev' => 'string|null',
513 |         'next' => 'string|null',
514 |         'last' => 'string',
515 |     ])]
516 |     public function getWithUrl() : array
517 |     {
518 |         return [
519 |             'self' => $this->getCurrentPageUrl(),
520 |             'first' => $this->getFirstPageUrl(),
521 |             'prev' => $this->getPreviousPageUrl(),
522 |             'next' => $this->getNextPageUrl(),
523 |             'last' => $this->getLastPageUrl(),
524 |         ];
525 |     }
526 | 
527 |     /**
528 |      * @param string|null $view
529 |      *
530 |      * @return string
531 |      */
532 |     public function render(?string $view = null) : string
533 |     {
534 |         $filename = $this->getView($view ?? $this->getDefaultView());
535 |         \ob_start();
536 |         Isolation::require($filename, ['pager' => $this]);
537 |         return (string) \ob_get_clean();
538 |     }
539 | 
540 |     public function renderShort() : string
541 |     {
542 |         $view = $this->getDefaultView();
543 |         if (!\str_ends_with($view, '-short')) {
544 |             $view .= '-short';
545 |         }
546 |         return $this->render($view);
547 |     }
548 | 
549 |     public function setDefaultView(string $defaultView) : static
550 |     {
551 |         if (!\array_key_exists($defaultView, $this->views)) {
552 |             throw new LogicException(
553 |                 'Default view "' . $defaultView . '" is not a valid value'
554 |             );
555 |         }
556 |         $this->defaultView = $defaultView;
557 |         return $this;
558 |     }
559 | 
560 |     #[Pure]
561 |     public function getDefaultView() : string
562 |     {
563 |         return $this->defaultView;
564 |     }
565 | 
566 |     /**
567 |      * @return array<string,string|null>
568 |      */
569 |     #[ArrayShape([
570 |         'self' => 'string',
571 |         'first' => 'string',
572 |         'prev' => 'string|null',
573 |         'next' => 'string|null',
574 |         'last' => 'string',
575 |     ])]
576 |     public function jsonSerialize() : array
577 |     {
578 |         return $this->getWithUrl();
579 |     }
580 | 
581 |     /**
582 |      * Sanitize a number.
583 |      *
584 |      * @param mixed $number
585 |      *
586 |      * @return int
587 |      */
588 |     #[Pure]
589 |     public static function sanitize(mixed $number) : int
590 |     {
591 |         if (!\is_numeric($number)) {
592 |             return 1;
593 |         }
594 |         if ($number < 1) {
595 |             return 1;
596 |         }
597 |         return $number >= \PHP_INT_MAX ? \PHP_INT_MAX : (int) $number;
598 |     }
599 | }
600 | 


--------------------------------------------------------------------------------