Download the PHP package white-october/pagerfanta-bundle without Composer
On this page you can find all versions of the php package white-october/pagerfanta-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download white-october/pagerfanta-bundle
More information about white-october/pagerfanta-bundle
Files in white-october/pagerfanta-bundle
Package pagerfanta-bundle
Short Description Bundle to use Pagerfanta with Symfony2
License MIT
Informations about the package pagerfanta-bundle
This project is no longer maintained. If you are using it with Symfony 3.4, 4.4 or 5, you may want to use this fork instead.
WhiteOctoberPagerfantaBundle
Bundle to use Pagerfanta with Symfony.
Note: If you are using a 2.0.x release of Symfony2, please use the symfony2.0
branch of this bundle. The master branch of this bundle tracks the Symfony master branch.
The bundle includes:
- Twig function to render pagerfantas with views and options.
- Way to use easily views.
- Way to reuse options in views.
- Basic CSS for the DefaultView.
Installation
1) Use Composer to download the library
2) Then add the WhiteOctoberPagerfantaBundle to your application:
In Symfony < 4:
In Symfony 4 with Symfony Flex this will be done automatically for you.
3) Configure and use things!
A) Creating a Pager is shown on the Pagerfanta documentation. If you're using the Doctrine ORM, you'll want to use the DoctrineORMAdapter
B) Rendering in Twig is shown below in the Rendering Pagerfantas section.
C) Configuration is shown through this document
Rendering Pagerfantas
First, you'll need to pass an instance of Pagerfanta as a parameter into your template. For example:
You then call the the Pagerfanta Twig extension, passing in the Pagerfanta instance. The routes are generated automatically for the current route using the variable "page" to propagate the page number. By default, the bundle uses the DefaultView with the default name. The default syntax is:
By default, the "page" variable is also added for the link to the first page. To
disable the generation of ?page=1
in the url, simply set the omitFirstPage
option
to true
when calling the pagerfanta
twig function:
You can omit template parameter to make function call shorter, default template will be used:
If you have multiple pagers on one page, you'll need to change the name of the page
parameter.
Here's an example:
Note the square brackets around page_other
; this won't work without them.
Twitter Bootstrap
The bundle also has a Twitter Bootstrap view.
For Bootstrap 2:
For Bootstrap 3:
For Bootstrap 4:
Custom template
If you want to use a custom template, add another argument:
With options:
See the Pagerfanta documentation for the list of possible parameters.
Rendering the page of items itself
The items can be retrieved using currentPageResults
. For example:
Translate in your language
The bundle also offers two views to translate the default and the twitter bootstrap views.
Adding Views
The views are added to the container with the pagerfanta.view tag:
XML
YAML
Reusing Options
Sometimes you want to reuse options of a view in your project, and you don't want to write them all the times you render a view, or you can have different configurations for a view and you want to save them in a place to be able to change them easily.
For this you have to define views with the special view OptionableView:
And using then:
The easiest way to render pagerfantas (or paginators!) ;)
Basic CSS for the default view
The bundles comes with basic CSS for the default view so you can get started with a good paginator faster. Of course you can change it, use another one or create your own view.
Configuration
It's possible to configure the default view for all rendering in your configuration file:
Making bad page numbers return a HTTP 500
Right now when the page is out of range or not a number,
the server returns a 404 response by default.
You can set the following parameters to different than default value
to_http_not_found
(ie. null) to show a 500 exception when the
requested page is not valid instead.
More information
For more advanced documentation, check the Pagerfanta documentation.
Contributing
We welcome contributions to this project, including pull requests and issues (and discussions on existing issues).
If you'd like to contribute code but aren't sure what, the issues list is a good place to start. If you're a first-time code contributor, you may find Github's guide to forking projects helpful.
All contributors (whether contributing code, involved in issue discussions, or involved in any other way) must abide by our code of conduct.
Acknowledgements
Pablo Díez ([email protected]) for most of the work on the first versions of this bundle.
This project was originally located at https://github.com/whiteoctober/WhiteOctoberPagerfantaBundle.
License
Pagerfanta is licensed under the MIT License. See the LICENSE file for full details.
All versions of pagerfanta-bundle with dependencies
pagerfanta/pagerfanta Version ^1.1.0|^2.0.0
symfony/framework-bundle Version ~2.3|~3.0|~4.0
symfony/property-access Version ~2.3|~3.0|~4.0
symfony/translation Version ~2.3|~3.0|~4.0
symfony/twig-bundle Version ~2.3|~3.0|~4.0