Pager ( stronicowanie ) Opcje

[Adrian Staniszew...]

Witam,

Z potrzeby - bo to własnie ona jest matką wynalazków (a tak można nazwać ową klasę) - napisałem dla Siebie, swoich projektów prostą klasę do obsługi stronicowania. Przy projektowaniu skupiłem się głównie na tym aby generując nowy Pager mieć jak największą swobode przy generowaniu nowego pagera. Wszystkie parametry jakie uznałem za warte zastosowania można więc zmienic wywolujac klase. Przygotowalem ja tez dla kilku wywolan na stronie.

Klasa stylizowana jest na PHP5 - określenie iż jest napisana w PHP5 bym nie urzyl..

Jest to moja pierwsza publikowana klasa, kod nie jest opisany, ale z czasem poprawie zarówno klase jak i opisze ja zgodnie ze standardami.

Zapraszam do testowania :

[PHP] pobierz, plaintext 
<?
###############################################################
# Adrian Staniszewski
# adrian_s@toya.net.pl
# GG: 5513236
#
#	File:		  Class.Pager.php5
#	Version:	   1.3v.+
#	Modif:		 16.10.2006r. 16:30
#	Description:   Pager for www
#
##############################################################
 
class Pager {
 
  public $p_name;
  private $p = array();
  private $links = array();
 
  public function Pager($p_name='pager', $p_count='1', $p_per='250', $p_link='7', $p_sep=' ') {
	$this -> p_name = $p_name;
	$this -> setVar('count', $p_count);
	$this -> setVar('per', $p_per);
	$this -> setVar('html_link', '<a href="index.php?site={^link}" title="{^title}" style="text-decoration: none;">{^name}</a>n');
	$this -> setVar('sep', $p_sep);
	$this -> setVar('link', $p_link);
	$this -> setVar('site', '1');
	$this -> setVar('fast_link', '5');
  }
 
  private function getPages() {
	$this -> setVar('pages', ceil(($this -> getVar('count')/$this -> getVar('per'))));
  }
 
  private function setPages($page) {
	$this -> setVar('site', $page);
  }
 
  private function buildPager() {
 
	($this -> getVar('fast_link') >= '5' && $this -> getVar('pages') > '51' && $this -> getVar('site') > '50')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 50), 'Wstecz o 50 stron', '<strong><||</strong>'):'';
	($this -> getVar('fast_link') >= '4' && $this -> getVar('pages') > '31' && $this -> getVar('site') > '30')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 30), 'Wstecz o 30 stron', '<strong><<|</strong>'):'';
	($this -> getVar('fast_link') >= '3' && $this -> getVar('pages') > '11' && $this -> getVar('site') > '10')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 10), 'Wstecz o 10 stron', '<strong><|</strong>'):'';
	($this -> getVar('fast_link') >= '2' && $this -> getVar('pages') > '6' && $this -> getVar('site') > '5')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 5), 'Wstecz o 5 stron', '<strong><<</strong>'):'';
	($this -> getVar('fast_link') >= '1' && $this -> getVar('pages') > '1' && $this -> getVar('site') > '1')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 1), 'Wstecz o strone', '<strong><</strong>'):'';
 
	$start = ($this -> getVar('site') - ceil($this -> getVar('link')/2));
	if($start <= '0') $start = '1';
 
	$koniec = ($this -> getVar('site') + ceil($this -> getVar('link')/2));
	if($koniec > $this -> getVar('pages')) $koniec = $this -> getVar('pages');
 
	for($i=$start; $i <= $koniec; $i++) {
		 ($i == $this -> getVar('site'))?$name = '<font size=+1>'.$i.'</font>':$name=$i;
	   $this -> links[$this -> p_name][] = $this -> createLink($i, $i, $name);
	}
	$this -> links[$this -> p_name][] = 'z <strong>'.$this -> getVar('pages').'</strong>';
	($this -> getVar('fast_link') >= '1' && $this -> getVar('pages') > $this -> getVar('site'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 1), 'Naprzód o strone', '<strong>></strong>'):'';
	($this -> getVar('fast_link') >= '2' && ($this -> getVar('site') + 5) <= $this -> getVar('pages'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 5), 'Naprzód o 5 stron', '<strong>>></strong>'):'';
	($this -> getVar('fast_link') >= '3' && ($this -> getVar('site') + 10) <= $this -> getVar('pages'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 10), 'Naprzód o 10 stron', '<strong>|></strong>'):'';
	($this -> getVar('fast_link') >= '4' && ($this -> getVar('site') + 30) <= $this -> getVar('pages'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 30), 'Naprzód o 30 stron', '<strong>|>></strong>'):'';
	($this -> getVar('fast_link') >= '5' && ($this -> getVar('site') + 50) <= $this -> getVar('pages'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 50), 'Naprzód o 50 stron', '<strong>||></strong>'):'';
  }
 
  private function createLink($link, $title, $name) {
	return preg_replace('/{^(.*?)}/sie', '$$1', $this -> getVar('html_link'));
  }
 
  public function Render() {
	$this -> getPages();
	$site = ($_GET['site']<>'' and is_numeric($_GET['site']))?''.$_GET['site'].'':'1';
	$this -> setPages($site);
	$this -> buildPager();
 
	foreach($this -> links[$this -> p_name] as $link) {
	  $html_out .= ''.$link.''.$this -> getVar('sep').'';
	}
	$this -> p[$this -> p_name]['html_out'] = $html_out;
	return $html_out;
  }
 
  public function startRecord() {
	return (($this -> getVar('site') - 1) * $this -> getVar('per'));
  }
 
  public function getVar($get) {
	return $this -> p[$this -> p_name][$get];
  }
 
  public function setVar($get, $var) {
	$this -> p[$this -> p_name][$get] = $var;
  }
 
  public function buildLink($link = 'index.php5', $delete = array('site')) {
 
	foreach($_GET as $pole => $war) {
	  $pole = trim($pole);
		if(!in_array($pole, $delete)) {
		  $a++;
		  ($a==1)?$zn='?':$zn='&';
		  $link .= ''.$zn.''.$pole.'='.$war.'';
		}
	}
return $link;
}
 
  public function setFastLink($leavel = '5') {
	if(is_numeric($leavel) && $leavel >= '0' && $leavel <= '5') {
	  $this -> setVar('fast_link', $leavel);
	}
  }
 
  public function setHTML_Link($html_link) {
	$this -> setVar('html_link', $html_link);
  }
 
}
?>
[PHP] pobierz, plaintext 

