Doctrine_manual-1-2-en

Chapter 26: Utilities 346
Listing
26-15
Listing
26-16
Listing
26-17
As you may see, there is no need to use other masks except the internals ones. Lets suppose
we implement a new functionality to search for Users in our existent application, and we need
to support this feature in pager layout too. To simplify our case, the search parameter is
named "search" and is received through $_GET superglobal array. The first change we need
to do is tho adjust the Doctrine_Query object and also the URL, to allow it to be sent to
other pages.
Creating the pager layout:
$pagerLayout = new Doctrine_Pager_Layout(
new Doctrine_Pager(
Doctrine_Query::create()
->from( 'User u' )
->leftJoin( 'u.Group g' )
->where('LOWER(u.username) LIKE LOWER(?)', array(
'%'.$_GET['search'].'%' ) )
->orderby( 'u.username ASC' ),
$currentPage,
$resultsPerPage
),
new Doctrine_Pager_Range_Sliding(array(
'chunk' => 5
)),
'http://wwww.domain.com/app/User/list/
page,{%page_number}?search={%search}'
);
Check out the code and notice we added a new mask, called {%search}. We'll need to send it
to the template processing at a later stage. We then assign the templates, just as defined
before, without any change. And also, we do not need to change execution of query.
Assigning templates for page links creation:
$pagerLayout->setTemplate('[{%page}]');
$pagerLayout->setSelectedTemplate('[{%page}]');
// Fetching users
$users = $pagerLayout->execute();
foreach ($users as $user) {
// ...
}
The method display() is the place where we define the custom mask we created. This
method accepts 2 optional arguments: one array of optional masks and if the output should be
returned instead of printed on screen. In our case, we need to define a new mask, the
{%search}, which is the search offset of $_GET superglobal array. Also, remember that since
it'll be sent as URL, it needs to be encoded. Custom masks are defined in key => value pairs.
So all needed code is to define an array with the offset we desire and the value to be
replaced:
// Displaying page links
$pagerLayout->display( array(
'search' => urlencode($_GET['search'])
) );
----------------- Brought to you by