function theme_pager in Drupal 4

Same name and namespace in other branches

1. 5 includes/pager.inc \theme_pager()
2. 6 includes/pager.inc \theme_pager()
3. 7 includes/pager.inc \theme_pager()

Format a query pager.

Menu callbacks that display paged query results should call theme('pager') to retrieve a pager control so that users can view other results.

Parameters

$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.

Return value

An HTML string that generates the query pager.

Related topics

25 theme calls to theme_pager()

archive_page in modules/archive.module

Menu callback; lists all nodes posted on a given date.

blog_page_last in modules/blog.module

Displays a Drupal page containing recent blog entries of all users.

blog_page_user in modules/blog.module

Displays a Drupal page containing recent blog entries of a given user.

comment_admin_overview in modules/comment.module

Menu callback; present an administrative comment listing.

comment_render in modules/comment.module

... See full list

File

includes/pager.inc, line 119

Functions to aid in presenting database results as a set of pages.

Code

function theme_pager($tags = array(), $limit = 10, $element = 0, $parameters = array()) {
  global $pager_total;
  $output = '';
  if ($pager_total[$element] > 1) {
    $output .= '<div id="pager">';
    $output .= theme('pager_first', $tags[0] ? $tags[0] : t('« first'), $limit, $element, $parameters);
    $output .= theme('pager_previous', $tags[1] ? $tags[1] : t('‹ previous'), $limit, $element, 1, $parameters);
    $output .= theme('pager_list', $limit, $element, $tags[2] ? $tags[2] : 9, '', $parameters);
    $output .= theme('pager_next', $tags[3] ? $tags[3] : t('next ›'), $limit, $element, 1, $parameters);
    $output .= theme('pager_last', $tags[4] ? $tags[4] : t('last »'), $limit, $element, $parameters);
    $output .= '</div>';
    return $output;
  }
}