Klase wywolujemy :

[PHP] pobierz, plaintext 
<?
include_once 'Class.Pager.php5';
 
// nazwa pagera || ilosc rekordow || ilosc wyswietlanych rekordow || ilosc wyswiet
lanych linkow do stron || oddzielanie linkow
$p = new Pager("nazwa_pagera", $num, "25");
// jesli mamy link posiadajacy parametry i chcemy je "przepisac" do naszego nowego linku do podstrony uzywamy builder'a linkow
$link = $p -> buildLink();
$link = "<a href="$link$pagess&site={^link}" title="{^title}" style="text-decoration: none;">{^name}</a>";
// funkcja ustawiajaca szablon linku
$p -> setHTML_Link($link);
// wywolanie - wyswietlenie pagera
echo $p -> Render();
 
?>
[PHP] pobierz, plaintext 

Ten post edytował Adrian Staniszewski 21.10.2006, 12:07:00

[Adrian Staniszew...]

Wydanie wersji 1.3 (IMG:http://forum.php.pl/style_emoticons/default/winksmiley.jpg)

Jest kilka istotnych zmian :
- ograniczyłem ilosc parametrow ustawianych w wywoalniu klasy (funkcja Pager)
- dodalem funkcje setFastLink(); - (opis w pierwszym poscie)
- poprawilem i zmienilem funkcje buildLink(); (usunalem GLOBAL)
- dodalem funkcje setHTML_Link(); zmieniajaca szablon linku HTML (mozna tutaj uzywac pomocniczo buildLink(); )
- dodałem ograniczenie wyswietlania "szybkich linkow"

Zapraszam do testowania i tworzenia projektow w oparciu o moj prosty Pager (IMG:http://forum.php.pl/style_emoticons/default/smile.gif)

p.s
przeprowadzilem badanie wydajnosci Pagera
wyniki sa oparte na 50 tys. wywolan, 100 tys. rekordow, 25 na strone

sredni czas generowania : 0,0025s (IMG:http://forum.php.pl/style_emoticons/default/smile.gif)


jezeli chcemy w kilku miejscach na stronie wyswietlic nasz raz wygenerowany pager uzywamy :

[PHP] pobierz, plaintext 
<?
 
echo $p -> getVar("html_out");
 
?>
[PHP] pobierz, plaintext 

gdy na stronie mamy kilka Pagerow - rozrozniamy je po nazwie zadeklarowanej w wywolaniu klasy - wystarczy zmienic nazwe aktualnego Pagera poprzez:

[PHP] pobierz, plaintext 
<?
 
$p -> p_name = "nazwa_obecnego_pagera";
 
?>
[PHP] pobierz, plaintext 

dodatkowo gdy pobieramy dane z bazy, skrypt latwo i szybko wygeneruje nam parametry pobierania:

[PHP] pobierz, plaintext 
<?
 
$start = $p -> startRecord();
$koniec = $p -> getVar("per");
 
?>
[PHP] pobierz, plaintext 

Wszystkim szukajacym profesjonanego Pagera zapraszam do klasy nospora a lubiacym testowanie zapraszam do testowania (IMG:http://forum.php.pl/style_emoticons/default/smile.gif)

Pozdrawiam
Adrian Staniszewski

edit..

Funkcja buildLink();
wywolujemy ja po prostu :

[PHP] pobierz, plaintext 
<?
 
// w funkcji mozemy a raczej powinnismy zadeklarowac nazwe zmiennej GET w ktorej b
edziemy trzymac numer strony, aby skrypt usunal ja z tworzonego linku - mozemy tez podac inne zmienne ktore chcemy usunac z linku - calosc podajemy w formie tablicy
$link = $p -> buildLink();
 
// funkcja ta posiada 2 parametry - nazwa pliku (ew. sciezka do pliku) oraz wykluczenia (co ma zostac usuniete z linku)
 
$delete = array('site', 'kat', 'parent'); // wykluczenia
$link = $p -> buildLink('index.php', $delete);
 
?>
[PHP] pobierz, plaintext 

w najnowszej wersji dodano tez funkcje setFastLink(); ustawia ona ile szybkich linkow ma zostac wygenerowanych w danym Pagerze - domyslnie jest to 5 na "strone" (+1, +5, +10, +30, +50, -1, -5, -10, -30, -50)

wartosc tego parametru to 0-5, a uzywamy go :

[PHP] pobierz, plaintext 
<?
 
// przed wywolaniem funkcji Render();
$p -> setFastLink('3');
 
?>
[PHP] pobierz, plaintext