Paginasjablonen page-templates

Wanneer u een pagina maakt, moet u een sjabloon selecteren. De paginasjabloon wordt gebruikt als basis voor de nieuwe pagina. De sjabloon definieert de structuur van de resulterende pagina, eventuele initiële inhoud en de componenten die kunnen worden gebruikt (ontwerpeigenschappen). Dit heeft verschillende voordelen:

Met paginasjablonen worden de onderdelen die een pagina maken, geïsoleerd in onderdelen. U kunt de noodzakelijke combinaties componenten in een UI vormen, daardoor eliminerend de behoefte aan een nieuwe paginacomponent die voor elke paginariatie moet worden ontwikkeld.

Dit document:

Een nieuwe sjabloon maken creating-a-new-template

Het maken van paginasjablonen gebeurt vooral met de opdracht sjabloonconsole en sjablooneditor door een sjabloonauteur. In deze paragraaf wordt een overzicht gegeven van dit proces en wordt een beschrijving gegeven van wat er op technisch niveau gebeurt.

Bij het maken van een bewerkbare sjabloon:

Sjabloonmappen template-folders

Voor het organiseren van uw sjablonen kunt u de volgende mappen gebruiken:

In een standaardinstelling AEM global bestaat al in de sjabloonconsole. Dit houdt standaardmalplaatjes vast en doet dienst als reserve als geen beleid en/of malplaatje-types in de huidige omslag worden gevonden. U kunt uw standaardsjablonen toevoegen aan deze map of een map maken (aanbevolen).

Sjabloontypen en beleid worden in alle mappen overgeërfd volgens de volgende prioriteitsvolgorde:

Er wordt een lijst met alle toegestane vermeldingen gemaakt. Als een van de configuraties elkaar overlappen ( path/ label), wordt alleen de instantie die zich het dichtst bij de huidige map bevindt, aan de gebruiker getoond.

Als u een map wilt maken, kunt u het volgende doen:

CRXDE Lite gebruiken using-crxde-lite

De configuratiebrowser gebruiken using-the-configuration-browser

ACLs en Groepen acls-and-groups

Zodra uw malplaatjeomslagen (of via CRXDE of met Browser van de Configuratie) worden gecreeerd, moet ACLs voor de aangewezen groepen voor de malplaatjeomslagen worden bepaald om juiste veiligheid te verzekeren.

De sjabloonmappen voor de WKND-zelfstudie kan als voorbeeld worden gebruikt.

De groep sjabloonauteurs the-template-authors-group

De template-authors de groep is de groep wordt gebruikt om toegang tot malplaatjes te beheren en komt standaard met AEM, maar is leeg. Gebruikers moeten worden toegevoegd aan de groep voor het project of de site.

In de volgende tabel worden de benodigde machtigingen voor sjabloonbewerking weergegeven.

Deze standaard template-authors groep omvat alleen de projectinstellingen, waarbij alle template-authors leden hebben toegang tot alle sjablonen en mogen deze samenstellen. Voor complexere montages, waar de veelvoudige groepen van malplaatjeauteurs nodig zijn om toegang tot malplaatjes te scheiden, moeten meer de auteursgroepen van het douanemalplaatje worden gecreeerd. Nochtans zouden de toestemmingen voor de groepen van malplaatjeauteurs nog het zelfde zijn.

Sjabloontype template-type

Wanneer u een sjabloon maakt, moet u een sjabloontype opgeven:

De sjabloontypen voor de out-of-the-box worden opgeslagen onder:

Uw sitespecifieke sjabloontypen moeten worden opgeslagen op de vergelijkbare locatie:

De definities voor uw aangepaste malplaatjetypes zouden in user-defined omslagen (geadviseerd) of anders in moeten worden opgeslagen global. Bijvoorbeeld:

Sjabloontypen maken creating-template-types

Als u een sjabloon hebt gemaakt die als basis voor andere sjablonen kan dienen, kunt u deze sjabloon kopiëren als een sjabloontype.

