Mura CMS Mura Scope

Wenn Sie Ihre Designs erstellen, müssen Sie auf verschiedene Werte und Objekte zugreifen, die in Mura CMS gespeichert sind, um sie innerhalb Ihrer Design-Markup- oder Beispielseiten auszugeben. Mit dem Mura Scope können Sie schnell und einfach auf Daten und Objekte in Mura CMS zugreifen. Mit dem Mura Scope haben Sie nicht nur Zugriff auf Daten auf Seitenebene, sondern auch auf ganze Objekte und Funktionen! Schauen wir uns einige wichtige Anwendungsfälle für den Mura Scope an.

Inhaltsumfang

Im Lernprogramm "Klassenerweiterungen" haben wir einer Buchseite in Mura einige benutzerdefinierte Attribute hinzugefügt und diese Werte mithilfe einer Komponente ausgegeben. Wir haben den Mura Content Scope verwendet, um auf die Content-Bean zuzugreifen und das gewünschte Attribut abzurufen. Die Basissyntax für den Zugriff auf die Content-Bean lautet:

$ .content ('someAttribute')

Wir können diese Syntax verwenden, um auf eine beliebige Variable von einem Inhaltsknoten aus zuzugreifen, einschließlich aller benutzerdefinierten Attribute, die wir hinzufügen:

 $ .content ('title')  $ .content ('Zusammenfassung')  $ .content ('credits')  $ .content ('type')  $ .content ('myExtendedAttribute')

Aktueller Benutzerbereich

Wenn Ihre Site mit Mitgliedschaftsfunktionen ausgestattet ist, möchten Sie möglicherweise den aktuellen Benutzerbereich für die Interaktion mit dem aktuellen Benutzer der Site verwenden. 

Ermitteln Sie, ob der Benutzer angemeldet ist oder nicht

 Hallo, # $. CurrentUser ('fname') #   

Site Config-Umfang

Dieser Bereich gibt Ihnen die Möglichkeit, auf globale Informationen zu Ihrer Mura CMS-Site zuzugreifen, insbesondere auf die meisten Werte, die Sie in Ihrer finden würden Site Config> Site bearbeiten Bereich im Admin. Sie haben dies wahrscheinlich bereits im Thema gesehen html_head.cfm Beim dynamischen Linken zu Ihren CSS- und JS-Dateien:

Dies sagt Mura, dass, egal wie der Name des Themes heißt, seinen Pfad greifen und den Namen suchen /assets/bootstrap/css/bootstrap.css Datei. Dies ist hilfreich, da dadurch verhindert wird, dass die Pfade unterbrochen werden, falls der Entwickler sich jemals dafür entschieden hat, den Namen des Designs in eine andere Richtung zu ändern (z. B. den Namen des Unternehmens des Kunden). Wenn Ihr Thema beispielsweise "MuraBootstrap3" ist (das im Lieferumfang von Mura enthalten ist), lautet der Pfad siteID / include / themes / MuraBootstrap3 /

Wenn der Entwickler den Namen des Themas in 'CompanyABC' geändert hat, lautet der Pfad dann: siteID / umfasst / themes / CompanyABC /

Sie können auch den Site-Config-Bereich verwenden, um auf die Site zuzugreifen Name der Site, wie sie im Admin eingetragen ist:

$ .siteConfig ('site')

Dies ist hilfreich für Dinge wie Titel-Tags oder Fußzeileninformationen für Ihr Thema.

Objekte anzeigen

Neben dem Abrufen von Seiten- und Site-Variablen kann der Mura-Bereich auch ganze integrierte und benutzerdefinierte Objekte in Mura anzeigen. 

Ein Formular anzeigen

$ .dspForm ("Mein Formular")

Anzeige einer Komponente

Das Anzeigen einer Komponente ist in der Themenentwicklung sehr häufig. Auf diese Weise können Sie komplexe Markierungen in Ihren Layoutvorlagen verwenden und nur die Elemente bearbeiten, die von Ihren Benutzern bearbeitet werden können, über den Administrator. 

 # $. dspComponent ('Komponentenname') # 

Feed anzeigen

$ .dspFeed ('Feedname')

Benutzerdefinierte Methoden

Wie wir im Tutorial "Benutzerdefinierte Methoden" gelernt haben, können Sie mit Mura CMS problemlos benutzerdefinierte Funktionen zu Ihren Themen hinzufügen contentRenderer.cfc und über das Mura Scope auf sie zugreifen. So gegeben die folgende Funktion in Ihrem Thema contentRenderer.cfc:

Sie können diese Funktion einfach mit dem Mura Scope aufrufen:

$ .dspMySlider ()

Das Mura Scope ist ein mächtiges Werkzeug in Mura, das während der Entwicklung eines Themas für eine Vielzahl von Anwendungsfällen verwendet werden kann. Ich ermutige Sie, es häufig zu verwenden, um robuste Themen zu erstellen.