Basiscomponenten gebruiken using-core-components
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:
Aan de slag met AEM Sites - WKND-tutorial
Downloaden en installeren download-and-install
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 aemaacs
Er is geen enkele stap. AEM as a 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 een aantal punten:
- De kerncomponenten zijn opgenomen in
/libs. - Het project bouwt pijpleiding zal waarschuwingen in het logboek produceren als het de Componenten van de Kern opnieuw als deel van omvat
/appsen zal de ingesloten versie als deel van uw project negeren.- 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 omvatte in
/apps, u kunt uw project moeten aanpassen. - Hoewel de Core Components zich nu in
/libs, wordt het niet aangeraden een overlay van hetzelfde pad te maken in/apps. Patroon voor proxycomponenten moet worden gebruikt als een aspect van de componenten moet worden aangepast. - Om Component Inhoudsopgave om zijn inhoud terug te geven, moet een filter in OSGi worden gevormd.
- Gelieve te zien de documentatie GitHub van de component voor meer informatie .
AEM 6.5 en eerder aem-65
De kerncomponenten maken geen deel uit van de snelstartprocedure wanneer de productiemodus wordt gestart (zonder voorbeeldinhoud). Daarom is uw eerste stap: 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 Pakketten repliceren.
Proxycomponenten maken create-proxy-components
Om de in de Proxycomponentpatroon Core Components must not be referenced from the content. Om dat te voorkomen behoren ze allemaal tot een verborgen componentgroep ( .core-wcm of .core-wcm-form), waardoor ze niet rechtstreeks in de redactie kunnen 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. Wanneer u echter het Kernonderdelen, spelen deze volmachtscomponenten een essentiële rol voor prijsverhoging en logica aanpassing.
Dus voor elke Core-component die voor een site moet worden gebruikt, moet u:
-
Maak een overeenkomende proxycomponent in de map met componenten van de site.
Voorbeeld
Onder/apps/my-site/componentseen titelknooppunt van het type makencq:Component -
Verwijs naar de corresponderende versie van de Core Component met het supertype.
Voorbeeld
Volgende eigenschap toevoegen:sling:resourceSuperType="core/wcm/components/title/v1/title" -
Definieer de groep, titel en eventueel beschrijving van de component. Deze waarden zijn projectspecifiek en dicteren hoe de component aan auteurs wordt blootgesteld.
Voorbeeld
Voeg de volgende eigenschappen toe:code language-shell componentGroup="My Site" jcr:title="Title" jcr:description="Section Heading"
Kijk bijvoorbeeld naar de titelcomponent van de WKND-site, wat een goed voorbeeld is van een proxycomponent die op die manier is gemaakt.
De kernstijlen laden load-the-core-styles
-
Als u dit nog niet hebt gedaan, maakt u een Clientbibliotheek die alle CSS- en JS-bestanden bevat die nodig zijn voor uw site.
-
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 doet u door een
embedeigenschap.Als u bijvoorbeeld de clientbibliotheken van alle v1 Core-componenten wilt opnemen, moet u de volgende eigenschap toevoegen:
code language-shell 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 allow-the-components
De volgende stappen worden uitgevoerd in het dialoogvenster Sjablooneditor.
- Selecteer in de Sjablooneditor de container met layout en open het bijbehorende beleid.
- 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.
- 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 - leren hoe u de basiscomponenten kunt vormgeven en aanpassen.
- Componentrichtlijnen - om de implementatiepatronen van de Core Components te leren.