LINUXSOFT.cz Přeskoč levou lištu

ARCHIV



   

> PHP knihovny - Smarty V

V tomto díle o Smarty šablonovacím systému budou ukázány především vestavěné funkce pro formátování dat, tvoření formulářů a vytvážení tabulek.

31.3.2005 15:00 | MaReK Olšavský | Články autora | přečteno 14567×

Formuláře pomocí Smart

Šablonovací systém Smarty nabízí několik funkcí, které autorovi ušetří značné množství práce, ale především času, při vytváření formulářů. (Formuláře jsou jednou z nejdůležitějších součástí interaktivních WWW stránek, neřkuli internetových obchodů.) Jména všech těchto funkcí začínají řetězcem html_ (včetně koncového podtržíka). Bohužel možnosti tvorby formulářů pomocí Smarty šablon nejsou úplné a je výhodnější použít Smarty plugin, který bude popsán v pozdějších dílech.

html_checkboxes

Příkaz html_checkboxes slouží k vytvoření zaškrtávacích boxů. Korektní název by mohl být pole spínačů, protože každý lze nastavit bez ovlinění ostatních, výjimkou může být ovládání pomocí javascriptu. Vyžadovaná pole mohou být naplněna ještě na straně PHP scriptu, nebo dle aktuální situace na straně šablony. Výstup do zobrazované šablony je kompatibilní s požadavky normy XHTML. Parametry funkce jsou následující:
  • name - nepovinný parametr,  řetězec, určuje jméno pro celý checkbox set. Pokud nebude použit, bude nastaven na defaultní checkbox
  • values - povinný parametr, pokud není použit parametr options, typu pole. Určuje hodnoty k jednotlivým zaškrtávacím políčkům.
  • output - povinný parametr, pokud není použit parametr options, typu pule. Určuje  popisy k jednotlivým zaškrtávacím políčkům.
  • options - nepovinný parametr, kterým lze nahradit parametry values a options, je typu associativní pole ve tvaru array(value1=>output1[[,valuen=>outputn]]);
  • selected - nepovinný parametr, typu řetězec (je-li vybrána jen jedna hodnota), nebo pole (při výběru jedné a více hodnot). Definuje, která políčka budou po startu zaškrtnuta. Zadávají se values, nikoliv outputs.
  • separator - nepovinný parametr, typu řetězec. Určuje oddělovač jednotlivých zaškrtávacích políček, například odřádkování.
  • labels - nepovinný parametr, logického typu, s výchozí hodnotou true. Určuje, zda-li bude k jednotlivým zaškrtávacím políčkům přidán obalovací tag <label>

html_radios

Tento příkaz slouží vytvoření přepínačů, na rozdíl od checkboxů může být vybrána pouze jedna hodnota.  Opět mohou být vyžadovaná pole naplněna jak na straně PHP scriptu, tak přímo v šabloně. Výstup je opět generován kompatibilní s normou XHTML. Parametry funkce jsou stejné jako u html_checkboxes, se dvěma vyjímkami:
  • není definován parametr labels
  • selected - je pouze řetězcem, protože v případě přepínačů lze mít zvolenu jen jednu hodnotu.

html_options

Příkaz ke generování rozbalovací nabídky select (option), který je opět generován 100% kompatibilní s XHML  standardem. Automaticky je řešen předvýběr zvolené hodnoty, případně více hodnot. Jestliže je místo kterékoliv ze vstupních hodnot v poli values vnořené pole, je udělán podvýběr (stejně jako při použití <optgroup> při ruční tvorbě). Parametry funkce jsou stejné jako v případě html_checkboxes, s několika výjimkami:
  • Nejsou definovány parametry separator a labels.
  • selected - může být definován jako pole i jako řetězec. Určuje, které hodnoty z options budou defaultně označené.

html_select_date

