Bewerkbare sjablonen editable-templates

Leer hoe bewerkbare sjablonen worden gebruikt bij het maken van een pagina, het definiëren van de initiële inhoud, gestructureerde inhoud, het ontwerpbeleid en de lay-out van de pagina.

Overzicht overview

Wanneer u een pagina maakt, moet u een sjabloon selecteren. De paginasjabloon wordt gebruikt als basis voor de nieuwe pagina. Met de sjabloon kunt u de structuur van de resulterende pagina, eventuele eerste inhoud en de componenten definiëren die kunnen worden gebruikt (ontwerpeigenschappen).

Met paginasjablonen die worden gebruikt om pagina's te maken die kunnen worden bewerkt met de Universal Editor, wordt een beperkte subset van bewerkbare sjabloonfunctionaliteit gebruikt. Daarom richt de rest van dit document zich op bewerkbare sjablonen die worden gebruikt om pagina's te maken die kunnen worden bewerkt met de Pagina-editor.

Bewerkbare sjablonen en pagina's bewerkt met de Pagina-editor page-editor

Bij het maken van sjablonen voor het maken van pagina's die kunnen worden bewerkt met de Pagina-editor, worden gewoonlijk gespecialiseerde auteurs geïdentificeerd.

Met bewerkbare sjablonen worden de onderdelen die een pagina maken, geïsoleerd in componenten. 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 bewerkbare sjabloon maken creating-a-new-template

Het creëren van editable malplaatjes wordt hoofdzakelijk gedaan met de ​ malplaatjeconsole en malplaatjeredacteur ​ door een malplaatjeauteur. 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 standaard AEM-instantie bestaat de map global 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 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 malplaatjeomslagen voor het ​ WKND leerprogramma ​ kan als voorbeeld worden gebruikt.

De groep sjabloonauteurs the-template-authors-group

De template-authors -groep is de groep die wordt gebruikt om toegang tot sjablonen te beheren en wordt standaard met AEM geleverd, 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 standaardgroep template-authors geldt alleen voor de projectinstellingen, waarbij alle template-authors -leden toegang hebben tot alle sjablonen en deze mogen 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:

Definities voor uw aangepaste sjabloontypen moeten worden opgeslagen in door de gebruiker gedefinieerde mappen (aanbevolen) of anders in 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

De definities voor editable malplaatjes worden opgeslagen ​ user-defined omslagen ​ (geadviseerd) of 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 ​ het uitgeven van een malplaatje u de lay-out ​ kunt bepalen, gebruikt dit ​ standaard ontvankelijke lay-out ​, die ​ op de pagina door de inhoudauteur ​ kan worden gevormd.

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

Het beleid van de pagina staat u toe om het ​ inhoudsbeleid ​ voor de pagina (belangrijkste parsys), in of het malplaatje of de resulterende pagina's te bepalen.

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:

met elkaar in verband brengen

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 pagina P moet worden geplaatst. 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 eigenschap cq:allowedTemplates van het knooppunt jcr:content van de pagina om de lijst met sjablonen op te geven die als onderliggende pagina's moeten worden toegestaan. Elke waarde in de lijst moet een absoluut pad zijn naar een sjabloon voor een toegestane onderliggende pagina, bijvoorbeeld /apps/wknd/templates/page-content .

U kunt de eigenschap cq:allowedTemplates op het knooppunt jcr:content van de sjabloon gebruiken om deze configuratie toe te passen op alle gemaakte pagina's die deze sjabloon gebruiken.

Als u meer beperkingen wilt toevoegen, bijvoorbeeld met betrekking tot de sjabloonhiërarchie, kunt u de eigenschappen allowedParents/allowedChildren op de sjabloon gebruiken. 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.