Sidmallar

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

• Med sidmallar kan skribenter skapa och redigera mallar.
  • Sådana specialister kallas mallskapare
  • Mallförfattare måste vara medlemmar i template-authors grupp.
• Sidmallar behåller en dynamisk anslutning till alla sidor som skapas från dem. Detta säkerställer att alla ändringar i mallen återspeglas på själva sidorna.
• Sidmallar gör sidkomponenten mer generisk så att huvudsidkomponenten kan användas utan anpassning.

Med Sidmallar isoleras de delar som utgör en sida i 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:

• Ger en översikt över hur du skapar en sidmall
• Beskriver de admin-/utvecklaråtgärder som krävs för att skapa redigerbara mallar
• Beskriver de tekniska grunderna för redigerbara mallar
• Beskriver hur AEM utvärderar en malls tillgänglighet

Skapa en ny mall

Skapa sidmallar görs i första hand med mallkonsol och mallredigerare 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 ny redigerbar mall:

1. Skapa en mapp för mallarna. Detta är inte obligatoriskt, men vi rekommenderar bästa praxis.

2. Välj en malltyp. Detta kopieras för att skapa malldefinition.

   OBSERVERA

   Ett urval av malltyper finns färdiga. Du kan också skapa egna webbplatsspecifika malltyper vid behov.

3. Konfigurera den nya mallens struktur, innehållsprinciper, ursprungliga innehåll och layout.

   Struktur

   • Strukturen gör att du kan definiera komponenter och innehåll för mallen.
   • Komponenter som definieras i mallstrukturen kan inte flyttas till en resultatsida eller tas bort från eventuella resultatsidor.
   • Om du vill att sidförfattare ska kunna lägga till och ta bort komponenter lägger du till ett styckesystem i mallen.
   • Komponenter kan låsas upp och låsas igen så att du kan definiera ursprungligt innehåll.

   Mer information om hur en mallskapare definierar strukturen finns i Skapa sidmallar.

   För teknisk information om strukturen, se Struktur i det här dokumentet.

   Profiler

   • 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).

   Mer information om hur en mallskapare definierar principer finns i Skapa sidmallar.

   Teknisk information om profiler finns i Innehållsprofiler i det här dokumentet.

   Ursprungligt innehåll

   • Ursprungligt innehåll definierar innehåll som visas när en sida skapas baserat på mallen.
   • Startinnehållet kan sedan redigeras av sidförfattare.

   Mer information om hur en mallskapare definierar strukturen finns i Skapa sidmallar.

   Teknisk information om ursprungligt innehåll finns på Ursprungligt innehåll i det här dokumentet.

   Layout

   • Du kan definiera mallayouten för ett antal olika enheter.
   • Responsiv layout för mallar fungerar på samma sätt som för sidredigering.

   Mer information om hur en mallskapare definierar mallayouten finns i Skapa sidmallar.

   Mer teknisk information om mallayout finns i Layout i det här dokumentet.

4. Aktivera mallen och tillåt den sedan för specifika innehållsträd.

   • En mall kan aktiveras eller inaktiveras för att göra den tillgänglig eller inte tillgänglig för sidförfattare.
   • En mall kan göras tillgänglig eller otillgänglig för vissa sidgrenar.

   Mer information om hur en mallskapare aktiverar en mall finns i Skapa sidmallar.

   Teknisk information om hur du aktiverar en mall finns i Aktivera och tillåta en mall för osse i det här dokumentet

5. Använd det för att skapa innehållssidor.

   • När du använder en mall för att skapa en ny sida finns det ingen synlig skillnad och ingen indikation mellan statiska och redigerbara mallar.
   • För sidförfattaren är processen genomskinlig.

   Mer information om hur en sidförfattare använder mallar för att skapa en sida finns i Skapa och ordna sidor.

   Teknisk information om hur du skapar sidor med redigerbara mallar finns i Gällande innehållssidor i det här dokumentet.

Mallmappar

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

• global
• Webbplatsspecifik

I en AEM global mappen finns 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 ny mapp (rekommenderas).

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

1. Aktuell mapp
2. Överordnad(e) till aktuell mapp
3. /conf/global
4. /apps
5. /libs

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

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

• Programmerat eller med CRXDE Lite
• Använda Konfigurationsläsaren

Använda CRXDE Lite

1. En ny mapp (under /conf) kan skapas för din instans antingen programmatiskt eller med CRXDE Lite.

   Följande struktur måste användas:

   /conf
       <your-folder-name> [sling:Folder]
           settings [sling:Folder]
               wcm [cq:Page]
                   templates [cq:Page]
                   policies [cq:Page]
   

2. Du kan sedan definiera följande egenskaper på mappens rotnod:

   <your-folder-name> [sling:Folder]

   • Namn: jcr:title
   • Typ: String
   • Värde: Den rubrik (för mappen) som du vill ska visas i Mallar konsol.

