Mura CMS Variabile de șablon

Când construiți temele, veți dori să aduceți conținut dinamic de pe site-ul dvs. Mura pentru a afișa informații despre meta, titluri, corp și așa mai departe. Pentru variabilele de nivel de pagină, trebuie să accesați conţinut pentru această pagină. Acest lucru se face prin utilizarea $ .Content ( 'nume_variabila'). De exemplu, dacă doriți descrierea meta a paginii, aceasta va fi accesată ca atare:

# $. Conținutul ( 'metaDesc') #

Eticheta completă în html_head.cfm ar arata astfel:

Pentru informații despre întregul site, cum ar fi numele site-ului, ați folosi siteConfig domeniul de aplicare:

# $. SiteConfig ( 'nume_variabila') #

De exemplu, dacă doriți să afișați titlul paginii, precum și numele site-ului în eticheta de titlu a șablonului dvs., ați face următoarele:

#HTMLEditFormat ($ content ('HTMLTitle') # - #HTMLEditFormat ($ siteConfig ('site'))

Bacsis: HTMLEditFormat () înlocuiește caracterele speciale (<, >, &, ") într-un șir cu echivalentele lor scoase din HTML. De exemplu, ar înlocui < cu <

Variabile disponibile pentru dumping

Dacă doriți să vedeți toate valorile disponibile atât pentru conținut, cât și pentru site-ul dvs., plasați următorul cod în oricare dintre șabloanele de pagină și executați pagina:

Variabilele de conținut

Variabilele site-ului

Fiecare element din coloana din stânga poate fi trecut în domeniul lor de aplicare. De exemplu:

# $. Conținutul ( 'metaKeywords') #

și

# $. SiteConfig ( 'domeniu') #

Afișarea condițiilor în mod condiționat

Uneori este posibil să doriți să scoateți un marcaj numai dacă o valoare a fost introdusă în câmp. De exemplu, dacă doriți să ieșiți autorul paginii, s-ar putea să faceți ceva de genul:

Scris de: # $. Conținutul ( 'credite') #

Cu toate acestea, în cazul în care acea pagină nu avea un autor introdus în câmpul "credite", pagina dvs. ar face doar Scris de:

Pentru a evita acest lucru, putem folosi un pic de logica CFML:

 Scris de: # $. Conținutul ( 'credite') # 

 Len (scurtă pentru lungimea) funcție în CFML determină lungimea unei variabile. Dacă Adevărat (adică există, de fapt, o valoare în domeniu), aceasta va merge mai departe și va scoate marcajul. În caz contrar, va trece peste el cu totul și nu scoate nimic.

Primary Nav

Mura are o funcție construită pentru a prelua automat toate paginile de nivel superior din managerul site-ului dvs. și a le afișa într-o listă de navigare:

# $. DspPrimaryNav () #

$ .DspPrimaryNav () funcția va fi afișată în ordinea în care ați configurat în managerul de site-uri. Articole la care afișajul este setat la Nu sau setul de navigare la Nu nu va fi transmis în Primary Nav. 

Puteți trece mai multe argumente în această funcție pentru a controla diferite aspecte ale ieșirii dvs. de navigare:

# $ dspPrimaryNav (viewDepth = 1,, niciodată ", closeFolders = false, showCurrentChildrenOnly = false, liHasKidsClass =", liHasKidsAttributes = ", liCurrentClass =", liCurrentAttributes = ", liHasKidsNestedClass =", aHasKidsClass = "aHasKidsAttributes =", aCurrentClass = ", aCurrentAttributes =", ulNestedClass = ", ulNestedAttributes =", aNotCurrentClass = ", siteid = $. eveniment (" siteid "

O listă completă a acestor argumente și descrierile lor poate fi găsită în documentele Mura.

Efectul implicit al Navigării primare este o listă simplă neordonată (

    ):

    Cu toate acestea, prin adăugarea unor marcări suplimentare în jurul navigației și ajustarea unor argumente, ați putea să repetați rapid acest lucru în orice temă CSS:

    Cache & Performance

    Este recomandat să înfășurați codul de navigare primar în pentru a crește performanța pe site-ul dvs. cf_CacheOMatic tag-ul poate fi folosit pentru a cache-uri mai puțin actualizate de elemente care au un server de aplicații mai mare overhead. Acesta este utilizat împreună cu Caching opțiune sub Site Config> Editați site-ul. cf_CacheOMatic tag-ul nu va cache nimic, cu excepția cazului în care caching-ul site-ului este activat. Prefixul atributului "cheie" (în acest caz, dspPrimaryNav) poate fi folosit pentru a da contextul variabilei unice, # $. Conținutul ( 'contentId') #, create pentru elementul stocat în cache.

    Primul dvs. Primay Nav ar arata cam asa:

     # $. dspPrimaryNav (...) # 

    Titlul paginii, Corpul și Imaginea primară

    Pentru a scoate titlul paginii, corpul și imaginea asociată, veți dori să utilizați $ .DspBody () și specificați aceste elemente:

    # $ dspBody (corp = $. conținut ('body'), pageTitle = $. conținut ('title'), showMetaImage = 1) #

    Aceasta va scoate automat aceste elemente împreună pe pagina redată. Dacă trebuie să separați titlul paginii sau să o eliminați complet, puteți face acest lucru și:

    #HTMLEditFormat ($. Conținutul ( 'titlu')) #

    # $ dspBody (corp = $. conținut ('body'), pageTitle = ", showMetaImage = 1) #

    $ .DspBody () este o funcție specială în Mura care permite alte funcții cum ar fi pagini protejate prin parolă, ieșire de foldere etc. Se recomandă să le utilizați $ .DspBody () pentru a scoate caroseria din șabloane pentru a vă asigura că aceste tipuri de funcționalități vor continua să funcționeze corect. 

    Firimituri de pâine

    În sfârșit, puteți utiliza funcția construită a lui Mura pentru a afișa pescuitul paginii astfel:

    # $. DspCrumbListLinks () #

    După cum puteți vedea, utilizarea variabilelor șablonului este o modalitate excelentă de a include rapid conținutul dinamic în șabloanele tematice.