# WhiteOctoberPagerfantaBundle
[](https://travis-ci.org/whiteoctober/WhiteOctoberPagerfantaBundle) [](https://scrutinizer-ci.com/g/whiteoctober/WhiteOctoberPagerfantaBundle/) [](https://insight.sensiolabs.com/projects/e0838383-1c8d-406f-9874-a76c08b7d217)
Bundle to use [Pagerfanta](https://github.com/whiteoctober/Pagerfanta) with [Symfony2](https://github.com/symfony/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 Symfony2 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
------------
Add the bundle to your `composer.json`:
"white-october/pagerfanta-bundle": "dev-master"
and run:
php composer.phar install
Then add the WhiteOctoberPagerfantaBundle to your application kernel:
// app/AppKernel.php
public function registerBundles()
{
return array(
// ...
new WhiteOctober\PagerfantaBundle\WhiteOctoberPagerfantaBundle(),
// ...
);
}
Right now when the page is out of range or not a number the server returns 500. You can set the parameter to show 404 exception when requested page is not valid.
It is set to "false" by defauly to provide BC (before it was 500).
// app/config/config.yml
white_october_pagerfanta:
exceptions_strategy:
out_of_range_page: to_http_not_found
not_valid_current_page: to_http_not_found
Rendering pagerfantas
---------------------
{{ pagerfanta(my_pager, view_name, view_options) }}
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:
{{ pagerfanta(my_pager) }}
The bundle also has the *TwitterBootstrapView* with the *twitter_bootstrap* name.
If you want to use a custom template, add another argument
{{ pagerfanta(my_pager, 'my_template') }}
With Options
{{ pagerfanta(my_pager, 'default', { 'proximity': 2}) }}
See the Pagerfanta documentation for the list of the parameters.
Translate in your language
--------------------------
The bundle also offers two views to translate the *default* and the
*twitter bootstrap* views.
{{ pagerfanta(pagerfanta, 'default_translated') }}
{{ pagerfanta(pagerfanta, 'twitter_bootstrap_translated') }}
Adding Views
------------
The views are added to the container with the *pagerfanta.view* tag:
XML
YAML
services:
pagerfanta.view.default:
class: Pagerfanta\View\DefaultView
public: false
tags: [{ name: pagerfanta.view, alias: default }]
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*:
services:
pagerfanta.view.my_view_1:
class: Pagerfanta\View\OptionableView
arguments:
- @pagerfanta.view.default
- { proximity: 2, previous_message: Anterior, next_message: Siguiente }
public: false
tags: [{ name: pagerfanta.view, alias: my_view_1 }]
pagerfanta.view.my_view_2:
class: Pagerfanta\View\OptionableView
arguments:
- @pagerfanta.view.default
- { proximity: 5 }
public: false
tags: [{ name: pagerfanta.view, alias: my_view_2 }]
And using then:
{{ pagerfanta(pagerfanta, 'my_view_1') }}
{{ pagerfanta(pagerfanta, 'my_view_2') }}
The easiest way to render pagerfantas (or paginators!) ;)
Configuration
-------------
It's possible to configure the default view for all rendering in your
configuration file:
white_october_pagerfanta:
default_view: my_view_1
Basic CSS for the default view
------------------------------
The bundles comes with a basic css for the default view to be able to use a
good paginator faster. Of course you can change it, use another one or
create your own view.
More information
----------------
For more advanced documentation, check the [Pagerfanta documentation](https://github.com/whiteoctober/Pagerfanta/blob/master/README.md).
Author
------
Pablo Díez -
License
-------
Pagerfanta is licensed under the MIT License. See the LICENSE file for full
details.
Sponsors
--------
[WhiteOctober](http://www.whiteoctober.co.uk/)
Copyright (c) 2011 Pablo Díez
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is furnished
to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.