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

[NetJaro]

Większych zastrzeżeń nie mam, ale tylko mała uwaga - z racji, że stronicowanie jest czasami dość ciężką "operacją" dla Apache - starałbym się jak najbardziej optymalizować skrypt który za to odpowiada - i dlatego wszystkie " " (cudzysłowia) zamieniłbym na ' ' (pojedyńcze apostrofy/cudzysłowia). Większa to szybkość wykonania kodu. Dodatkowo przy liczbach:

$p = new Pager("nazwa_pagera", $num, "25");

Nie trzeba używać żadnych cudzysłowiów ;-)

I widzę stary nawyk z PHP4 - aby stworzyć konstruktor wystarczy nazwać funkcję __construct, a nie jak w PHP4 - tak jak nazwa klasy. Skoro klasa i tak nie pójdzie na PHP4 to po co używać jego części ;-)

Ten post edytował NetJaro 17.10.2006, 21:16:59

[Adrian Staniszew...]

Witam,

poprawiłem kod klasy, zastapilem "" ''
mam nadzieje iz teraz zyskamy troszke wydajnosci

dodałem też nowa funkcje build_link(); - przyda sie wszystkim, ktorzy przekazuja w linku jakies parametry, np. wyszukiwania - domyslnie zbudowany link nie obsluguje mod_revrite

co do konstruktora.. moja funkcja Pager bedaca konstruktorem, jest takze funkcja tworzoca nowy Pager.. mozliwe iz myle sie ale uznalem iz lepiej zastosowac tutaj nazwe zwyczajawa funkcji zamiast __construct

jeżeli się myle to prosze o uwage na ten temat

Pozdrawiam

Ten post edytował Adrian Staniszewski 18.10.2006, 20:15:35

[acztery]

a ja mam pytanie. w funkcji build_link masz GLOBAL pomysl jak sie tego pozbyc.... nie stosuje sie juz global

[Adrian Staniszew...]

Wydanie wersji 1.3

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

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

sredni czas generowania : 0,0025s


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

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 

[Taifun]

ta klasa jest prostsza od klasy, która jest ogólnie polecana początkującym (z tego forum)
a mianowicie jest lepsza od tego topora: http://forum.php.pl/index.php?showtopic=35...t=0&start=0

Ten post edytował Taifun 14.08.2007, 21:40:41

[Adrian Staniszew...]

miło mi to słyszec będe musiał chyba pomyślec nad wgraniem nowej wersji i rozpisaniem dokumentacji dla innych

[soon]

przepraszam za pytanie, ale jak zrobić, żeby liczyło rekordy z bazy mysql?

[Adrian Staniszew...]

[PHP] pobierz, plaintext 
<?php
  $zapytanie = mysql)query("...") or die(mysql_error());
  $num = mysql_num_rows($zapytanie);
?>
[PHP] pobierz, plaintext 

Witam,

Nie wiem skąd przeświadczenie o tym, iż skrypt można wykorzystywać komercyjnie bez mojej zgody..
Oświadczam, iż korzystanie ze skryptu w celach komercyjnych jest ZABRONIONE.