Funkce, která generuje do formuláře na www stránce výběr datumu. Funce má velké množství nepovinných parametrů, které definují pojmenování proměnných, rozsah zadávání, ... Parametry jsou následující:
  • prefix - nepovinný parametr, typu řetězec. Určuje předponu jména pro nastavovaný datum. Například "od_", "do_", ... Pokud není použit je obtížné rozlišit ze kterého datumu jsou data čerpána.
  • time - nepovinný parametr, ve formátu timestamp (unixový čas), nebo rrrr-mm-dd. Určuje datum, který bude v selectech přednastaven
  • start_year - nepovinný parametr řetězcového typu, který určuje nejnižší vybíratelný rok. Lze jej uvést jako rok, nebo relativně k aktuálnímu roku. Výchozí hodnota je aktuální rok.
  • end_year - stejné jako start_year, ale koncový rok výběru. Výchozí hodnota je stejná jako start_year.
  • display_days, display_months, display_years - nepovinný parametr typu boolen, defaultně nastavený na true, který určuje zda bude zobrazené políčko po řadě pro den, měsíc, rok.
  • month_format - nepovinný parametr, řetězcového typu, defaultně nastavený na '%B', který určuje formát jakým bude zobrazen měsíc
  • day_format - nepovinný parametr, řetězcového typu, s výchozí hodnotou '%02d', který určuje v jakém formátu bude den vložen do zobrazovací části výběru
  • day_value_format - nepovinný parametr, řetězcového typu, výchozí nastavení je '%d', určuje formát, v jakém budou dny vloženy do části value
  • month_value_format - nepovinný parametr, řetěczového typu, výchozí nastavení '%m', určuje formát, v jakém budou dny vloženy do části value
  • year_as_text - volitelný parametr, logického typu s defaultním nastavením na false, určující 
  • reverse_years - volitelný parametr, logického typu s výchozím nastavením na false, určující, zda-li budou roky v sestupném, nebo vzestupném pořadí
  • field_array - volitelný parametr řetězcového typu, určující jméno pole do jakého bude na straně PHP scriptu vrácen datum
  • day_size, month_size, year_size - volitelný parametr řetězcového typu, určující parametr size select boxu výběrů dne, měsíce a roku
  • all_extra, day_extra, month_extra, year_extra - volitelný parametr řetězcového typu, kterým se nastavují extra parametry výběru
  • field_order - volitelný parametr řetězcového typu, defaultně nastavený na 'MDY', který určuje pořadí select boxů
  • field_separator - volitelný parametr řetězcového typu, defaultně nastavený na '\n', který určuje oddělovač jednotlivých políček
  • day_empty, month_empty, year_empty - Nepovinný parametr řetězcového typu,  pokud je použit, bude defaultně zobrazen vložený text a v parametru value bude hodnota ' ' (mezera)

html_select_time

Funkce ekvivalentí předchozí, ale sloužící pro vytvoření select boxů pro výběr času. Počáteční nastavení předvybraného času může být provedeno v několika formátech. může se jednat o Unixový timestamp, nebo jako řetězec obsahující i Y-M-D. Je podporovýn formát YYYY-MM-DD, ale je správně rozkódován i datum s jednociferným číslem pro měsíc a den, Pokud jedna z hodnot Y-M-D není nastavena, nebude proveden předvýběr hodnoty.  Funkce nemá žádné povinné paramety, které jsou následující:
  • prefix - řetězec, určuje předponu jména
  • time - timestamp, který určuje přednastavení času ve výběru, pokud není předán z PHP scriptu je nastaven aktuální čas
  • display_seconds, display_minutes, display_hours, display_meridian - parametr logického typu, defaultně nastavený na true, který určuje, zda-li bude zobrazen výběr sekund, minut, hodin a meridianu (dopoledne, popoledne - AM/PM)
  • use_24_hours - logický typ, defaultně nastavený na true, určuje zda-li bude bude použit 24 hodinový formát, či nikoliv
  • second_interval, minute_interval - parametr číselného typu, která určuje krok v jakém budou ve výběru sekundy, nebo minuty
  • field_array - parametr řetězcového typu, který určuje jméno pole, do nějž budou vráceny hodnoty z formuláře
  • all_extra, second_extra, minute_extra, hour_extra, meridian_extra - přidává extra parametry,  do select/input boxu

Další důležité funkce

Smarty poskytují funkce pro vložení obrázku (html_image) a tabulky (html_table).

html_image

