
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
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(1, true); /* 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.