DocumentatieAEM 6.4Handleiding voor ontwikkeling

Sjablonen templates

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Developer
CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Sjablonen worden op verschillende punten in AEM gebruikt:

De volgende sjablonen worden in detail besproken:

Sjablonen - Pagina's templates-pages

AEM biedt nu twee basistypen sjablonen voor het maken van pagina's:

NOTE
Als u een sjabloon gebruikt naar een nieuwe pagina maken er is geen zichtbaar verschil (voor de auteur van de pagina) en er is geen aanduiding van het type sjabloon dat wordt gebruikt.

Bewerkbare sjablonen editable-templates

Bewerkbare sjablonen worden nu beschouwd als aanbevolen werkwijzen voor het ontwikkelen met AEM.

De voordelen van bewerkbare sjablonen:

  • Kan gemaakt en bewerkt door uw auteurs.

  • Zijn geïntroduceerd zodat u het volgende kunt definiëren voor pagina's die met de sjabloon zijn gemaakt:

    • de structuur
    • de initiële inhoud
    • inhoudsbeleid

  • Nadat de nieuwe pagina is gemaakt, wordt een dynamische verbinding onderhouden tussen de pagina en de sjabloon. dit betekent dat wijzigingen in de sjabloonstructuur worden doorgevoerd op alle pagina's die met die sjabloon worden gemaakt (wijzigingen in de oorspronkelijke inhoud worden niet doorgevoerd).

  • Gebruikt het inhoudsbeleid (dat van de malplaatjeredacteur wordt uitgegeven) om de ontwerpeigenschappen (gebruikt niet de wijze van het Ontwerp binnen de paginaredacteur) voort te zetten.

  • worden opgeslagen onder /conf

  • Zie Bewerkbare sjablonen voor nadere informatie.

NOTE
Er is een AEM communautair artikel beschikbaar waarin wordt uitgelegd hoe u een site voor Experience Managers met bewerkbare sjablonen kunt ontwikkelen, raadpleegt u Een Adobe Experience Manager 6.4-website maken met Bewerkbare sjablonen.

Statische sjablonen static-templates

Statische sjablonen:

  • Moet door uw ontwikkelaars worden bepaald en worden gevormd.
  • Dit was het oorspronkelijke sjabloonsysteem van AEM en is al in vele versies beschikbaar.
  • Een statische sjabloon is een hiërarchie van knooppunten die dezelfde structuur heeft als de pagina die moet worden gemaakt, maar zonder daadwerkelijke inhoud.
  • Wordt gekopieerd om de nieuwe pagina te maken. Hierna bestaat geen dynamische verbinding.
  • Gebruiksmiddelen Ontwerpmodus om ontwerpeigenschappen te behouden.
  • worden opgeslagen onder /apps
  • Zie Statische sjablonen voor nadere informatie.
NOTE
Vanaf AEM 6.4 wordt het gebruik van statische sjablonen niet als een goede praktijk beschouwd. Gebruik in plaats hiervan Bewerkbare sjablonen.
AEM Modernisering met gereedschappen kunt u migreren van statische naar bewerkbare sjablonen.

Beschikbaarheid sjabloon template-availability

CAUTION
AEM biedt meerdere eigenschappen om de sjablonen te beheren die zijn toegestaan onder Sites. Het combineren ervan kan echter leiden tot zeer complexe regels die moeilijk te volgen en te beheren zijn.
Daarom adviseert Adobe dat u eenvoudig begint, door te bepalen:

  • alleen cq:allowedTemplates eigenschap

  • alleen in de hoofdmap van de site

Voor een voorbeeld, zie Wij.Retail: /content/we-retail/jcr:content
De eigenschappen allowedPaths, allowedParents, en allowedChildren kan ook op de malplaatjes worden geplaatst om verfijndere regels te bepalen. Waar mogelijk is het echter veel eenvoudiger te definiëren cq:allowedTemplates eigenschappen op subsecties van de site als de toegestane sjablonen verder moeten worden beperkt.
Een extra voordeel is dat de cq:allowedTemplates eigenschappen kunnen door een auteur worden bijgewerkt in het dialoogvenster Geavanceerd tabblad van het dialoogvenster Pagina-eigenschappen. De andere malplaatjeeigenschappen kunnen niet worden bijgewerkt gebruikend (standaard) UI, zodat zou een ontwikkelaar nodig hebben om de regels en een codeplaatsing voor elke verandering te handhaven.

Wanneer u een nieuwe 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 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 cq:allowedTemplates eigendom van de jcr:content subknooppunt van P of een voorouder van P.

  • De allowedPaths eigenschap van T.

  • De allowedParents eigenschap van T.

  • De allowedChildren eigenschap van de template van P.

De evaluatie werkt als volgt:

  • De eerste niet-lege cq:allowedTemplates eigenschap gevonden tijdens oplopende paginahiërarchie, beginnend met P komt overeen met het pad van T. Als geen van de waarden overeenkomt, T wordt verworpen.

  • Indien T heeft een niet-leeg allowedPaths eigenschap, maar geen van de waarden komt overeen met het pad van P, T wordt verworpen.

  • Als beide bovengenoemde eigenschappen leeg of niet bestaan, T wordt afgewezen, tenzij het tot dezelfde aanvraag behoort als P. T behoort tot dezelfde toepassing als P als en alleen als de naam van het tweede niveau van het pad van T is gelijk aan de naam van het tweede niveau van het pad van P. De sjabloon /apps/geometrixx/templates/foo behoort tot dezelfde toepassing als de pagina /content/geometrixx.

  • Indien T heeft een niet-leeg allowedParents eigenschap, maar geen van de waarden komt overeen met het pad van P, T wordt verworpen.

  • Indien de template van P heeft een niet-leeg allowedChildren eigenschap, maar geen van de waarden komt overeen met het pad van T, T wordt verworpen.

  • In alle andere gevallen T is toegestaan.

Het volgende diagram toont het sjabloonevaluatieproces:

chlimage_1-176

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 een toegestane onderliggende pagina, bijvoorbeeld /apps/geometrixx/templates/contentpage.

U kunt de cq:allowedTemplates eigenschap op de sjabloon jcr:content knoop om deze configuratie toe te passen op alle pas gecreëerde 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.

Sjablonen - Inhoudsfragmenten templates-content-fragments

Zie Sjablonen voor inhoudsfragmenten voor volledige informatie.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e