Funkce pro vložení obrázku do stránky.  Pokud nejsou zadány v šabloně výška a šířka, jsou tyto automaticky vypočítány při kompilování šablony. Pokud je použita tato funkce je k obrázku přistupováno při kažbém načítání šablony. Pokud nepoužíváte cacheování (bude probráno v příštím díle), je výhodnější nepoužívat tuto funkci a zadat tag pro vložení obrázku staticky. Při použití parametru href je tag pro vložení obrázku automaticky obalen odkazem (tag <a href="...">obrazek</a>. Cesta k obrázku může být zadána relativně, pokud tak není učiněno, je použita hodnota DOCUMENT_ROOT jako základ. Jestliže je použito zabezpečení, cesta musí vést mimo zabezpečený adresář. Parametry funkce jsou následující:
  • file - povinný parametr řetězcového typu, který určuje název vloženého adresáře včetně cesty
  • border - nepovinný parametr řetězcového typu, který určuje tloušťku rámečku kolem obrázku.
  • height, width - nepovinný parametr typu řetězec, určuje výšku a šířku obrázku, není-li tento parametr použit, je výška a šířka nastavena podle skutečné velikosti obrázku.
  • basedir - nepovinný parametr řetězcového typu, který určuje základní adresář cesty k obrázku.
  • alt - nepovinný parametr řetězcového typu, který určuje alternativní text k obrázku. I když není použit, je alt do značky vložen s hodnotou, která je prázdný řetězec.
  • href - nepovinný parametr řetězcového typu. Jestliže je použit, je obrázek použit jako odkaz na adresu obsaženou v tomto parametru.

html_table

Funkce pro vygenerování tabulky a její naplnění daty hodnotami ve vstupním poli. Parametry tr_attr a td_attr jsou používány cyklicky. Parametry funkce jsou následující:
  • loop - povinný parametr typu pole, který udává vstupní data pro vytvoření tabulky
  • cols - nepovinný parametr typu integer, defaultně nastavený na 3, který udává klik sloupců bude mít výsledná tabulka
  • table_attr - nepovinný parametr typu řetězec, defaultně nastavený na 'border="1"'. Doplňkové informace pro vytvoření tabulky, jedinné místo, kde lze určit styl tabulky.
  • tr_attr, td_attr - Nepovinný parametr typu řetězec, nebo pole určující parametry pro řádky, případně buňky, tabulky. Pokud je použito pole jsou jeho hodnoty používány cyklicky.
  • traipad - Nepovinný parametr řetězcového typu, který je defaultně nastaven na hodnotu '&nbsp;'. Určuje výplňovou hodnotu pro prázdné buňky tabulky
  • hdir, vdir - nepovinný parametr řetězcového typu, defautní nastavení je hdir="right" a vdir="down", určující směry, kterými bude plněna tabulka pro hdir jsou možné hodnoty right a left, pro vdir jsou povoleny hodnoty down a up.

mailto

Funkce pro automatizované vytváření odkazů na emailovou adresu se všemi možnými parametry tohoto odkazu. Samozřejmostí je možnost "schování" emailové adresy do hexadecimálního zápisu adresy, nebo do javascriptu. Parametry funkce jsou tyto:
  • address - povinný parametr (jediný), řetězcového typu, do kterého je vložena adreca hlavního adresáta e-mailu.
  • text - nepovinný parametr typu řetězec. Definuje text odkazu, není-li nastaven je zobrazen obsah parametru address
  • encode - parametr typu řetězec, mající jednu z hodnot none (defaultní), hex, javascript. Určuje, jak bude zakódována emailová adresa,
  • cc, bcc - řetězec, emailová adresa pro zaslání kopie a skryté kopie. Pokud je nutné odesílat kopie na více adres, jsou tyto adresy odděleny čárkou.
  • subject - řetězec, který definuje předmět mailu
  • newsgroups - řetězec, který definuje, na které newsgroups bude zpráva odeslána. Více hodnot se odděluje čárkou
  • followupto - řetězec,
  • extra - řetězec, přes který lze doplnit extra parametry k odkazu, jako například určení stylu.

cycle

Funkce funguje pro cyklické procházení hodnot, používá se například pro cyklické změny barev či stylů v buňkách, či řádcích tabulek.  Procházení několika různých polí tabulky je realizovatejné pomocí několika cyklů, přičemž každý z nich má unikátní jméno. Lze vynutit zakázání zobrazení některého z výstupů tabulky, kdy se nastaví parametr print='false'.  Parametry funkce jsou následující:
  • values - povinný parametr typu pole, nebo řetězec, který určuje hodnoty, které budou střídány
  • name - nepovinný parametr řetězcového typu, který určuje jméno cyklu pro možnost použití několika těchto cyklů, přečemž každý z nich musí mít unikátní jméno.
  • print - nepovinný parametr logického typu, který určuje, zda bude hodnota vrácená cyklem zobrazená či nikoliv.
  • advance - nepovinný parametr logického typu, který určuje, zda-li bude při příštím průchodu cyklem použita současná hodnota (advance="true"), či standardně další (advance="false")
  • delimiter - nepovinný parametr řetězcového typu, defaultně nastavený na ',' (čárka), který určuje, jaký oddělovač bude použit v řetězci values pro oddělení hodnot
  • assign - nepovinný parametr řetězcového typu, který určuje do jaké proměnné šablony bude předána hodnota z cycle místo jejího zobrazení.

counter

Counter je počítadlo pro zobrazení. Pamatuje si hodnotu poslední hodnotu iterace, lze určit směr a krokování cyklu. Lze použít několik počítadel, ale každé z nich musí mít unikátní pojmenování. Žádný parametr není povinný a pro tuto funkci jsou to tyto:
  • name - řetězcového typu, výchozí hodnota je 'default', určuje jméno cyklu, pokud je třeba použít několik cyklů, každý musí mít unikátní jméno.
  • start - celočíselného typu, výchozí hodnota je nastavena na '1', určuje počáteční hodnotu, použitou při první iteraci cyklu
  • skip - celočíselného typu, výchozí hodnota je '1', určuje krok každé iterace cyklu
  • direction - řětězcového typu, defaultně nastavený na 'up', určuje směr iterování cyklu. Možné hodnoty jsou 'up' a 'down'
  • print - logického typu, defaultně 'true', který určuje, zda-li bude hodnota cyklu zobrazována, či nikoliv
  • assign - řetězcového typu, který určuje proměnnou šablony, do které bude přiřazena hodnota cyklu místo jejího výstupu ke zobrazení.

math

Funkce math slouží ke zobrazení hodnoty výpočtu, případně k jejímu přiřazení do proměnné šablony k dalšímu použití. Podporované funkce jsou +, -, /, *,  abs, ceil, cos,  exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt,  srans a tan, které se používají stejným způsobem, jako jejich ekvivalenty v PHP.  Použití funkce math je mnohem náročnější, než zpracování výpočtu na straně PHP kódu a posléze pouze zobrazení hodnoty v šabloně! Parametry funkce jsou tyto:
  • equation - řetězec bez výchozí hodnoty, popisuje rovnici, nebo výpočet z proměnných
  • format - řetězec bez výchozí hodnoty, určuje formátování výstupu stejným způsobem, jak je to realizováno v PHP funkci sprintf
  • assign - řetězec bez výchozí hodnoty, který učuje, do jaké proměnné bude přiřazen výstup výpočtu. Pokud není parametr použit je výsledek výpočtu zobrazen do stránky, je-li nastaven, bude do této proměnné přiřazen k dalšímu zpracování.
  • [var ...] - proměnné vstupující do výpočtu. Mohou být přiřazeny z proměnných šablony, nebo konstanty.

Závěr

V tomto díle byly představeny funkce, které jsou použitelné při tvorbě šablon. Balíček s příklady za poslední 2 díly je ke stažení zde. Příští díl bude zaměřen na práci s cache, konfigurační soubory šablon a možnosti ladění, poté budou díly zaměřené na dosud nevysvětlené metody Smarty šablon na straně PHP scriptu,  tipy, triky, rozšířené funkce a možnosti použití hotových, případně tvorby vlastních pliginů.

Verze pro tisk

pridej.cz

 

DISKUZE

Nejsou žádné diskuzní příspěvky u dané položky.



Příspívat do diskuze mohou pouze registrovaní uživatelé.
> Vyhledávání software
> Vyhledávání článků

28.11.2018 23:56 /František Kučera
Prosincový sraz spolku OpenAlt se koná ve středu 5.12.2018 od 16:00 na adrese Zikova 1903/4, Praha 6. Tentokrát navštívíme organizaci CESNET. Na programu jsou dvě přednášky: Distribuované úložiště Ceph (Michal Strnad) a Plně šifrovaný disk na moderním systému (Ondřej Caletka). Následně se přesuneme do některé z nedalekých restaurací, kde budeme pokračovat v diskusi.
Komentářů: 1

12.11.2018 21:28 /Redakce Linuxsoft.cz
22. listopadu 2018 se koná v Praze na Karlově náměstí již pátý ročník konference s tématem Datová centra pro business, která nabídne odpovědi na aktuální a často řešené otázky: Jaké jsou aktuální trendy v oblasti datových center a jak je optimálně využít pro vlastní prospěch? Jak si zajistit odpovídající služby datových center? Podle jakých kritérií vybírat dodavatele služeb? Jak volit vhodné součásti infrastruktury při budování či rozšiřování vlastního datového centra? Jak efektivně datové centrum spravovat? Jak co nejlépe eliminovat možná rizika? apod. Příznivci LinuxSoftu mohou při registraci uplatnit kód LIN350, který jim přinese zvýhodněné vstupné s 50% slevou.
Přidat komentář

6.11.2018 2:04 /František Kučera
Říjnový pražský sraz spolku OpenAlt se koná v listopadu – již tento čtvrtek – 8. 11. 2018 od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5). Tentokrát bez oficiální přednášky, ale zato s dobrým jídlem a pivem – volná diskuse na téma umění a technologie, IoT, CNC, svobodný software, hardware a další hračky.
Přidat komentář

