Smarty Template Engine 26.díl - Funkce XI.
Uživatelské funkce
{html_select_time}
Funkce velmi podobná {html_select_date}. Jak vyplývá z názvu, tato však slouží k zobrazení rolovátek/selectů pro čas. Zobrazuje tedy: hodiny, minuty a sekundy, každé ve svém vlastní selectu.Atribut času může mít mnoho podob, ve skrze vychází z PHP funkce strtotime, základní časové razítko odpovídá zápisu: YYYYMMDDHHMMSS.
- prefix - název selectu, za který se přidá konkrétní typ selectu (time, hour, second), defaultně: Time_ (nepovinný)
- time – časové razítko, defaultně: current time (nepovinný)
- display_hours - zda zobrazovat select pro Hodiny, defaultně: true(nepovinný)
- display_minutes - zda zobrazovat select pro Minuty, defaultně: true(nepovinný)
- display_seconds - zda zobrazovat select pro sekundy, defaultně: true(nepovinný)
- display_meridian - zda zobrazovat anglické rozdělení času, tedy am/pm, defaultně: true (nepovinný)
- use_24_hours - zda použít, či nepoužít 24-hodinový formát času, defaultně: true (nepovinný)
- minute_interval - celé kladné číslo, nastavující po jakém kroku se mají zobrazovat minuty , defaultně: 1(nepovinný)
- second_interval - celé kladné číslo, nastavující po jakém kroku se mají zobrazovat sekundy, defaultně: 1(nepovinný)
- field_array - v případě, že vyplníme, hodnota value se uloží do pole, kde hodnota tohoto parametru bude zobrazovat name takto: name[minutes] atd., defaultně: prázdný(nepovinný)
- all_extra – všem selectům přiřadí námi nově definovaný parametr, používý se především pro definováni CSS stylu, či classu, defaultně: null(nepovinný)
- hour_extra – nastavuje takový speciální parametr právě hodinovému rolovátku, defaultně: null (nepovinný)
- minute_extra – nastavuje takovýto speciální parametr právě minutovému rolovátku, defaultně: null (nepovinný)
- second_extra - nastavuje takovýto speciální parametr právě sekundovému rolovátku, defaultně: null (nepovinný)
- - nastavuje takovýto speciální parametr právě am/pm rolovátku , defaultně: null (nepovinný)
index.tpl
{include file='./hlavicka.tpl' hlavicka='Smarty Template Engine'}
<p>
Vybereme si čas:
{html_select_time}
</p>
{include file='./paticka.tpl'}
Základní volání funkce je tedy takovéto. V takovém případě se dočkáme tři selectů.
Pro hodiny 00-23, pro minuty 00-59 a pro sekundy 00-59. Stejně tak jsou nastaveny hodnoty parametrů value. Jména selectů jsou pak v Time_Hour, Time_Minute a Time_Second.
Výstup si v následujícím příkladě mírně upravíme k obrazu svému:
index.tpl
{include file='./hlavicka.tpl' hlavicka='Smarty Template Engine'}
<p>
Vybereme si čas:
{html_select_time minute_interval=10 all_extra='style=font-weight:bold;width:80px;' display_meridian=true use_24_hours=false}
</p>
{include file='./paticka.tpl'}
- V následujícím příkladě si tedy nastavíme interval volby minut na 10.
- Pomocí parametru „all_extra“ nastavíme pro selecty tučné písmo a pevnou šířku 80px.
- Pomocí display_meridian pak povolímě vypisování rolovátka pro AM/PM a naopak pomocí use_24_hours zakážeme vypisování 24 hodinového formátu času
{mailto}
Automaticky vytvoří odkaz s parametrem href=mailto... a jeho enkodóvání. Krom ušetřeného času pro tvorbu takového formuláře funkce vytváří hůře čitelnou alternativu pro spamovací roboty, jež na stránkách získávají svá data.- adress - emailová adresa, defaultně: (povinný)
- text – text, který se zobrazí na výpisu stránky, defaultně:hodnota parametru adress (nepovinný)
- encode – jakým způsobem se má kódovat výsledek funkce. Na volbu máme z možností:none, hex, javascript, javascript_charcode , defaultně: none(nepovinný)
- cc – emailová adresa, jíž bude zaslána kopie (v případě potřeby zadat více adres, se oddělují čárkou) , defaultně: (nepovinný)
- bcc – emailová adresa, jíž bude zaslána skrytá kopie (v případě potřeby zadat více adres, se oddělují čárkou) , defaultně: (nepovinný)
- subject - předmět emailu, defaultně: (nepovinný)
- newsgroups - ,skupina, jíž email zaslat (v případě potřeby zadat více adres, se oddělují čárkou), defaultně: (nepovinný)
- followupto - emailový adresa, jíž bude email přeposlán (v případě potřeby zadat více adres, se oddělují čárkou), defaultně: (nepovinný)
- extra – možnost přidat náš vlastní parametr. Používá se především k nadefinování vlastních CSS stylů , defaultně: (nepovinný)
index.tpl
{include file='./hlavicka.tpl' hlavicka='Smarty Template Engine'}
<p>
Emaily:
{mailto address="me@example.com" encode="javascript" subject='Smarty Template Engine'}
</p>
{include file='./paticka.tpl'}
Zkuste si měnit parametr encode dle návodu a sledovat ve výsledném HTML kódu způsob aplikace funkce. Určitě bych doporučil některou z encode funkcí použít!!!
2024 ©