Paginación PHP con clase

Categorías: PHP, Tutoriales - Tags: ,

Ú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:

  1. Ejemplo básico
  2. Ejemplo donde se arrastran variables en cada página

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

  1. Incluimos la clase:
    require_once('paginator.class.php');
  2. Creamos el objeto paginator:
    $pages= new Paginator;
  3. 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
  4. 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;
  5. Llamamos al método paginate para que cree la paginación (este método no devuelve nada)
    $pages->paginate();
  6. Imprimimos las páginas que hemos páginado en el paso anterior:
    echo $pages->display_pages();
  7. Opcionalmente se pueden usar los métodos de display_jump_menu o display_items_per_page
  8. 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\">&laquo; Previous</a> ":"<span class=\"inactive\" href=\"#\">&laquo; 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 &raquo;</a>\n":"<span class=\"inactive\" href=\"#\">&raquo; 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

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.

Más Posts de Damián Logghe - Web

Sigueme:
TwitterFacebookLinkedIn

  • Marcos

    Genial! tu código se ver genial, voy a probarla, una clase que también me gusta mucho es kpaginate, dejo el link por si le sirve a alguien: paginación php

    Saludetes :)

  • http://www.satelliteview.org Marcelo

    Me gusto mucho, lo voy a usar en mi directorio Maskay http://www.maskay.com

  • Goavas

    Muchas gracias!!! Esta muy bien la clase, soy un novato en esto de PHP y la verdad me ayudó muchísimo, te dejo mis comentarios:

    1. Con el count(*) me regresaba un "Resource id #5" por lo que se calculaba mal el numero de páginas.
    Lo resolví con el siguiente código

    $sql = "select campo from tabla"; // SQL que traerá todos los datos de un campo
    $result = mysql_query($sql,$mysql); // Ejecuto SQL
    $total = mysql_num_rows($result); // Cuento los registros
    $pages->items_total = $total; // Asigno el total a este atributo

    2. Falta un "?>" al final y en la línea 111 faltan las comillas simples en $_GET[ 'ipp' ]

    3. Extrañamente en el método "display_jump_menu()" me mandó error ya que la variable option no esta definida.
    Lo resolví colocando

    $option = $_GET['page'];

    Antes de entrar al for.

    Quedo a tus comentarios mi estimado.
    Gracias!!!

  • Ruffles182

    Probando… muchas gracias… había completado un proyecto y omití este pequeño detalle! xD jajaja… me salvaste ya que a primera impresión esta muy bien! =)

  • Gil_gzz18

    Ya veo la cantidad de paginas, No puedo acomodar bien la consulta alguien que me pueda ayudar?

    require_once (‘../inc/clases/paginador.class.php’);// Make your database connection here and retrieve your total number of//items (i.e. SELECT COUNT(*) FROM…)$sql1 = “SELECT COUNT(*) as cuantos FROM taco_pedido ” ;$result1 = mysql_query($sql1);$row1 = mysql_fetch_array($result1);$cuantos=$row1[cuantos];$pages = new Paginator;$pages->items_total = $cuantos;$pages->mid_range = 7;$pages->paginate();// Make your db query here. Include $pages->limit as described in step 8.//(i.e. SELECT id,fname,lname FROM employees $pages->limit)$sql2 = “SELECT PeId,PeTotal FROM taco_pedido $pages->limit”;$result2 = mysql_query($sql2 );echo $pages->display_pages(); // Optional call which will display the page numbers after the results.echo $pages->display_jump_menu(); // Optional – displays the page jump menuecho $pages->display_items_per_page(); //Optional – displays the items perpage menu

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

  • Gsuskrist007

     Use of undefined constant ipp – assumed ‘ipp’ in

  • Gsuskrist007

    error:
    Use of undefined constant ipp – assumed ‘ipp’ in: varwwwmipagina.php
    ke debo hacer?

  • oldcid

    hola buenas tengo una pregunta la función count (*) donde la ubicaria disculpas por la ignorancia pero no me esta tomando la cantidad de resultados devueltos por la busqueda, gracias