3. Förutom de vanliga redigeringsbehörigheterna och -behörigheterna (till exempel content-authors) måste du nu tilldela grupper och definiera de åtkomstbehörigheter som krävs för att författarna ska kunna skapa mallar i den nya mappen.

   The template-authors grupp är standardgruppen som måste tilldelas. Se avsnittet Behörighetslistor och grupper för mer information.

Använda Konfigurationsläsaren

1. Gå till Global navigering -> verktyg > Konfigurationsläsaren.

   De befintliga mapparna visas till vänster, inklusive global mapp.

2. Klicka Skapa.

3. I Skapa konfiguration måste följande fält konfigureras:

   • Titel: Ange en rubrik för konfigurationsmappen
   • Redigerbara mallar: Markera för att tillåta redigerbara mallar i den här mappen

4. Klicka Skapa

Behörighetslistor och grupper

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.

Mallmappar för WKND, genomgång kan användas som exempel.

Mallförfattargruppen

The template-authors grupp ä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 standardinställningen template-authors gruppen täcker endast 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

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

• Malltyper tillhandahåller effektivt mallar för en mall. När du skapar en ny mall används strukturen och det ursprungliga innehållet för den valda malltypen för att skapa till den nya mallen.

  • Malltypen kopieras för att skapa mallen.
  • När kopian är klar är den enda kopplingen mellan mallen och malltypen en statisk referens i informationssyfte.

• Med malltyper kan du definiera:

  • Sidkomponentens resurstyp.
  • Rotnodens princip, som definierar vilka komponenter som tillåts i mallredigeraren.
  • Vi rekommenderar att du definierar brytpunkter för responsiva rutnät och inställningar för mobilemulatorn på malltypen.

• AEM innehåller ett litet urval av färdiga malltyper som HTML5 Page och Adaptive Form Page.

  • Ytterligare exempel finns som en del av WKND självstudiekurs.

• Malltyper definieras vanligtvis av utvecklare.

Malltyperna som inte finns lagrade under:

• /libs/settings/wcm/template-types

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

• /apps/settings/wcm/template-types

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

• /conf/<my-folder-01>/<my-folder-02>/settings/wcm/template-types
• /conf/<my-folder>/settings/wcm/template-types
• /conf/global/settings/wcm/template-types

Skapa malltyper

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.

1. Skapa en mall på samma sätt som vilken sidmall som helst dokumenteras här, som kommer att fungera som bas för din malltyp.
2. Kopiera den nya mallen från CRXDE Lite med hjälp av templates nod till template-types noden under mallmapp.
3. Ta bort mallen från templates noden under mallmapp.
4. I kopian av mallen som finns under template-types nod, ta bort alla cq:template och cq:templateType egenskaper från alla jcr:content noder.

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

• Öppna aem-sites-example-custom-template-type-projekt på GitHub
• Hämta projektet som en ZIP-fil

Malldefinitioner

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

• /conf/<my-folder>/settings/wcm/templates
• /conf/<my-folder-01>/<my-folder-02>/settings/wcm/templates
• /conf/global/settings/wcm/templates

Mallens rotnod ä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:

