Basiscomponenten gebruiken

Om aan de slag te gaan met de Componenten van de Kern in uw eigen project, zijn er vier stappen, die individueel in secties hieronder worden beschreven:

  1. Downloaden en installeren
  2. Proxycomponenten maken
  3. De kernstijlen laden
  4. De componenten inschakelen
TIP

Voor bredere instructies over hoe te om van begin met de projectopstelling, de Componenten van de Kern, Bewerkbare Malplaatjes, de Bibliotheken van de Cliënt en de componentenontwikkeling te beginnen, zou de volgende multi-part leerprogramma van belang kunnen zijn:
Aan de slag met AEM Sites - WKND-zelfstudie

TIP

Als u AEM Project Archetype gebruikt, zijn de Componenten van de Kern automatisch inbegrepen in uw project dat op Adobe aanbevelingen wordt gebaseerd.

Downloaden en installeren

Een van de drijvende ideeën achter de kerncomponenten is flexibiliteit. Door nieuwe versies van de Core Components vrij te geven, kan Adobe zich flexibeler opstellen bij het aanbieden van nieuwe functies. Ontwikkelaars kunnen op hun beurt flexibel zijn in welke onderdelen zij kiezen om in hun projecten te integreren en hoe vaak zij deze willen bijwerken. Dit resulteert in een afzonderlijk releaseproces voor zowel AEM als de Core Components.

Daarom bepaalt de installatiestappen of u AEM als cloudservice of een service op locatie uitvoert.

AEM as a Cloud Service

Er is geen enkele stap. AEM als Cloud Service wordt automatisch geleverd met de nieuwste versie van de Core Components. Net zoals AEMaaCS u de nieuwste functies van AEM biedt, houdt AEMaaCS u automatisch bij met de nieuwste versie van de Core Components.

Bij het gebruik van de Core Components in AEMaaCS moet u rekening houden met enkele punten:

  • De kerncomponenten worden opgenomen in /libs.
  • De project bouwt pijpleiding zal waarschuwingen in het logboek produceren als het opnieuw de Componenten van de Kern als deel van /apps omvat en zal de versie negeren die als deel van uw project wordt ingebed.
    • In een volgende versie, zal het omvatten van de Componenten van de Kern opnieuw de pijpleiding bouwen ontbreken.
  • Als uw project eerder de Componenten van de Kern in /apps omvatte, kunt u uw project moeten aanpassen.
  • Hoewel de Core Components zich nu in /libs bevinden, wordt het niet aangeraden een overlay van hetzelfde pad te maken in /apps. Het patroon van de volmachtscomponent zou in plaats daarvan moeten worden gebruikt als om het even welk aspect van de componenten moet worden aangepast.

AEM 6.5 en eerder

De kerncomponenten maken geen deel uit van de snelstartprocedure wanneer de productiemodus wordt gestart (zonder voorbeeldinhoud). Daarom is uw eerste stap aan download het recentste vrijgegeven inhoudspakket van GitHub en om het op uw AEM milieu's te installeren.

Er zijn verschillende manieren om dit te automatiseren, maar de eenvoudigste manier om een inhoudspakket op een instantie snel te installeren is door de Manager van het Pakket te gebruiken; zie Pakketten installeren. Wanneer u een publicatie-instantie ook hebt uitgevoerd, moet u dat pakket ook naar de uitgever repliceren. zie Replicating Packages.

Proxycomponenten maken

Om redenen die worden toegelicht in de sectie Proxycomponentpatroon, mogen kerncomponenten niet rechtstreeks vanuit de inhoud worden verwezen. Om dat te vermijden, behoren zij allen tot een verborgen componentengroep ( .core-wcm of .core-wcm-form), die hen zal verhinderen direct in de redacteur te verschijnen.

In plaats daarvan moeten er sitespecifieke componenten worden gemaakt, die de gewenste componentnaam en -groep definiëren voor weergave bij paginaauteurs en die elk naar een Core-component verwijzen als het supertype. Deze plaats-specifieke componenten worden soms genoemd "volmachtscomponenten", omdat zij om het even wat niet te hoeven bevatten en vooral te dienen om de versie van een component te bepalen voor de plaats te gebruiken. Nochtans, wanneer het aanpassen van de Componenten van de Kern , spelen deze volmachtscomponenten een essentiële rol voor prijsverhoging en logische aanpassing.

Dus voor elke Core-component die voor een site moet worden gebruikt, moet u:

  1. Maak een overeenkomende proxycomponent in de map met componenten van de site.


    ExampleUnder /apps/my-site/components maakt een titelknooppunt van het type cq:Component

  2. Verwijs naar de corresponderende versie van de Core Component met het supertype.


    ExampleAdd volgende eigenschap:
    sling:resourceSuperType="core/wcm/components/title/v1/title"

  3. Definieer de groep, titel en eventueel beschrijving van de component. Deze waarden zijn projectspecifiek en dicteren hoe de component aan auteurs wordt blootgesteld.


    ExampleAdd volgende eigenschappen:

    componentGroup="My Site"
    jcr:title="Title"
    jcr:description="Section Heading"
    

Kijk bijvoorbeeld naar de titelcomponent van de WKND-site, die een goed voorbeeld is van een proxycomponent die op die manier is gemaakt.

De kernstijlen laden

  1. Als dit nog niet het geval is, maakt u een Clientbibliotheek die alle CSS- en JS-bestanden bevat die nodig zijn voor uw site.

  2. Voor de Bibliotheek van de Cliënt van uw plaats, voeg de gebiedsdelen aan de Componenten van de Kern toe die nodig zouden kunnen zijn. Dit wordt gedaan door een embed bezit toe te voegen.

    Als u bijvoorbeeld de clientbibliotheken van alle v1 Core-componenten wilt opnemen, moet u de volgende eigenschap toevoegen:

    embed="[
    core.wcm.components.image.v1,
    core.wcm.components.list.v1,
    core.wcm.components.breadcrumb.v1,
    core.wcm.components.form.container.v1,
    core.wcm.components.form.text.v1
    ]"
    

Controleer of uw proxycomponenten en clientbibliotheken zijn geïmplementeerd in uw AEM-omgeving voordat u naar de volgende sectie gaat.

De componenten toestaan

De volgende stappen worden uitgevoerd in Sjablooneditor.

  1. Selecteer in de Sjablooneditor de container met layout en open het bijbehorende beleid.
  2. Selecteer in de lijst Toegestane componenten de proxycomponenten die eerder zijn gemaakt. Deze moeten worden weergegeven onder de componentgroep die aan deze componenten is toegewezen. Breng de wijzigingen vervolgens aan.
  3. Optioneel, voor de componenten die een ontwerpdialoog hebben, kunnen zij pre-gevormd zijn.

Dat is het! Op de pagina's die met de bewerkte sjabloon zijn gemaakt, moet u nu de nieuw gemaakte componenten kunnen gebruiken.

Volgende lezen:

  • Kerncomponenten aanpassen - voor meer informatie over het opmaken en aanpassen van de kerncomponenten.
  • Componentrichtlijnen - om de implementatiepatronen van de kerncomponenten te leren.

Op deze pagina