DocumentatieAEMGids voor kerncomponenten

Basiscomponenten gebruiken using-core-components

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar
  • Beheerder
  • Gebruiker

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:
Begonnen het worden met AEM Sites - WKND Leerprogramma
TIP
Als u het AEM Archieftype van het Project gebruikt,zijn de Componenten van de Kern automatisch inbegrepen in uw project dat op de aanbevelingen van best van de Adobe wordt gebaseerd.

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 de Adobe flexibeler zijn 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 worden opgenomen in /libs .
  • Het 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 ingebed als deel van uw project.
    • 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 aanbevolen om in /apps een overlay van hetzelfde pad te maken. het patroon van de volmachtscomponentzou in plaats daarvan moeten worden gebruikt als om het even welk aspect van de componenten moet worden aangepast.
  • Opdat de component van de Inhoudsopgavezijn inhoud teruggeeft, moet een filter in OSGi worden gevormd.

AEM 6.5 en eerder aem-65

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

Er zijn verscheidene 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. Ook, zodra u een publiceer instantie zult hebben die eveneens loopt, zult u dat pakket aan de uitgever moeten herhalen; zie het Repliceren van Pakketten.

Proxycomponenten maken create-proxy-components

Om redenen die in de 🔗 sectie worden verklaard van het Patroon van de Component van de Volmacht {, moeten de Componenten van de Kern niet direct van de inhoud worden van verwijzingen voorzien. Om dat te voorkomen behoren ze allemaal tot een verborgen componentgroep ( .core-wcm of .core-wcm-form ), waardoor ze niet direct in de editor worden weergegeven.

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.

    Voorbeeld
    Onder /apps/my-site/components een titelknooppunt van het type maken cq:Component

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

    Voorbeeld
    Volgende eigenschap toevoegen:
    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.

    Voorbeeld
    Voeg de volgende eigenschappen toe:

    code language-shell 
    componentGroup="My Site"
jcr:title="Title"
jcr:description="Section Heading"

Bijvoorbeeld, bekijk de titelcomponent van de plaats WKND, die een goed voorbeeld van een volmachtscomponent is die die manier wordt gebouwd.

De kernstijlen laden load-the-core-styles

  1. Als nog niet gedaan, creeer de Bibliotheek van de a Cliëntdie alle CSS en JS- dossiers bevat die voor uw plaats nodig zijn.

  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 eigenschap embed toe te voegen.

    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 de Redacteur van het Malplaatje.

  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.

Lees daarna:

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c