Anvend Canvas redigering i Umbraco selvom du bruger XSLT

Som nogle måske har fanget, så er jeg stor fan af CMS’et Umbraco. Udvikler i det dagligt på mit arbejde, og derved kommer jeg rundt i alle hjørner i produktet.

Når man udvikler i Umbraco, kan man hente sit indhold ud på forskellige måder. De to mest brugte metoder er vha. de såkaldte Umbraco-sidefelter eller vha. XSLT. Jeg benytter mig primært af XSLT-metoden, da jeg så har større fleksibilitet i mit arbejde, og kan manipulere med mit output i større grad end hvis jeg benyttede Umbraco-sidefelter.

Problemet
Men der er en ulempe når man hiver sine data ud igennem XSLT. Det er nemlig som udgangspunkt ikke muligt at benytte sig af canvas redigering (også kendt som live editing i andre systemer) når man bruger XSLT til at rendere indhold. Canvas redigering er en metode for webmasterne af systemet til at redigere indholdet på sitet set fra frontend. Det vil sige at man direkte ude på hjemmesiden kan redigere elementer, uden at skulle ind i backend-delen. Meget praktisk til de mere uerfarne brugere.

Men problemet er som sagt at canvas redigering ikke virker ved et standardudtræk igennem XSLT. Normal hiver man en værdi ud af systemet på følgende måde:
<xsl:value-of select="$currentPage/data [@alias = 'tekstIndhold']" />

I eksemplet ovenfor er det indhold i et umbraco felt som vi har givet alias’et tekstIndhold. Det kunne eksempelvis være indholdet fra en richtext editor.

Løsningen
For at få canvas redigering til at virke, og stadig beholde den dejlige frihed som ligger i XSLT kan man benytte sig af en udokumenteret feature i Umbraco. Man skal ind og bruge en funktion i umbraco’s XSLT library som hedder Item. Denne udvidelse er ikke beskrevet nogle steder, men bruger vi eksemplet fra før, kan vi omskrive det til følgende:
<xsl:value-of select="umbraco.library:Item($currentPage/@id, 'tekstIndhold')" />

Frontend-mæssigt kommer brugerne til at se præcis det same indhold som var synligt før, men nu har webmasterne altså også mulighed for at redigere i canvas, hvilket er en stor fordel i visse sammenhænge.

Man angiver sådan set de samme oplysninger når man henter værdierne ud, men bare i en lidt omvendt rækkefølge. Først angiver man hvilket node-id der skal hentes indhold fra, og derefter hvilket alias der skal benyttes.

Så alt i alt er der ikke meget hokus pokus der. Håber det kunne bruges.