Paginación PHP con clase
Últimamente ando revisando mis posts antiguos y en esta ocasión quería mostrarles una clase de paginación echa en PHP que es más fácil y prolija de usar que el código de Paginación PHP que publique hace tiempo. Creo que esta forma es la adecuada y aunque no entiendan o manejen clases de PHP , es un buen momento para salpicarse un poco en este mundillo.
Para empezar les quiero mostrar 2 ejemplos de esta clase:
Métodos de la clase
- Paginator. Constructor. Como usar:
$pages = new Paginator;
- paginate. Calcula las páginas a mostrar. Como usar:
$pages->paginate();
- display_items_per_page. Devuelve una cadena HTML para mostrar items por página. Como usar:
echo $pages->display_items_per_page();
- display_jump_menu. Devuelve una cadena HTML para mostrar el salto de página. Como usar:
echo $pages->display_jump_menu();
- display_pages. Devuelve la cadena HTML que muestra lás paginas. Como usar:
echo $pages->display_pages();
Ahora veamos como usar realmente la clase
- Incluimos la clase:
require_once('paginator.class.php');
- Creamos el objeto paginator:
$pages= new Paginator;
- Configuramos el total de resultados de nuestra query. Para ello podemos usar una COUNT(*) que devuelva la cantidad total de resutados:
$pages->items_total = X; // cambiamos X por el total
- Configuramos el total de links a mostrar. Por ejemplo el valor por defecto es 7 . Si estamos en la pág 50 mostraria : 47 47 49 50 51 52 53
$pages->mid_range = X;
- Llamamos al método paginate para que cree la paginación (este método no devuelve nada)
$pages->paginate();
- Imprimimos las páginas que hemos páginado en el paso anterior:
echo $pages->display_pages();
- Opcionalmente se pueden usar los métodos de display_jump_menu o display_items_per_page
- Como ya tenemos la paginación generada ya podemos usar $pages->limit en nuestra query para limitar los resultados. Por ej:
SELECT id, name, address FROM table ORDER BY id ASC $pages->limit
Con estos pasos ya tendremos funcionando la clase PHP para paginar resultados.
Para darle estilo pueden aplicar el que el desarrollador usa por defecto o pueden probar a adaptar algún otro estilo como los descriptos en este otro post.
<style type="text/css"> .paginate { font-family: Arial, Helvetica, sans-serif; font-size: .7em; } a.paginate { border: 1px solid #000080; padding: 2px 6px 2px 6px; text-decoration: none; color: #000080; } a.paginate:hover { background-color: #000080; color: #FFF; text-decoration: underline; } a.current { border: 1px solid #000080; font: bold .7em Arial,Helvetica,sans-serif; padding: 2px 6px 2px 6px; cursor: default; background:#000080; color: #FFF; text-decoration: none; } span.inactive { border: 1px solid #999; font-family: Arial, Helvetica, sans-serif; font-size: .7em; padding: 2px 6px 2px 6px; color: #999; cursor: default; } </style> |
Y por último aquí tienen la clase PHP encargada de todo:
<?php /* * PHP Pagination Class * @author [email protected] - http://www.catchmyfame.com * @version 2.0.0 * @date October 18, 2011 * @copyright (c) [email protected] (www.catchmyfame.com) * @license CC Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0) - http://creativecommons.org/licenses/by-sa/3.0/ */ class Paginator{ var $items_per_page; var $items_total; var $current_page; var $num_pages; var $mid_range; var $low; var $limit; var $return; var $default_ipp; var $querystring; var $ipp_array; function Paginator() { $this->current_page = 1; $this->mid_range = 7; $this->ipp_array = array(10,25,50,100,'All'); $this->items_per_page = (!empty($_GET['ipp'])) ? $_GET['ipp']:$this->default_ipp; } function paginate() { if(!isset($this->default_ipp)) $this->default_ipp=25; if($_GET['ipp'] == 'All') { $this->num_pages = 1; // $this->items_per_page = $this->default_ipp; } else { if(!is_numeric($this->items_per_page) OR $this->items_per_page <= 0) $this->items_per_page = $this->default_ipp; $this->num_pages = ceil($this->items_total/$this->items_per_page); } $this->current_page = (isset($_GET['page'])) ? (int) $_GET['page'] : 1 ; // must be numeric > 0 $prev_page = $this->current_page-1; $next_page = $this->current_page+1; if($_GET) { $args = explode("&",$_SERVER['QUERY_STRING']); foreach($args as $arg) { $keyval = explode("=",$arg); if($keyval[0] != "page" And $keyval[0] != "ipp") $this->querystring .= "&" . $arg; } } if($_POST) { foreach($_POST as $key=>$val) { if($key != "page" And $key != "ipp") $this->querystring .= "&$key=$val"; } } if($this->num_pages > 10) { $this->return = ($this->current_page > 1 And $this->items_total >= 10) ? "<a class=\"paginate\" href=\"$_SERVER[PHP_SELF]?page=$prev_page&ipp=$this->items_per_page$this->querystring\">« Previous</a> ":"<span class=\"inactive\" href=\"#\">« Previous</span> "; $this->start_range = $this->current_page - floor($this->mid_range/2); $this->end_range = $this->current_page + floor($this->mid_range/2); if($this->start_range <= 0) { $this->end_range += abs($this->start_range)+1; $this->start_range = 1; } if($this->end_range > $this->num_pages) { $this->start_range -= $this->end_range-$this->num_pages; $this->end_range = $this->num_pages; } $this->range = range($this->start_range,$this->end_range); for($i=1;$i<=$this->num_pages;$i++) { if($this->range[0] > 2 And $i == $this->range[0]) $this->return .= " ... "; // loop through all pages. if first, last, or in range, display if($i==1 Or $i==$this->num_pages Or in_array($i,$this->range)) { $this->return .= ($i == $this->current_page And $_GET['page'] != 'All') ? "<a title=\"Go to page $i of $this->num_pages\" class=\"current\" href=\"#\">$i</a> ":"<a class=\"paginate\" title=\"Go to page $i of $this->num_pages\" href=\"$_SERVER[PHP_SELF]?page=$i&ipp=$this->items_per_page$this->querystring\">$i</a> "; } if($this->range[$this->mid_range-1] < $this->num_pages-1 And $i == $this->range[$this->mid_range-1]) $this->return .= " ... "; } $this->return .= (($this->current_page < $this->num_pages And $this->items_total >= 10) And ($_GET['page'] != 'All') And $this->current_page > 0) ? "<a class=\"paginate\" href=\"$_SERVER[PHP_SELF]?page=$next_page&ipp=$this->items_per_page$this->querystring\">Next »</a>\n":"<span class=\"inactive\" href=\"#\">» Next</span>\n"; $this->return .= ($_GET['page'] == 'All') ? "<a class=\"current\" style=\"margin-left:10px\" href=\"#\">All</a> \n":"<a class=\"paginate\" style=\"margin-left:10px\" href=\"$_SERVER[PHP_SELF]?page=1&ipp=All$this->querystring\">All</a> \n"; } else { for($i=1;$i<=$this->num_pages;$i++) { $this->return .= ($i == $this->current_page) ? "<a class=\"current\" href=\"#\">$i</a> ":"<a class=\"paginate\" href=\"$_SERVER[PHP_SELF]?page=$i&ipp=$this->items_per_page$this->querystring\">$i</a> "; } $this->return .= "<a class=\"paginate\" href=\"$_SERVER[PHP_SELF]?page=1&ipp=All$this->querystring\">All</a> \n"; } $this->low = ($this->current_page <= 0) ? 0:($this->current_page-1) * $this->items_per_page; if($this->current_page <= 0) $this->items_per_page = 0; $this->limit = ($_GET['ipp'] == 'All') ? "":" LIMIT $this->low,$this->items_per_page"; } function display_items_per_page() { $items = ''; if(!isset($_GET[ipp])) $this->items_per_page = $this->default_ipp; foreach($this->ipp_array as $ipp_opt) $items .= ($ipp_opt == $this->items_per_page) ? "<option selected value=\"$ipp_opt\">$ipp_opt</option>\n":"<option value=\"$ipp_opt\">$ipp_opt</option>\n"; return "<span class=\"paginate\">Items per page:</span><select class=\"paginate\" onchange=\"window.location='$_SERVER[PHP_SELF]?page=1&ipp='+this[this.selectedIndex].value+'$this->querystring';return false\">$items</select>\n"; } function display_jump_menu() { for($i=1;$i<=$this->num_pages;$i++) { $option .= ($i==$this->current_page) ? "<option value=\"$i\" selected>$i</option>\n":"<option value=\"$i\">$i</option>\n"; } return "<span class=\"paginate\">Page:</span><select class=\"paginate\" onchange=\"window.location='$_SERVER[PHP_SELF]?page='+this[this.selectedIndex].value+'&ipp=$this->items_per_page$this->querystring';return false\">$option</select>\n"; } function display_pages() { return $this->return; } } |
Pueden ver más información en el post del autor: http://www.catchmyfame.com/2007/07/28/finally-the-simple-pagination-class/
Saludos!!!
Acerca del autor
by Damián Logghe
Programador freelancer y emprendedor en sueños. Contento de ser mi jefe y poder hacer lo que me gusta. Wordpress es mi principal fuente de ingreso y me escribo tanto para ayudar como para tener una guia de memoria. Quieres contratarme? Déjame un mensaje.







Pingback: Paginación con PHP y MySQL + 3 estilos