Hent teknisk dokumentation - Go Basic

Som det ses i diagrammet, nedarver alle klasserne direkte, eller indirekte fra Entity
klassen, som gør at CmsService klassen kan arbejde med dem.
Eksempler på brugen af API-abstraktionen kommer her:
var service = CmsService.Instance; // Returnerer via provider pattern en request
scope instans af GoBasic.UmbracoServices.UmbracoService.
var module = service.GetItem(new Id(12)); Returnerer et typestærkt
FormsModule objekt. Den tilsvarende kode i Umbraco ville være :
var node = new NodeFactory.Node(12);
eller
var document = new Document(12);
Modulsystem
Go Basics modulsystem er udviklet for at give redaktører en større fleksibilitet i forhold
til opbygning af indhold. Et modul er basalt set en lille byggeklods som kan inkluderes
på en eller flere sider. Der findes en række forskellige modultyper i Go Basic, bl.a. en
nyhedsliste, en call-to-action box, et billedegalleri og en videoboks. Hver modultype
har en række felter som gør, at det enkelte modul kan konfigureres på forskellige
måder.
Rent teknisk set, består et modul af en dokumenttype, en entitets klasse og en
præsentationsklasse.
Dokumenttypen skal nedarve fra GridModule dokumenttypen og skal navngives med
postfix ”Module”, f.eks. ”MultiBox Module”. Det giver et dokumenttype alias som
hedder følgende ”MultiBoxModule”. Der skal ikke specificeres en template ved
oprettelsen. Derudover tilføjer man de felter man har behov for, for at konfigurere
modulet.
Entitetsklassen skal nedarve fra GridModule entiteten, og navnet skal svare til
dokumenttypens alias. Dette sker helt automatisk ved at køre kodegenereringen. For
at tilgå de enkelte felter på modulet oprettes en partiel klasse, hvorpå felterne oprettes
som properties.
Præsentationsklassen kan være en CustomControl eller en UserControl. Der er pt.
ikke understøttelse af xslt renderinger. Præsentationsklassen skal hedde
entitetsklassens navn plus postfikset ”Rendering”. Dvs. MultiBoxModuleRendering.
Når et modul skal renderes leder systemet altså efter en præsentationsklasse som
hedder modulets navn + ”Rendering”.
Bemærk! Hvis man benytter sig af user controls til at implementere
præsentationsklassen, skal den oprettes under /Modules folderen i roden af website
projektet.
Eksempel på tilføjelse af et modul
I det følgende eksempel tager vi udgangspunkt i at benytte custom controls til at
implementere et ”Hello World” modul.
Opret dokumenttypen ”Hello World Module”.
Log ind i Umbraco som administrator.
Vælg ”settings” sektionen i venstre side i bunden.
5