DokumentationAEM 6.4Användarhandbok om Communities

Community Components Guide community-components-guide

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

Skapat för:

  • User
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

Community Components Guide är ett interaktivt utvecklingsverktyg för ramverk för sociala komponenter (SCF). Här finns en lista med tillgängliga AEM Communities-komponenter eller mer komplexa funktioner som byggts av flera komponenter.

Tillsammans med grundläggande information för varje komponent kan guiden experimentera med hur SCF-komponenterna/-funktionerna fungerar och hur de kan konfigureras eller anpassas.

Mer information om grundläggande utvecklingsfunktioner för varje komponent finns i Grundläggande funktioner och komponenter.

Komma igång getting-started

Handboken är avsedd att användas i utvecklingsinstallationer av författare (localhost:4502) och publicera (localhost:4503) instanser.

Webbplatsen Community Components nås via

Interaktionen med komponenterna i Communities varierar beroende på:

  • Servern (författare eller publicerad)
  • Om besökaren är inloggad eller inte
  • Om du är inloggad, de privilegier som tilldelats medlemmen
  • Om SRP är standard eller inte, JSRPanvänds

Vid författare anger du redigeringsläget genom att infoga editor.html eller cf# som det första sökvägssegmentet efter servernamnet:

NOTE
Länkarna på en sida är inte aktiva i redigeringsläge.
Om du vill navigera till en komponentsida väljer du först Förhandsgranskningsläge för att aktivera länkarna.
När komponentsidan visas i webbläsaren går du tillbaka till redigeringsläget för att öppna komponentens redigeringsdialogruta.
Allmän redigeringsinformation finns i snabbguide till framtagning av sidor.
Om du inte känner till AEM kan du läsa dokumentationen om grundläggande hantering.

Hemsida home-page

Guiden innehåller en lista med de SCF-komponenter som är tillgängliga för förhandsgranskning och prototyper längs sidans vänstra sida.

Komponentguiden visas på en författarinstans i redigeringsläge:

chlimage_1-404

Komponentsidor component-pages

Markera en komponent i listan till vänster på sidan.

chlimage_1-405

Huvudtexten i guiden visar:

  1. Titel: Namnet på den markerade komponenten

  2. Klientbibliotek: En lista över en eller flera obligatoriska kategorier

  3. Inkluderande: Om komponenten kan inkluderas dynamiskt kan läget aktiveras i redigeringsläget för författare:

    • Om den text som visas läggs till är: "Den här komponenten inkluderas via dess parnod."
    • Om det ingår är texten som visas: "Den här komponenten inkluderas dynamiskt."
    • Om den inte är inkluderbar visas ingen text

  4. Exempelkomponent eller funktion: en aktiv instans av komponenten eller funktionen. Om en komponent ändras kan den ändras med ändringar i mallarna, CSS och data som finns i flikavsnittet.

NOTE
När du har gjort ett val från vänster sida visas komponenten nedan, i stället för bredvid, listan med komponenter när webbläsarfönstret är för smalt.

Författarinteraktioner author-interactions

När du använder guiden för en författarinstans kan du uppleva hur en komponent konfigureras genom att öppna dess dialogruta. Information för utvecklare finns i Grundläggande om komponenter och funktioner i dokumentationen, medan inställningarna för dialogrutorna beskrivs i Communities-komponenter för författare.

I guiden Community Components (Community-komponenter) är vissa inställningar i komponentdialogrutorna överlagrade med Inkluderande växla läge. Om du vill växla mellan att använda den befintliga resursen eller en resurs som ingår dynamiskt markerar du både komponenten och den inkluderbara texten i redigeringsläget och dubbelklickar för att öppna redigeringsdialogrutan:

chlimage_1-406

Under Mallar tab:

