Tabelkownik - skrypt tabel piłkarskich

Dokumentacja

Jest to bardzo podstawowa dokumentacja adresowana do osób, którym samodzielna analiza pliku example.php sprawia trudność. Wszystkie informacje dotyczą Tabelkownika 1.5+.

1. Podłączenie Tabelkownika do strony

Do pliku, który ma wyświetlać tabele generowane przez skrypt musimy podłączyć Tabelkownika. Realizuje to poniższy fragment kodu:
<?
    $tbkpath 
'tabelkownik'//ścieżka do katalogu tabelkownika
    
require $tbkpath.'/func/class.tabelkownik.php'//podlaczenie bibliotek
    
$tbk = new Tabelkownik($tbkpath); //utworzenie obiektu Tabelkownika
?>

Ścieżkę należy podać względem pliku wyświetlającego, a więc powyższy kod zadziała, jeśli plik wyswietlający znajduje się w tym samym katalogu, co katalog tabelkownik zawierający pliki skryptu. W przypadku, gdy jest inaczej, ścieżkę należy ustawić na właściwą, np. plik z przykładowymi tabelami example.php znajduje się wewnątrz katalogu tabelkownik, stąd scieżka ustawiona jest na biezący katalog, czyli kropkę:
<?
    $tbkpath 
'.'//ścieżka do katalogu tabelkownika
?>

Poprzez zmienną $tbk mamy teraz dostęp do metod udostępnianych przez skrypt.

2. Metody udostępniane przez skrypt

  • Wyświetlenie tabeli
    Tabelkownik::displayTable(id_ligi, typ_tabeli [,numer_kolejki] [,typ_sort])
  • Wyświetlenie meczów z kolejki
    Tabelkownik::displayFixture(id_ligi, numer_kolejki [,herby])
  • Wyświetlenie meczów z kolejki po datach
    Tabelkownik::displayFixturesByDate(id_ligi, numer_kolejki [,herby])
  • Wyswietlenie całego terminarza (od wersji 1.53)
    Tabelkownik::displayFixtures(id_liga [,herby] [,typ_sort])
  • Wyświetlenie tabeli krzyżowej
    Tabelkownik::displayCrossTable(id_ligi [,skroty])
  • Wyświetlenie tabeli serii
    Tabelkownik::displaySeriesTable(id_ligi [,kolejka_od] [,kolejka_do] [,skroty])
  • Wyświetlenie terminarza na ślajdach
    Tabelkownik::displayAllFixtures(id_liga, aktualna_kolejka [,herby]))
  • Wyświetlenie następnych/poprzednich meczów danej drużyny
    Tabelkownik::displayMatches(id_liga, licz_nast_mecz [,emblemy] [,kolejka_od] [,id_druzyna] )
  • Wyświetlenie punktów ujemnych w lidze
    Tabelkownik::displayNegativePoints(id_liga)

3. Wyświetlenie tabeli

Do wyświetlania tabel służy metoda Tabelkownik::displayTable(id_ligi,typ_tabeli[,kolejka_tabeli][,typ_sort])
gdzie id_ligi to identyfikator ligi, której tabelę chcemy wyświetlić (identyfikatory podane są w panelu sterowania w sekcji Zarządzanie ligami); typ_tabeli to jeden z 3 wariantów tabeli: 1 - zwykła tabela, 2 - rozbudowana tabela, 3 - mała tabela; kolejka_tabeli określa numer kolejki, do której tabela ma być sporządzona (przekazanie false spowoduje sporządzenie tabeli z uwzględnieniem wszystkich kolejek); typ sortowania określa, czy kolejność drużyn ustalają mecze bezpośrednie (true) czy różnica bramek (false).
Przykłady:
<?
    $tbk
->displayTable(1,1,false,true); /* wyswietli tabelę ligi o id 1, zwykłą,
    dla wszystkich kolejek, sortując po meczach bezpośrednich */
    
$tbk->displayTable(5,2); /* wyswietli tabelę ligi o id 5, rozbudowaną,
    dla wszystkich kolejek, sortując po meczach bezpośrednich */
    
$tbk->displayTable(11,3,5,false); /* wyswietli tabelę ligi o id 11, małą,
    uwzględniając mecze do 5 kolejki, sortując po różnicy bramek */
?>

4. Wyświetlenie terminarza

Wyświetlenia wszystkich spotkań z jednej kolejki dokonuje się w sposób:
<?
    $tbk
->displayFixture(1,2,true); /* wyswietli 2. kolejkę z ligi o id 1, pokazując herby */
    
$tbk->displayFixture(7,4,false); /* wyswietli 4. kolejkę z ligi o id 7, bez herbów */
?>

Jeżeli ustawiono daty spotkań, można skorzystać z wyświetlania po datach
<?
    $tbk
->displayFixturesByDate(1,3,true); /* wyswietli 3. kolejkę z ligi o id 1, pokazując herby */
?>

Wyświetlenie całego terminarza wymaga pobrania numeru ostatniej dodanej kolejki z bazy danych
<?
    $q 
"SELECT max(nr_kolejki) FROM {$tbk->db->getPrefix()}mecz WHERE id_liga=1"/* zapytanie pobiera 
    najwyższy numer kolejki z ligi o id 1 */
    
$ost_kol $tbk->db->getValue($q);
    for(
$i 1$i <= $ost_kol$i++){
        
$tbk->displayFixture($liga_num,$i);
    }
?>

lub wywołania gotowej metody (od wersji 1.53):
<?
    $tbk
->displayFixtures(1,true,1); /* wyświetli wszystkie kolejki z ligi o id 1, z herbami,
    począwszy od 1 kolejki */
    
$tbk->displayFixtures(5,false,-1); /* wyświetli wszystkie kolejki z ligi o id 5, bez herbów,
    zaczynając od ostatniej kolejki */
?>

Alternatywnie można wygenerować cały terminarz na przełączanych ślajdach, dzięki czemu oszczędzane jest miejsce na stronie. Sposób ten wymaga podłączenia do strony skryptu języka JavaScript obsługi ślajdów. W sekcji <head> pliku wyświetlającego należy dodać linię: <script type="text/javascript" src="tabelkownik/conf/js/slides.js"></script>, a kod php wygląda następująco (od wersji 1.54):
<?
    $tbk
->displayAllFixtures(1true); /* wyświetli terminarz na przewijanych slajdach ligi
    o id 1 z herbami */
?>

Istnieje także możliwość wyświetlania pojedynczych meczów danej drużyny:

5. Zakończenie

Wszytkie powyższe przykłady jak i użycie pozostałych metod skryptu w praktyce można zobaczyć w kodzie pliku example.php.

created by Radosław Zatoka