Mura CMS Mura Scope

Når du lager dine temaer, må du få tilgang til ulike verdier og objekter som er lagret i Mura CMS, for å bli utført innenfor temaoppslaget eller eksempelsidene. Mura Scope er en rask og enkel måte å få tilgang til data og gjenstander i Mura CMS. Mura-området gir deg ikke bare tilgang til sidenivådata, men gir deg også tilgang til hele objekter og funksjoner! La oss ta en titt på noen viktige bruksområder for Mura Scope.

Innholdsomfang

I opplæringen for klassen utvidelser har vi lagt til noen egendefinerte attributter på en bokside i Mura, og utdata disse verdiene ved hjelp av en komponent. Vi brukte Mura Content Scope for å få tilgang til innholdsbønnen og hente det attributtet vi ønsket. Grunnsyntaxen for tilgang til innholdsbønnen er:

$ .Content ( 'someAttribute')

Vi kan bruke denne syntaksen til å få tilgang til hvilken som helst variabel vi ønsker fra en innholdskode, inkludert eventuelle egendefinerte attributter vi legger til:

 $ .Content ( 'tittel')  $ .Content ( 'oppsummering')  $ .Content ( 'sp')  $ .Content ( 'type')  $ .Content ( 'myExtendedAttribute')

Nåværende brukeromfang

Hvis nettstedet ditt er utformet for å inkludere medlemsbasert funksjonalitet, vil du kanskje bruke gjeldende brukeromfang for å samhandle med den gjeldende brukeren på nettstedet. 

Oppdag om brukeren er logget inn eller ikke

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

Site Config Omfang

Dette omfanget gir deg muligheten til å få tilgang til global informasjon om ditt Mura CMS-nettsted, nærmere bestemt de fleste verdiene du finner i din Site Config> Rediger nettsted område i administrasjonen. Du har sikkert allerede sett dette som brukes i temaet html_head.cfm når du kobler dynamisk til dine CSS- og JS-filer:

Dette forteller Mura at uansett hva temanavnet heter, ta tak i veien og finn /assets/bootstrap/css/bootstrap.css fil. Dette er nyttig fordi det forhindrer at banene blir ødelagte hvis utvikleren noensinne har bestemt seg for å endre navnet på temaet til noe annet (for eksempel navnet på klientens selskap) i utviklingen. For eksempel, hvis temaet ditt er 'MuraBootstrap3' (som leveres med Mura), ville banen være SiteID / includes / tema / MuraBootstrap3 /

Og hvis utvikleren noen gang har endret temanavnet til 'CompanyABC', ville banen være: SiteID / includes / tema / CompanyABC /

Du kan også bruke Site Config-omfanget for å få tilgang til Navn av nettstedet, som det er skrevet inn i admin:

$ .SiteConfig ( 'site')

Dette er nyttig for ting som tittelkoder eller bunntekstinformasjon for temaet ditt.

Viser objekter

I tillegg til å hente side- og sidevariabler, kan Mura Scope også vise hele innebygde og tilpassede objekter i Mura. 

Viser et skjema

$ .dspForm ('Min skjema')

Vise en komponent

Vise en komponent er svært vanlig i temautvikling. Dette gjør at du kan ha komplisert markering i layoutmaler, og bare la elementene du vil redigere av brukerne, bli redigert via administrasjonen. 

 # $. dspComponent ('Komponentnavn') # 

Viser en feed

$ .dspFeed ('Feed Name')

Tilpassede metoder

Som vi lærte i opplæringen Custom Metals, lar Mura CMS deg enkelt legge til tilpassede funksjoner til temaet ditt contentRenderer.cfc og få tilgang til dem via Mura-området. Så gitt følgende funksjon i temaet ditt contentRenderer.cfc:

Du kan bare ringe den funksjonen ved hjelp av Mura-området:

$ .DspMySlider ()

Mura Scope er et kraftig verktøy i Mura som kan brukes til en rekke bruksområder under temautviklingen. Jeg oppfordrer deg til å bruke det ofte for å skape robuste temaer.