• <template-name>

  • [initial](#initial-content)
  • jcr:content
  • [structure](#structure)
  • [policies](#policies)
  • thumbnail.png

jcr:innehåll

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

• Namn: jcr:title
• Namn: status
  • "Typ: String
  • Värde: draft, enabled eller disabled

Struktur

Definierar strukturen för den resulterande sidan:

• Sammanfogas med det ursprungliga innehållet ( /initial) när du skapar en ny sida.

• Ändringar som görs i strukturen återspeglas i alla sidor som skapas med mallen.

• The root ( structure/jcr:content/root)-noden definierar listan med komponenter som ska vara tillgängliga på den resulterande sidan.

  • Komponenter som definieras i mallstrukturen kan inte flyttas eller tas bort från resultatsidor.
  • När en komponent har låsts upp editable egenskapen är inställd på true.
  • När en komponent som redan innehåller innehåll är olåst flyttas det här innehållet till initial förgrening.

• The cq:responsive noden innehåller definitioner för den responsiva layouten.

Ursprungligt innehåll

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

• Innehåller en jcr:content nod som kopieras till nya sidor.
• Sammanfogas med strukturen ( /structure) när du skapar en ny sida.
• Befintliga sidor uppdateras inte om det ursprungliga innehållet ändras efter att de har skapats.
• The root noden innehåller en lista med komponenter för att definiera vad som ska vara tillgängligt på den resulterande sidan.
• Om innehåll läggs till i en komponent i strukturläge och den komponenten sedan låses upp (eller vice versa), används det här innehållet som ursprungligt innehåll.

Layout

När redigera en mall kan du definiera layoutenanvänds responsiv standardlayout.

Innehållsprofiler

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.

• Egenskapen cq:policy, på root nod
  /conf/<your-folder>/settings/wcm/templates/<your-template>/policies/jcr:content/root
  Ger en relativ referens till innehållsprincipen för sidans styckesystem.

• Egenskapen cq:policy, på de komponentspecifika noderna under root, innehåller länkar till profilerna för de enskilda komponenterna.

• De faktiska principdefinitionerna lagras under:
  /conf/<your-folder>/settings/wcm/policies/wcm/foundation/components

Sidprofiler

Med sidprofiler kan du definiera innehållsprincip för sidan (huvudparametrar), antingen i mallen eller på de resulterande sidorna.

Aktivera och tillåta en mall för användning

1. Aktivera mallen

   Innan en mall kan användas måste den aktiveras av något av följande:

   • Aktivera mallen från Mallar konsol.

   • Ställa in egenskapen status på jcr:content nod.

     • På:

       /conf/<your-folder>/settings/wcm/templates/<your-template>/jcr:content

     • Definiera egenskapen:

       • Namn: status
       • Typ: Sträng
       • Värde: enabled

2. Tillåtna mallar

   • Definiera tillåtna mallsökvägar på Sidegenskaper av rätt sida eller rotsida i en underavdelning.

   • Ange egenskapen:

     cq:allowedTemplates
     På
     jcr:content noden för den begärda grenen.
     Med till exempel värdet:

   /conf/<your-folder>/settings/wcm/templates/.*

Gällande innehållssidor

Sidor skapade från redigerbara mallar:

• Skapas med ett underträd som sammanfogas från structure och initial i mallen

• Har referenser till information som finns i mallen och malltypen. Detta uppnås med en jcr:content nod med egenskaperna:

  • cq:template - innehåller en dynamisk referens till den faktiska mallen, gör att ändringar i mallen kan återspeglas på de faktiska sidorna.

  • cq:templateType - Tillhandahåller en referens till malltypen.

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

• Styrenhet - /content/<my-site>/<my-page> - Den resulterande sidan som refererar till mallen. Innehållet styr hela processen. Enligt definitionerna har den åtkomst till rätt mall och komponenter.
• Konfiguration - /conf/<my-folder>/settings/wcm/templates/<my-template> - mallar och relaterade innehållsprinciper definiera sidkonfigurationen.
• Model - OSGi bundles - The OSGI-paket implementera funktionen.
• Visa - /apps/<my-site>/components - I både författar- och publiceringsmiljöer återges innehållet av komponenter.

Vid återgivning av en sida:

• Mallar:

  • The cq:template egenskap för dess jcr:content Noden kommer att refereras till för att komma åt mallen som motsvarar den sidan.

• Komponenter:

  • Sidkomponenten kommer att sammanfoga structure/jcr:content mallens träd med jcr:content sidans träd.
    • Sidkomponenten tillåter bara författaren att redigera noderna i mallstrukturen som har flaggats som redigerbara (samt eventuella underordnade noder).
    • När du återger en komponent på en sida hämtas komponentens relativa sökväg från jcr:content nod; samma bana under policies/jcr:content -noden i mallen söks sedan igenom.
      • The cq:policy den här nodens egenskap pekar på den faktiska innehållsprincipen (d.v.s. den innehåller komponentens designkonfiguration).
        • På så sätt kan du ha flera mallar som återanvänder samma innehållsprincipkonfigurationer.

Malltillgänglighet

När du skapar en ny 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 en mall 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:

• The cq:allowedTemplates egenskapen för jcr:content undernod till P eller en överordnad till P.

• The allowedPaths egenskap för T.

• The allowedParents egenskap för T.

• The allowedChildren egenskap för mallen för P.

Utvärderingen fungerar enligt följande:

• Den första som inte är tom cq:allowedTemplates egenskap påträffades när sidhierarkin skulle ökas från P matchas mot sökvägen för T. Om inget av värdena matchar, T avvisas.

• If T har ett värde som inte är tomt allowedPaths -egenskapen, men inget av värdena matchar sökvägen för P, T avvisas.

• Om båda ovanstående egenskaper är tomma eller inte finns, T avvisas om det inte tillhör samma program som P. T tillhör samma program som P om och bara om namnet på den andra nivån i sökvägen för T är samma som namnet på den andra nivån i sökvägen för P. Mallen /apps/wknd/templates/foo tillhör samma program som sidan /content/wknd.

• If T har ett värde som inte är tomt allowedParents -egenskapen, men inget av värdena matchar sökvägen för P, T avvisas.

• Om mallen för P har ett värde som inte är tomt allowedChildren -egenskapen, men inget av värdena matchar sökvägen för T, T avvisas.

• I alla andra fall T är tillåtet.

I följande diagram visas mallutvärderingsprocessen:

Begränsa mallar som används på underordnade sidor

Om du vill begränsa vilka mallar som kan användas för att skapa underordnade sidor under en viss sida använder du cq:allowedTemplates egenskap för jcr:content nod på sidan 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 cq:allowedTemplates -egenskap i mallens jcr:content nod som den här konfigurationen ska tillämpas på alla nyskapade sidor som använder den här mallen.

Om du vill lägga till fler begränsningar, till exempel för mallhierarkin, kan du använda allowedParents/allowedChildren -egenskaper 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.

Resurser för Business.Adobe.com