chlimage_1-407

  • Inkludera den underordnade komponenten med sling:include

    Om alternativet inte är markerat används den befintliga resursen i databasen (en jcr-nod som är underordnad en par-nod).

    • texten som visas är: "Den här komponenten inkluderas via dess parnod."

    Om det här alternativet är markerat används sling för att dynamiskt inkludera en komponent i den underordnade nodens resourceType (en resurs som inte finns).

    • texten som visas är: "Den här komponenten inkluderas dynamiskt."

    Standard är avmarkerat.

Publicera interaktioner publish-interactions

När du använder guiden för en publiceringsinstans är det möjligt att uppleva komponenterna och funktionerna som en besökare (inte inloggad) och som medlemmar med olika behörigheter när de loggas in.

NOTE
Tänk på att om SRP lämnas som standard till JSRP, kommer den UGC som anges i publiceringsinstansen endast att vara synlig vid publiceringen och *inte *vara synlig från moderering konsol på författarinstansen.

Klientbibliotek client-side-libraries

Klientsidans bibliotek (klientlibs) för varje komponent är de som obligatoriskt som ska refereras när komponenten placeras på en sida. Klientlibs är ett sätt att hantera och optimera nedladdningen av JavaScript och CSS som används för att återge komponenten i webbläsaren.

Mer information finns på Clientlibs for Communities Components.

Personifiering impersonation

I författarinstansen, där en användare ofta är inloggad som administratör eller utvecklare, använder du textrutan till vänster om Impersonate för att antingen skriva in användarnamnet eller välja i listrutan och sedan klicka på knappen. Klicka på Återställ för att logga ut och avsluta personifieringen.

Publiceringsinstansen behöver inte personifiera. Använd bara länken Login/Logout för att personifiera olika användare, till exempel demoanvändare.

Anpassning customization

När det här alternativet är aktiverat är varje SCF-komponent tillgänglig för att skapa prototyper för eventuella anpassningar genom att tillfälligt ändra komponentens mall, CSS och data.

Aktivera anpassning enabling-customization

NOTE
Det här verktyget är skrivskyddat. Ingen av de ändringar som gjorts i mallar, CSS eller data sparas i databasen.

Om du snabbt vill experimentera med anpassningar kan du scg:showIde-egenskapen måste läggas till i komponentsidans innehåll-JCR-nod och ställas in på true.

Använda kommentarkomponenten som exempel, på antingen författaren eller publiceringsinstansen, inloggad med administratörsbehörighet:

  1. Bläddra till CRXDE Lite

    Till exempel: http://localhost:4503/crx/de

  2. Markera komponentens jcr:content nod

    Till exempel, /content/community-components/en/comments/jcr:content

  3. Lägg till en egenskap

    • Namn scg:showIde
    • Typ String
    • Värde true

  4. Välj Save All

  5. Läs in kommentarsidan igen i stödlinjen

    http://localhost:4503/content/community-components/en/comments.html

  6. Observera att det nu finns tre flikar för Mallar, CSS och Data.

chlimage_1-408 chlimage_1-409

Fliken Mallar templates-tab

Välj fliken Mallar för att visa mallarna som är kopplade till komponenten.

I mallredigeraren kan lokala redigeringar kompileras och användas på exempelkomponentinstansen högst upp på sidan utan att komponenten i databasen påverkas.

När du kör kompileringen på lokala redigeringar markeras eventuella fel med en punkt i mellanrummet och texten markeras med röd.

CSS-flik css-tab

Välj fliken CSS om du vill visa CSS-koden som är kopplad till komponenten.

Om en komponent är en sammansättning av flera komponenter kan vissa CSS listas under någon av de andra komponenterna.

Med CSS Editor kan CSS ändras och tillämpas på exempelkomponentinstansen högst upp på sidan.

Du kan markera en regel för att markera delar av DOM med den regeln genom att klicka bredvid regeln i kolumnmarginalen.

Fliken Data data-tab

Välj fliken Data för att visa .social.json-slutpunktsdata. Dessa data kan redigeras och används på exempelkomponentinstansen.

Syntaxfel kan markeras i mellanrummet och markeras i redigeraren.

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6