Mura CMS Vorlagenvariablen

Beim Erstellen Ihrer Themen sollten Sie dynamische Inhalte von Ihrer Mura-Site einladen, um Metainformationen, Titel, Text usw. anzuzeigen. Bei Variablen auf Seitenebene müssen Sie auf die Inhalt Umfang für diese Seite. Dies geschieht mit $ .content ('Variablenname'). Wenn Sie beispielsweise die Metabeschreibung der Seite wünschen, wird auf diese Seite wie folgt zugegriffen:

# $. content ('metaDesc') #

Der vollständige Tag in Ihrem html_head.cfm würde so aussehen:

Für Informationen über die gesamte Site, z. B. den Site-Namen, verwenden Sie die siteConfig Umfang:

# $. siteConfig ('variableName') #

Wenn Sie beispielsweise den Seitentitel sowie den Site-Namen im Titel-Tag Ihrer Vorlage anzeigen möchten, führen Sie folgende Schritte aus:

Spitze: HTMLEditFormat () ersetzt Sonderzeichen (<, >, &, ") in einer Zeichenfolge mit ihren HTML-Entsprechungen. Zum Beispiel würde es ersetzen < mit <

Dumping der verfügbaren Variablen

Wenn Sie alle verfügbaren Werte sowohl für den Inhalt als auch für Ihre Website anzeigen möchten, platzieren Sie den folgenden Code in eine Ihrer Seitenvorlagen und führen Sie die Seite aus:

Inhaltsvariablen

Standortvariablen

Jeder Eintrag in der linken Spalte kann in den jeweiligen Bereich übernommen werden. Zum Beispiel:

# $. content ('metaKeywords') #

und

# $. siteConfig ('Domäne') #

Werte bedingt anzeigen

Manchmal möchten Sie möglicherweise nur dann Markierungen ausgeben, wenn ein Wert in das Feld eingegeben wurde. Wenn Sie beispielsweise den Autor der Seite ausgeben möchten, können Sie etwa Folgendes tun:

Geschrieben von: # $. content ('credits') #

Wenn für diese Seite jedoch kein Autor in das Feld "Credits" eingegeben wurde, wird auf Ihrer Seite nur das gerendert Geschrieben von:

Um dies zu vermeiden, können wir ein wenig CFML-Logik verwenden:

 Geschrieben von: # $. content ('credits') # 

Das len (kurz für 'length') Die Funktion in CFML bestimmt die Länge einer Variablen. Ob wahr (d. h. es gibt tatsächlich einen Wert in dem Feld), wird der Markup ausgegeben. Andernfalls wird es einfach ganz übersprungen und nichts ausgegeben.

Primärnavigation

Mura verfügt über eine integrierte Funktion, mit der alle Seiten der obersten Ebene Ihres Site-Managers automatisch in einer Navigationsliste angezeigt werden:

# $. dspPrimaryNav () #

Das $ .dspPrimaryNav () Die Funktion wird in der Reihenfolge angezeigt, die Sie in Ihrem Site Manager eingerichtet haben. Elemente, für die die Anzeige festgelegt wurde Nein oder die Navigation auf Nein wird nicht in Ihrem primären Navigationsgerät ausgegeben. 

Sie können mehrere Argumente an diese Funktion übergeben, um verschiedene Aspekte Ihrer Navigationsausgabe zu steuern:

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

Eine vollständige Liste dieser Argumente und ihrer Beschreibungen finden Sie in den Mura-Dokumenten.

Die Standardausgabe der Primärnavigation ist eine einfache ungeordnete Liste (

):


Wenn Sie jedoch zusätzliche Markierungen um das Navi hinzufügen und einige der Argumente anpassen, können Sie dies schnell in jedes CSS-Design einfügen:



Cache & Leistung

Es wird empfohlen, dass Sie Ihren primären Navigationscode in das Feld einschließen Tag zur Steigerung der Leistung auf Ihrer Website. Das cf_CacheOMatic Tag kann verwendet werden, um seltener aktualisierte Elemente mit einem größeren Anwendungsserver-Overhead zwischenzuspeichern. Es wird in Verbindung mit der verwendet Caching Option unter Site Config> Site bearbeiten. Das cf_CacheOMatic Das Tag wird nichts zwischenspeichern, es sei denn, die Zwischenspeicherung der Site ist aktiviert. Das Präfix "Schlüssel" (in diesem Fall), dspPrimaryNav) kann verwendet werden, um der eindeutigen Variablen einen Kontext zu geben, # $. content ('contentid') #, für das zwischengespeicherte Element erstellt.

Ihr vollständiges Primay Nav würde in etwa so aussehen:

 # $. dspPrimaryNav (…) # 

Seitentitel, Körper und Primärbild

Um den Seitentitel, den Hauptteil und das zugehörige Bild auszugeben, möchten Sie das verwenden $ .dspBody () tag und spezifizieren Sie diese Elemente:

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

Dadurch werden diese Elemente automatisch zusammen auf der gerenderten Seite ausgegeben. Wenn Sie den Seitentitel trennen oder vollständig entfernen müssen, können Sie dies auch tun:

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

$ .dspBody () ist eine spezielle Funktion in Mura, die andere Funktionen wie kennwortgeschützte Seiten, Ordnerausgabe usw. unterstützt. Es wird empfohlen, dies zu verwenden $ .dspBody () Um den Körper in Ihre Vorlagen auszugeben, um sicherzustellen, dass diese Arten von Funktionen weiterhin ordnungsgemäß funktionieren. 

Semmelbrösel

Schließlich können Sie die eingebaute Funktion von Mura verwenden, um die Navigationspfade der Seite wie folgt auszugeben:

# $. dspCrumbListLinks () #

Wie Sie sehen, ist die Verwendung von Vorlagenvariablen eine großartige Möglichkeit, dynamische Inhalte schnell in Ihre Designvorlagen aufzunehmen.

Web-Design