Mura CMS Template Variables

Quando crei i tuoi temi, vorrai inserire contenuti dinamici dal tuo sito Mura per visualizzare meta-informazioni, titoli, corpo e così via. Per le variabili a livello di pagina, è necessario accedere a soddisfare portata per quella pagina. Questo è fatto usando $ .Content ( 'variableName'). Ad esempio, se si desidera la meta descrizione della pagina, si accederà in questo modo:

# $. Contenuti ( 'metaDesc') #

Il tag completo nel tuo html_head.cfm sarebbe simile a questo:

Per informazioni sull'intero sito, come ad esempio il nome del sito, si utilizzerà il SiteConfig scopo:

# $. SiteConfig ( 'nomeVariabile') #

Ad esempio, se desideri visualizzare il titolo della tua pagina e il nome del sito nel tag del titolo del tuo modello, procedi come segue:

Mancia: HTMLEditFormat () sostituisce caratteri speciali (<, >, &, ") in una stringa con i relativi equivalenti con escape HTML. Ad esempio, sostituirebbe < con <

Dumping delle variabili disponibili

Se desideri visualizzare tutti i valori disponibili sia per il contenuto che per il tuo sito, inserisci il codice seguente in uno qualsiasi dei modelli di pagina ed esegui la pagina:

Variabili di contenuto

Variabili del sito

Ogni elemento nella colonna di sinistra può essere passato nel rispettivo ambito. Per esempio:

# $. Contenuti ( 'MetaKeywords') #

e

# $. SiteConfig ( 'dominio') #

Visualizzazione di valori condizionali

A volte potresti voler emettere qualche markup solo se è stato inserito un valore nel campo. Ad esempio, se volessi pubblicare l'autore della pagina, potresti fare qualcosa del genere:

Scritto da: # $. Contenuti ( 'crediti') #

Tuttavia, se quella particolare pagina non avesse un autore inserito nel campo "crediti", la tua pagina avrebbe solo visualizzato il Scritto da:

Per evitare questo, possiamo usare un po 'di logica CFML:

 Scritto da: # $. Contenuti ( 'crediti') # 

Il len (abbreviazione di 'length') la funzione in CFML determina la lunghezza di una variabile. Se vero (cioè c'è in realtà un valore nel campo), andrà avanti e mostrerà il tuo markup. Altrimenti, salterà semplicemente su di esso e non produrrà nulla.

Nav principale

Mura ha una funzione integrata per prendere automaticamente tutte le pagine di primo livello nel tuo gestore del sito e visualizzarle in una lista di navigazione:

# $. DspPrimaryNav () #

Il $ .DspPrimaryNav () la funzione verrà visualizzata nell'ordine impostato nel gestore del sito. Articoli a cui è impostato il display No o la navigazione impostata su No non uscirà nel tuo Nav principale. 

Puoi passare diversi argomenti in questa funzione per controllare vari aspetti del tuo output di navigazione:

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

Un elenco completo di questi argomenti e delle loro descrizioni può essere trovato nei documenti Mura.

L'output di default della Navigazione principale è un semplice elenco non ordinato (

):


Tuttavia, aggiungendo del markup addizionale attorno al nav e regolando alcuni degli argomenti, è possibile ridisegnarlo rapidamente in qualsiasi tema CSS:



Cacheing e prestazioni

Si consiglia di avvolgere il codice di navigazione principale in tag per aumentare le prestazioni sul tuo sito. Il cf_CacheOMatic il tag può essere utilizzato per memorizzare nella cache elementi meno frequentemente aggiornati che hanno un sovraccarico del server delle applicazioni. È usato in congiunzione con il caching opzione sotto Site Config> Modifica sito. Il cf_CacheOMatic il tag non memorizzerà alcunché nella cache, a meno che non venga attivata la memorizzazione nella cache del sito. Il prefisso dell'attributo "chiave" (in questo caso, dspPrimaryNav) può essere usato per dare contesto alla variabile univoca, # $. Contenuti ( 'ContentID') #, creato per l'elemento memorizzato nella cache.

Il tuo Primay Nav completo dovrebbe assomigliare a questo:

 # $. dspPrimaryNav (...) # 

Titolo della pagina, corpo e immagine primaria

Per stampare il titolo della pagina, il corpo e l'immagine associata, si vorrà usare il $ .DspBody () tag e specifica questi elementi:

# $. dspBody (body = $. content ('body'), pageTitle = $. content ('title'), showMetaImage = 1) #

Questo produrrà automaticamente questi elementi insieme sulla pagina renderizzata. Se devi separare il titolo della pagina o rimuoverlo completamente, puoi farlo anche tu:

#HTMLEditFormat ($. Contenuti ( 'title')) #
 # $. dspBody (body = $. content ('body'), pageTitle = ", showMetaImage = 1) #

$ .DspBody () è una funzione speciale di Mura che alimenta altre funzionalità come pagine protette da password, output di cartelle ecc. Si consiglia di utilizzare $ .DspBody () per emettere il corpo nei modelli per garantire che questi tipi di funzionalità continuino a funzionare correttamente. 

Briciole di pane

Infine, puoi utilizzare la funzione incorporata di Mura per l'output dei breadcrumb della pagina in questo modo:

# $. DspCrumbListLinks () #

Come puoi vedere, l'utilizzo delle variabili del modello è un ottimo modo per includere rapidamente i contenuti dinamici nei modelli del tema.

Web design