theme_pager_next

• Drupal 4.6
• Drupal 4.7
• Drupal 5
• Drupal 6
• Drupal 7

includes/pager.inc, line 309

Versions

4.6

theme_pager_next($text, $limit, $element = 0, $interval = 1, $attributes = array())

4.7 – 6

theme_pager_next($text, $limit, $element = 0, $interval = 1, $parameters = array())

7

theme_pager_next($text, $element = 0, $interval = 1, $parameters = array())

Format a "next page" link.

Parameters

$text The name (or image) of the link.

$limit The number of query results to display per page.

$element An optional integer to distinguish between multiple pagers on one page.

$interval The number of pages to move forward when the link is clicked.

$parameters An associative array of query string parameters to append to the pager links.

Return value

An HTML string that generates this piece of the query pager.

Related topics

Default theme implementations

Functions and templates that present output to the user, and can be implemented by themes.

Code

<?php
function theme_pager_next($text, $limit, $element = 0, $interval = 1, $parameters = array()) {
  global $pager_page_array, $pager_total;
  $output = '';

  // If we are anywhere but the last page
  if ($pager_page_array[$element] < ($pager_total[$element] - 1)) {
    $page_new = pager_load_array($pager_page_array[$element] + $interval, $element, $pager_page_array);
    // If the next page is the last page, mark the link as such.
    if ($page_new[$element] == ($pager_total[$element] - 1)) {
      $output = theme('pager_last', $text, $limit, $element, $parameters);
    }
    // The next page is not the last page.
    else {
      $output = theme('pager_link', $text, $page_new, $element, $parameters);
    }
  }

  return $output;
}
?>