function theme_pager
Search API
7.x theme.inc | theme_pager($tags = array(), $limit = 10, $element = 0, $parameters = array(), $quantity = 9) |
6.x theme.inc | theme_pager($tags = array(), $limit = 10, $element = 0, $parameters = array(), $quantity = 9) |
Adapted from https://api.drupal.org/api/drupal/includes%21pager.inc/function/theme_pa...
The purpose of this is to return the HTML to display a "pager", as created from the pager_query() function.
$tags: An array of labels for the controls in the pager. $limit: The number of query results to display per page. $element: An optional integer to distinguish between multiple pagers on one page. $parameters: An associative array of query string parameters to append to the pager links. $quantity: The number of pages in the list.
9 calls to theme_pager()
- admin_display_watchdog in modules/
admin/ admin.module - alerts_advisees_alerts_form in modules/
alerts/ alerts.module - Displays alerts for our various advisees.
- alerts_display_advisee_activities_page in modules/
alerts/ alerts.module - Display all advisee activities since the beginning of time, thanks to pager query.
- content_display_content_admin_list in modules/
content/ content.module - Display a list of content for the administrator
- content_public_files_form in modules/
content/ content.module - This screen lets the user upload/manage/delete "public files" stored at custom/files/content_uploads/public_uploads/
File
- includes/
theme.inc, line 177
Code
function theme_pager($tags = array(), $limit = 10, $element = 0, $parameters = array(), $quantity = 9) {
global $pager_page_array, $pager_total;
// Calculate various markers within this pager piece:
// Middle is used to "center" pages around the current page.
$pager_middle = ceil($quantity / 2);
if (!isset($pager_page_array)) {
$pager_page_array = array();
}
if (!isset($pager_page_array [$element])) {
$pager_page_array [$element] = 0;
}
if (!isset($pager_total)) {
$pager_total = array();
}
if (!isset($pager_total [$element])) {
$pager_total [$element] = 0;
}
// current is the page we are currently paged to
$pager_current = $pager_page_array [$element] + 1;
// first is the first page listed by this pager piece (re quantity)
$pager_first = $pager_current - $pager_middle + 1;
// last is the last page listed by this pager piece (re quantity)
$pager_last = $pager_current + $quantity - $pager_middle;
// max is the maximum page number
$pager_max = $pager_total [$element];
// End of marker calculations.
// Prepare for generation loop.
$i = $pager_first;
if ($pager_last > $pager_max) {
// Adjust "center" if at end of query.
$i = $i + ($pager_max - $pager_last);
$pager_last = $pager_max;
}
if ($i <= 0) {
// Adjust "center" if at start of query.
$pager_last = $pager_last + (1 - $i);
$i = 1;
}
// End of generation loop preparation.
$li_first = theme_pager_first(isset($tags [0]) ? $tags [0] : t('« first'), $limit, $element, $parameters);
$li_previous = theme_pager_previous(isset($tags [1]) ? $tags [1] : t('‹ previous'), $limit, $element, 1, $parameters);
$li_next = theme_pager_next(isset($tags [3]) ? $tags [3] : t('next ›'), $limit, $element, 1, $parameters);
$li_last = theme_pager_last(isset($tags [4]) ? $tags [4] : t('last »'), $limit, $element, $parameters);
if ($pager_total [$element] > 1) {
if ($li_first) {
$items [] = array(
'class' => 'pager-first',
'data' => $li_first,
);
}
if ($li_previous) {
$items [] = array(
'class' => 'pager-previous',
'data' => $li_previous,
);
}
// When there is more than one page, create the pager list.
if ($i != $pager_max) {
if ($i > 1) {
$items [] = array(
'class' => 'pager-ellipsis',
'data' => '…',
);
}
// Now generate the actual pager piece.
for (; $i <= $pager_last && $i <= $pager_max; $i++) {
if ($i < $pager_current) {
$items [] = array(
'class' => 'pager-item',
'data' => theme_pager_previous($i, $limit, $element, $pager_current - $i, $parameters),
);
}
if ($i == $pager_current) {
$items [] = array(
'class' => 'pager-current',
'data' => $i,
);
}
if ($i > $pager_current) {
$items [] = array(
'class' => 'pager-item',
'data' => theme_pager_next($i, $limit, $element, $i - $pager_current, $parameters),
);
}
}
if ($i < $pager_max) {
$items [] = array(
'class' => 'pager-ellipsis',
'data' => '…',
);
}
}
// End generation.
if ($li_next) {
$items [] = array(
'class' => 'pager-next',
'data' => $li_next,
);
}
if ($li_last) {
$items [] = array(
'class' => 'pager-last',
'data' => $li_last,
);
}
//return theme('item_list', $items, NULL, 'ul', array(
// 'class' => 'pager',
//));
$rtn = "";
$rtn = "<ul class='pager'>";
foreach ($items as $details) {
$class = @$details ['class'];
$data = @$details ['data'];
$rtn .= "<li class='$class'>$data</li>";
}
$rtn .= "</ul>";
return "<div class='pager-wrapper pager-wrapper-$element'>$rtn</div>";
}
}