Chapter 6. Tagy pro tvorbu formulářů

  1. Zobrazení komentářů

    Tak, jako lze ovlivnit vzhled článku, je toto možné zařídit i pro vzhled komentářů k článům. K tomu slouží tagy comment.

    1. <txp:comment_name />

      Tímto tagem zobrazíte jméno autora komentáře.

    2. <txp:comment_permlink></txp:comment_permlink>

      Permanentní odkaz na komentář. Do kontejneru zadáme název odkazu, defaultně je to "#".

    3. <txp:comment_time />

      Datum vytvoření komentáře. Formát data odpovídá formátu nastaveném v sekci Správa->Nastavení serveru v administraci RS.

    4. <txp:message />

      Vlastní text zprávy.

  2. Formulář pro komentáře

    Pro tvorbu formuláře zadání komentářů poskytuje TextPattern několik užitečných tagů:

    1. <txp:comment_email_input />

      Tag pro zadání emailové adresy.

    2. <txp:comment_message_input />

      Tag pro zadání textu zprávy.

    3. <txp:comment_name_input />

      Tag pro zadání jména autora komentáře

    4. <txp:comment_web_input />

      Tag pro zadání internetové adresy stránek autora komentáře

    5. <txp:comment_remember />

      Tento tag zobrazí zaškrtávací pole pro "zapamatování" komentáře pro příští použití.

    6. <txp:comment_preview />

      Zobrazí náhled komentáře před jeho odesláním.

    7. <txp:comment_submit />

      Odešle komentář do systému TextPattern.

    Pro přidání textu před výše uvedené vstupní pole můžete použít TXP obecný tag <txp:text /> s atributem item, který zajistí výpis textu uvedeného v atribitu item.

    item - text k popisu vstupního pole
  3. Odkazy

    Pokud chceme použít výpis odkazů pomocí stránkového tagu <txp:linklist /> , můžeme použít následující tagy pro úpravu vzhledu výpisu:

    1. <txp:link />

      Je to běžný XHTML odkaz s atributem title a odkazovanou adresou, obvykle URL.

    2. <txp:link_description /> tag

      Popis odkazu.

    3. <txp:link_text />

      Pravděpodobně nepodporovaný tag.

    4. <txp:linkdesctitle />

      Odkaz s popisem v atributu title,

  4. Vyhledávání na stránkách

    Následující tagy ovlivňují zobrazení výsledku vyhledávání v šabloně "search_results". Pokud není šablona "search_results" definována, použije TextPattern defaultní.

    1. <txp:search_result_date />

      Zobrazí datum zadání vyhledaných příspěvků.

    2. <txp:search_result_excerpt />

      Zobrazí malou ukázku textu anotací vyhledaných příspěvků, hledané slovo je zdorazněno XHTML tagem strong.

    3. <txp:search_result_title />

      Zobrazí nadpisy vyhledaných příspěvků.

    4. <txp:search_result_url />

      Zobrazí URL vyhledaných příspěvků.

  5. Obrázky

    1. <txp:image />

      Tento tag zobrazí obrázek, který je definovaný jeho id.

    Tento tag přijímá také XHTML atributy style a align. Upozornění: [V XHTML 1.0 strict nejsou tyto tagy povoleny a je třeba použít CSS.]

  6. Tagy pro formuláře článků

    Následující skupina tagů je určena pro řízení vzhledu článku uvnitř šablony článku.

    1. <txp:title />

      Zobrazí název článku

    2. <txp:permlink></txp:permlink>

      Zobrazí trvalý odkaz na článek, mezi tagy lze umístit text odkazu, nebo další TXP tag.

    3. <txp:posted />

      Zobrazí datum vydání článku. Formát data odpovídá formátu nastavenému v sekci Správa->Nastavení serveru v administraci RS.

    4. <txp:body />

      Zobarzí text článku.

    5. <txp:author />

      Zobrazí jméno autora článku.

    6. <txp:category1 />

      Zobrazí název kategorie 1 příslušnou k článku.

    7. <txp:category2 />

      Zobrazí název kategorie 2 příslušnou k článku.

    8. <txp:section />

      Zobrazí název sekce příslušné k článku.

    9. <txp:excerpt />

      Pokud existuje, zobrazí anotaci článku.

    10. <txp:article_id />

      Zobrazí id článku. Id je jednoznačné číslo článku přiřazené systémem TextPattern v databázi.

    11. <txp:article_image />

      Zobrazí obrázek asociovaný k článku. Obrázek může být definován pomocí id, pokud je nahraný do systému TextPatternu, nebo pomocí URL. V obou případech je možné (a dobré) doplnit atribut alt s alternatvním textem.

    12. <txp:comments_count />

      Zobrazí počet komentářů k článku.

    13. <txp:meta_keywords />

      Tento tag slouží pro tvorbu XHTML tagu meta. Pro větší bezpečnost použití se jej doporučuje pozužít uvnitř podmíněného tagu <txp:if_individual_article>...</txp:if_individual_article> .

    14. <txp:meta_author />

      Tento tag slouží pro tvorbu XHTML tagu meta. Pro větší bezpečnost použití se jej doporučuje pozužít uvnitř podmíněného tagu <txp:if_individual_article>...</txp:if_individual_article> .

    15. <txp:comments_invite />

      Tento tag neslouží pouze k jednoduchému výpisu komentářů. Způsob jeho chování je popsán dále:

      • Pokud jsou u článku komentáře zakázané, nic se nezobrazuje.

      • Pokud jsou komentáře povolené:

        • Na stránce výpisu článků funguje jako odkaz na komentáře ke každému článku

        • Na stránce výpisu jednotlivého článku se chová v závislosti na nastavení funkce "Vypnout po" v sekci Správa->Nastavení serveru v administraci RS.

          • Pokud doba k zadávání komentářů vypršela, zobrazí výpis všech komentářů do doby expirace.

          • Pokud expirace nevypršela, zobrazí navíc formulář pro zadání nového komentáře.