Redigerbara mallar editable-templates

Lär dig hur redigerbara mallar används när du skapar en sida, definierar dess ursprungliga innehåll, strukturerat innehåll, redigeringsprinciper och layout.

Ökning overview

När du skapar en sida måste du välja en mall. Sidmallen används som bas för den nya sidan. Mallen kan definiera strukturen för den resulterande sidan, allt ursprungligt innehåll och de komponenter som kan användas (designegenskaper).

Sidmallar som används för att skapa sidor som kan redigeras med den universella redigeraren använder en begränsad delmängd av de redigerbara mallfunktionerna. Därför är resten av det här dokumentet fokuserat på redigerbara mallar som används för att skapa sidor som är redigerbara med sidredigeraren.

Redigerbara mallar och sidor som har redigerats med sidredigeraren page-editor

När du skapar mallar för att skapa sidor som är redigerbara med sidredigeraren identifieras vanligtvis specialiserade författare.

Med redigerbara mallar isoleras de delar som utgör en sida inuti komponenterna. Du kan konfigurera nödvändiga kombinationer av komponenter i ett användargränssnitt, vilket eliminerar behovet av att utveckla en ny sidkomponent för varje sidvariant.

Det här dokumentet:

Skapa en ny redigerbar mall creating-a-new-template

Skapandet av redigerbara mallar görs huvudsakligen med mallkonsolen och mallredigeraren av en mallskapare. I det här avsnittet ges en översikt över processen och en beskrivning av vad som händer på teknisk nivå.

När du skapar en redigerbar mall:

Mallmappar template-folders

Du kan använda följande mappar för att ordna dina mallar:

I en AEM finns mappen global redan i mallkonsolen. Detta innehåller standardmallar och fungerar som reserv om inga principer och/eller malltyper hittas i den aktuella mappen. Du kan lägga till dina standardmallar i den här mappen eller skapa en mapp (rekommenderas).

Malltyper och profiler ärvs i alla mappar enligt följande prioritetsordning:

En lista över alla tillåtna poster skapas. Om några konfigurationer överlappar ( path/ label) visas endast den instans som ligger närmast den aktuella mappen för användaren.

Om du vill skapa en mapp kan du göra det här:

Använda CRXDE Lite using-crxde-lite

Använda Konfigurationsläsaren using-the-configuration-browser

Behörighetslistor och grupper acls-and-groups

När mallmapparna har skapats (antingen via CRXDE eller med Configuration Browser) måste åtkomstkontrollistor definieras för rätt grupper för mallmapparna för att säkerställa rätt säkerhet.

Mallmapparna för WKND-självstudiekursen kan användas som exempel.

Mallförfattargruppen the-template-authors-group

Gruppen template-authors är den grupp som används för att hantera åtkomst till mallar och levereras som standard med AEM, men är tom. Användare måste läggas till i gruppen för projektet/webbplatsen.

Följande tabell visar vilka behörigheter som krävs för mallredigering.

Den här standardgruppen template-authors täcker bara projektinställningarna, där alla template-authors-medlemmar har åtkomst till och kan redigera alla mallar. För mer komplexa konfigurationer, där flera mallförfattargrupper behövs för att separera åtkomsten till mallar, måste fler anpassade mallskapargrupper skapas. Behörigheterna för mallförfattargrupperna är dock fortfarande desamma.

Malltyp template-type

När du skapar en mall måste du ange en malltyp:

Malltyperna som inte finns lagrade under:

Platsspecifika malltyper bör lagras på samma plats som:

Definitioner för dina anpassade malltyper ska lagras i användardefinierade mappar (rekommenderas) eller i global. Till exempel:

Skapa malltyper creating-template-types

Om du har skapat en mall som kan användas som bas för andra mallar kan du kopiera den här mallen som en malltyp.

Du kan också utveckla en egen malltyp med en exempelredigerbar mall som bas, som finns på GitHub.

KOD PÅ GITHUB

Koden för den här sidan finns på GitHub

Malldefinitioner template-definitions

Definitioner för redigerbara mallar lagras i användardefinierade mappar (rekommenderas) eller i global. Till exempel:

Rotnoden för mallen är av typen cq:Template med en skelettstruktur på:

<template-name>
  initial
    jcr:content
      root
        <component>
        ...
        <component>
  jcr:content
    @property status
  policies
    jcr:content
      root
        @property cq:policy
        <component>
          @property cq:policy
        ...
        <component>
          @property cq:policy
  structure
    jcr:content
      root
        <component>
        ...
        <component>
      cq:responsive
        breakpoints
  thumbnail.png

Huvudelementen är:

jcr:innehåll jcr-content

Den här noden innehåller egenskaper för mallen:

Struktur structure

Definierar strukturen för den resulterande sidan:

Ursprungligt innehåll initial-content

Definierar det ursprungliga innehåll som en ny sida kommer att ha när den skapas:

Layout layout

När du redigerar en mall kan du definiera layouten, använder detta responsiv standardlayout, som kan konfigureras på sidan av innehållsförfattaren.

Innehållsprinciper content-policies

Innehållsprinciperna definierar designegenskaperna för en komponent. Till exempel de tillgängliga komponenterna eller minimi-/maximidimensionerna. Dessa gäller för mallen (och sidor som skapas med mallen). Du kan skapa och välja innehållsprinciper i mallredigeraren.

Sidprofiler page-policies

Med sidprofiler kan du definiera sidans innehållsprincip (huvudparsys), antingen i mallen eller på de resulterande sidorna.

Aktivera och tillåta en mall för användning enabling-and-allowing-a-template-for-use

Gällande innehållssidor resultant-content-pages

Sidor skapade från redigerbara mallar:

Diagrammet ovan visar hur mallar, innehåll och komponenter samverkar:

När en sida återges:

Malltillgänglighet template-availability

När du skapar en sida i webbplatsens administratörsgränssnitt beror listan med tillgängliga mallar på platsen för den nya sidan och de placeringsbegränsningar som anges i varje mall.

Följande egenskaper avgör om mallen T får användas för en ny sida som ska placeras som underordnad till sidan P. Var och en av dessa egenskaper är en sträng med flera värden som innehåller noll eller flera reguljära uttryck som används för matchning med sökvägar:

Utvärderingen fungerar enligt följande:

I följande diagram visas mallutvärderingsprocessen:

Begränsa mallar som används på underordnade sidor limiting-templates-used-in-child-pages

Om du vill begränsa vilka mallar som kan användas för att skapa underordnade sidor under en viss sida använder du egenskapen cq:allowedTemplates för noden jcr:content för att ange listan med mallar som ska tillåtas som underordnade sidor. Varje värde i listan måste vara en absolut sökväg till en mall för en tillåten underordnad sida, till exempel /apps/wknd/templates/page-content.

Du kan använda egenskapen cq:allowedTemplates på mallens jcr:content-nod om du vill att den här konfigurationen ska tillämpas på alla skapade sidor som använder mallen.

Om du vill lägga till fler begränsningar, till exempel för mallhierarkin, kan du använda egenskaperna allowedParents/allowedChildren i mallen. Du kan sedan uttryckligen ange att sidor som skapats från en mall T måste vara överordnade/underordnade sidor till sidor som skapats från en mall T.