4.10.2018 21:30 /Ondřej Čečák
LinuxDays 2018 již tento víkend, registrace je otevřená.
Přidat komentář

18.9.2018 23:30 /František Kučera
Zářijový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 20. 9. 2018 od 18:00 v Radegastovně Perón (Stroupežnického 20, Praha 5). Tentokrát bez oficiální přednášky, ale zato s dobrým jídlem a pivem – volná diskuse na téma IoT, CNC, svobodný software, hardware a další hračky.
Přidat komentář

9.9.2018 14:15 /Redakce Linuxsoft.cz
20.9.2018 proběhne v pražském Kongresovém centru Vavruška konference Mobilní řešení pro business. Návštěvníci si vyslechnou mimo jiné přednášky na témata: Nejdůležitější aktuální trendy v oblasti mobilních technologií, správa a zabezpečení mobilních zařízení ve firmách, jak mobilně přistupovat k informačnímu systému firmy, kdy se vyplatí používat odolná mobilní zařízení nebo jak zabezpečit mobilní komunikaci.
Přidat komentář

12.8.2018 16:58 /František Kučera
Srpnový pražský sraz spolku OpenAlt se koná ve čtvrtek – 16. 8. 2018 od 19:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát jsou tématem srazu databáze prezentaci svého projektu si pro nás připravil Standa Dzik. Dále bude prostor, abychom probrali nápady na využití IoT a sítě The Things Network, případně další témata.
Přidat komentář

16.7.2018 1:05 /František Kučera
Červencový pražský sraz spolku OpenAlt se koná již tento čtvrtek – 19. 7. 2018 od 18:00 v Kavárně Ideál (Sázavská 30, Praha), kde máme rezervovaný salonek. Tentokrát bude přednáška na téma: automatizační nástroj Ansible, kterou si připravil Martin Vicián.
Přidat komentář

   Více ...   Přidat zprávičku

> Poslední diskuze

31.7.2023 14:13 / Linda Graham
iPhone Services

30.11.2022 9:32 / Kyle McDermott
Hosting download unavailable

13.12.2018 10:57 / Jan Mareš
Re: zavináč

2.12.2018 23:56 / František Kučera
Sraz

5.10.2018 17:12 / Jakub Kuljovsky
Re: Jaký kurz a software by jste doporučili pro začínajcího kodéra?

Více ...

ISSN 1801-3805 | Provozovatel: Pavel Kysilka, IČ: 72868490 (2003-2024) | mail at linuxsoft dot cz | Design: www.megadesign.cz | Textová verze