U kunt uw eigen malplaatjetype ook ontwikkelen gebruikend een voorbeeld editable malplaatje als basis, beschikbaar op GitHub.

CODE VOOR GITHUB

U kunt de code van deze pagina op GitHub vinden

Sjabloondefinities template-definitions

Definities voor bewerkbare sjablonen worden opgeslagen door de gebruiker gedefinieerde mappen (aanbevolen) of als alternatief in global. Bijvoorbeeld:

Het hoofdknooppunt van de sjabloon is van het type cq:Template met een skeletstructuur van:

<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

De belangrijkste elementen zijn:

jcr:inhoud jcr-content

Dit knooppunt bevat eigenschappen voor de sjabloon:

Structuur structure

Hiermee definieert u de structuur van de resulterende pagina:

Oorspronkelijke inhoud initial-content

Definieert de eerste inhoud die een nieuwe pagina krijgt wanneer deze wordt gemaakt:

Layout layout

Wanneer bewerken van een sjabloon die u kunt definiërengebruikt standaardresponsieve indeling.

Inhoudsbeleid content-policies

Het inhoudsbeleid definieert de ontwerpeigenschappen van een component. Bijvoorbeeld de beschikbare componenten of de minimum-/maximumafmetingen. Deze zijn van toepassing op de sjabloon (en op pagina's die met de sjabloon zijn gemaakt). Het inhoudsbeleid kan worden gemaakt en geselecteerd in de sjablooneditor.

Paginabeleid page-policies

Met paginabeleid kunt u de inhoudsbeleid voor de pagina (belangrijkste parsys), in of het malplaatje of resulterende pagina's.

Een sjabloon inschakelen en toestaan voor gebruik enabling-and-allowing-a-template-for-use

Resulterende inhoudspagina's resultant-content-pages

Pagina's gemaakt op basis van bewerkbare sjablonen:

In het bovenstaande diagram ziet u hoe sjablonen, inhoud en componenten met elkaar verweven zijn:

Bij het weergeven van een pagina:

Beschikbaarheid sjabloon template-availability

Wanneer u een pagina maakt in de interface voor sitebeheer, is de lijst met beschikbare sjablonen afhankelijk van de locatie van de nieuwe pagina en de plaatsingsbeperkingen die in elke sjabloon zijn opgegeven.

De volgende eigenschappen bepalen of een sjabloon T mag worden gebruikt voor een nieuwe pagina die als onderliggend item van een pagina moet worden geplaatst P. Elk van deze eigenschappen is een tekenreeks met meerdere waarden die nul of meer reguliere expressies bevat die worden gebruikt voor overeenkomsten met paden:

De evaluatie werkt als volgt:

Het volgende diagram toont het sjabloonevaluatieproces:

Sjablonen beperken die worden gebruikt in onderliggende pagina's limiting-templates-used-in-child-pages

Als u wilt beperken welke sjablonen kunnen worden gebruikt om onderliggende pagina's onder een bepaalde pagina te maken, gebruikt u de opdracht cq:allowedTemplates eigenschap van jcr:content knooppunt van de pagina om de lijst op te geven met sjablonen die als onderliggende pagina's zijn toegestaan. Elke waarde in de lijst moet een absoluut pad zijn naar een sjabloon voor bijvoorbeeld een toegestane onderliggende pagina. /apps/wknd/templates/page-content.

U kunt de cq:allowedTemplates eigenschap op de sjabloon jcr:content knoop om deze configuratie toe te passen op alle gecreeerde pagina's die dit malplaatje gebruiken.

Als u meer beperkingen wilt toevoegen, bijvoorbeeld met betrekking tot de sjabloonhiërarchie, kunt u de opdracht allowedParents/allowedChildren eigenschappen op de sjabloon. U kunt dan uitdrukkelijk specificeren dat de pagina's die van een malplaatjeT worden gecreeerd ouderpagina/kinderen van pagina's moeten zijn die van een malplaatjeT worden gecreeerd.