Mura CMS Mura Scope

När du skapar dina teman måste du komma åt olika värden och objekt som är lagrade i Mura CMS för att bli utmatade inom tematypen eller exempelsidorna. Mura Scope är ett snabbt och enkelt sätt att komma åt data och objekt i Mura CMS. Mura Scope låter dig inte bara komma åt sidnivådata utan ger dig också tillgång till hela objekt och funktioner! Låt oss ta en titt på några viktiga användningsfall för Mura Scope.

Innehållsomfattning

I handledning av klasstillägg har vi lagt till några anpassade attribut på en boksida i Mura och matar ut dessa värden med hjälp av en komponent. Vi använde Mura Content Scope för att komma åt innehållsbönan och hämta attributet vi ville ha. Bassyntaxen för åtkomst till innehållsbönen är:

$ .Content (someAttribute)

Vi kan använda denna syntax för att få tillgång till vilken variabel vi vill ha från en innehållsnod, inklusive eventuella anpassade attribut vi lägger till:

 $ .Content ( 'title')  $ .Content (sammandrag)  $ .Content (krediter ")  $ .Content ( 'typ')  $ .Content (myExtendedAttribute)

Nuvarande användaromfattning

Om din webbplats är utformad för att inkludera medlemsbaserad funktionalitet, kan du använda det aktuella användarområdet för att interagera med den nuvarande användaren på webbplatsen. 

Upptäck om användaren är inloggad eller inte

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

Site Config Omfattning

Detta räckvidd ger dig möjlighet att få tillgång till global information om din Mura CMS-webbplats, mer specifikt de flesta värden du hittar i din Site Config> Redigera webbplats område i admin. Du har nog redan sett det här som används i temat html_head.cfm när du länkar dynamiskt till dina CSS- och JS-filer:

Detta berättar Mura att oavsett vad temamålet heter, ta tag i sökvägen och lokalisera /assets/bootstrap/css/bootstrap.css fil. Det här är till hjälp eftersom det förhindrar att banorna bryts om utvecklaren någonsin bestämt sig för att ändra namnet på temat till något annat (till exempel kundens namn) under utveckling. Till exempel, om ditt tema är "MuraBootstrap3" (som skickas med Mura), skulle banan vara SiteID / includes / teman / MuraBootstrap3 /

Och om utvecklaren någonsin ändrat temanamnet till "CompanyABC" skulle banan vara: SiteID / includes / teman / CompanyABC /

Du kan också använda Site Config-räckvidden för att komma åt namn av webbplatsen, eftersom den har skrivits in i admin:

$ .SiteConfig (site)

Det här är användbart för saker som Titel-taggar eller sidfotinformation för ditt tema.

Visar objekt

Förutom att hämta sid- och sidvariabler kan Mura Scope också visa hela inbyggda och anpassade objekt i Mura. 

Visar ett formulär

$ .dspForm ('My Form')

Visar en komponent

Att visa en komponent är mycket vanlig i tematillväxten. Detta gör att du kan ha komplicerad markering i dina layoutmallar och låta bara de objekt du vill redigera av dina användare redigeras via admin. 

# $. dspComponent ('Komponentnamn') #

Visar ett flöde

$ .dspFeed ("Feed Name")

Anpassade metoder

Som vi lärde oss i handboken Custom Methods, tillåter Mura CMS dig enkelt att lägga till anpassade funktioner till ditt tema contentRenderer.cfc och få tillgång till dem via Mura Scope. Så ges följande funktion i ditt tema contentRenderer.cfc:

  

Du kan helt enkelt ringa den funktionen med Mura Scope:

$ .DspMySlider ()

Mura Scope är ett kraftfullt verktyg i Mura som kan användas för en mängd olika användningsfall under din temat utveckling. Jag uppmuntrar dig att använda det ofta för att skapa robusta teman.