target

Funkce pro získání ortogonálního odkazu z assetu. (Ve starších verzích sestavuje URL z assetu typu Odkaz.)

Od verze 3.3:

PageIdentification target ( 
    Asset source-asset [ ,
    String link-name [ ,
    Asset site [ ,
    String language [ ,
    String format [ ,
    Integer segment ] ] ] ] ]
)
source-asset
Asset, mezi jehož odkazy se hledá.
link-name
Název hledaného odkazu. Hodnota je nepovinná, defaultní název je "target".
site
language
format
segment
Použijí se dvěma způsoby:
  • Při výběru správného odkazu – site, language a segment se použijí při ověřování podmínek platnosti odkazu místo aktuálních hodnot.
  • K doplnění výsledného odkazu v případě, že je nemá odkaz sám nastavené. (Tedy pozor: hodnoty zadané takto jako argumenty funkce mají pro sestavování odkazu nižší prioritu, než vlastní položky ortogonálního odkazu.)

Ve starších verzích:

String target ( 
    Asset link-data [ ,
    String params [ ,
    String anchor [ ,
    Boolean abs [ ,
    String format [ ,
    String language ] ] ] ] ]
)
link-data
Asset typu Odkaz, ze kterého se má vytvořit URL.
params
Parametry URL.
anchor
Kotva URL.
abs
Zda má být generována absolutní URL.
format
Cílový formát.
language
Cílový jazyk.

Rozdíly mezi verzemi

  • Funkce původně pracovala se speciálním typem assetu, který obsahoval jen data odkazu. Od verze 3.3 vrací odkazy připojené k jakýmkoli assetům.
  • Ještě v prvních subverzích verze 3.3 funkce vracela řetězcovou reprezentaci URL. Nyní je to standardní PageIdentification stejně jako u funkce link.
  • V prvních subverzích verze 3.3 byl argument link-name povinný.

Motivace

Funkce má sloužit k získání odkazu, který je už připravený jako součást assetového obsahu. (Takovými odkazy jsou až do verze 3.2 samostatné assety, počínaje verzí 3.3 jsou to ortogonální odkazy připojitelné v principu k libovolnému assetu.)

Toto je podstata rozdílu mezi touto funkcí a funkcí link, která slouží k sestavení odkazu až v šabloně z jednotlivých složek.

Funkce je mimo jiné cílená na snadnou práci s odkazem assetu typu Upoutávka (dříve "Button"), který má v editačním rozhraní podporu pro transparentní vytváření ortogonálního odkazu "target".

Podrobnější popis fungování

Poznámky se týkají novější verze funkce.

Ortogonální odkazy assetu jsou uspořádané do seznamu pravidel. Každé pravidlo má podmínku (kdy je odkaz možné použít) a vlastní data odkazu. Při zpracování se vybere první pravidlo, jehož podmínka je splněna, a sestaví se odkaz z příslušných dat.

Podmínku tvoří: název odkazu, zdrojová prezentace, jazyky a segmenty. Při výběru odkazu se kontroluje následující:

  • Název odkazu se musí shodovat s názvem uvedeným při volání funkce; pokud není uveden žádný, berou se jen odkazy s názvem target.
  • Pokud je platnost odkazu omezená na nějakou prezentaci, musí být totožná s prezentací site zadanou při volání funkce. Pokud argument nebyl zadán, musí být prezentace obsažená v podmínkách totožná s aktuální prezentací.
  • Pokud je platnost odkazu omezená na nějaké jazyky, musí mezi nimi být obsažený jazyk language zadaný při volání funkce. Pokud argument nebyl zadán, musí mezi nimi být obsažen aktuální jazyk..
  • Pokud je platnost odkazu omezená na nějaké segmenty, musí mezi nimi být obsažený segment segment zadaný při volání funkce. Pokud argument nebyl zadán, musí mezi nimi být obsažen aktuální segment.
Pro vložení příspěvku do diskuse se přihlašte.