blade-pagination

BladePagination es un paquete que te permite crear y usar templates de Blade para personalizar el HTML de paginación de Laravel, que como sabemos viene por defecto con el estilo de Twitter Boostrap 3, pero con este plugin podrás usar el template que utiliza MaterializeCss, Foundation o inclusive crear tu propio «tema» para la paginación. Su instalación es muy fácil y en pocos minutos puedes ponerlo a funcionar sin ningún problema.

Para instalar vía composer puedes agregar la siguiente linea a la sección «require» de tu archivo composer.json

"styde/blade-pagination": "5.1.*@dev"

Posteriormente debes ejcutar desde la consola

$ php composer update

Una vez instalado agregamos a la lista de Service Providers dentro de config/app.php

'Styde\BladePagination\ServiceProvider'

Si usas Laravel 5.1 puedes usar lo siguiente:

Styde\BladePagination\ServiceProvider::class

Por último, nuevamente desde la consola, ejecutamos el comando

php artisan vendor:publish

Perfecto, esto es todo. Veamos un poco de código

Si ingresamos al nuevo archivo que fue generado: app/config/blade-pagination.php podremos ver algo como esto:

return array(
    'theme' => 'bootstrap'
);

Aquí es donde vamos a definir el tema o la «vista» con la cual vamos a trabajar, puedes usar una de las que se incluye por defecto como «bootstrap», «materialize» o «foundation», pero si lo deseas también puedes nombrar y crear tu propio template.

Los templates los encontrarás dentro de la carpeta resources/views/blade-pagination,  (una vez que hayas ejecutado php artisan vendor:publish)

Probando el componente

Prueba de paginación con el framework y tema materialize

Prueba de paginación con el framework y tema materialize

El paquete BladePagination incluye otro repositorio de pruebas que puedes clonar o descargar para probar el componente.

Puedes ver el repositorio aquí: https://github.com/StydeNet/blade-pagination-tests

El repositorio es un proyecto de Laravel 5.1 y su instalación es bastante estándar:

  1. Clona o descarga el repositorio
  2. Ejecuta composer install  en la carpeta del proyecto
  3. Crea un archivo vacío llamado database.sqlite  en la carpeta storage/
  4. Crea un archivo vacío llamado database.tests.sqlite  en la carpeta storage/
  5. Ejecuta php artisan migrate –seed  dentro de la carpeta del proyecto
  6. Configura un virtual host para el proyecto (por ejemplo laravel.pagination). Recuerda que los virtual hosts deben apuntar a la carpeta public/
  7. Carga http://laravel.pagination/users/bootstrap en el navegador
  8. Deberías ver el ejemplo por defecto funcionando con el tema de Bootstrap
  9. Carga http://laravel.pagination/users/foundation
  10. Deberías ver el ejemplo con el tema de Foundation
  11. Lo mismo para materialize: http://laravel.pagination/users/materialize
  12. Te recomiendo que veas el archivo app/Http/routes.php  para que puedas ver el código que hace funcionar estos ejemplos
  13. También puedes ejecutar phpunit  en la consola y ver el código de la prueba unitaria en tests/PaginationTest.php

Este paquete ha sido desarrollado por Duilio Palacios y puedes encontrarlo disponible en GitHub como Blade-pagination.

Publicaciones recomendadas 

Regístrate hoy en Styde y obtén acceso a todo nuestro contenido.

Lección anterior Generar PDFs en Laravel 5.1 con DomPdf Lección siguiente Instalación del paquete Styde\Html