Guide för communitykomponenter community-components-guide

Guide för communitykomponenter är ett interaktivt utvecklingsverktyg för det sociala komponentramverket (SCF). Här finns en lista med tillgängliga komponenter för Adobe Experience Manager (AEM) Communities eller de 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.

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

Komma igång getting-started

Guiden är avsedd att användas i utvecklingsinstallationer av författarinstanser (localhost:4502) och publiceringsinstanser (localhost:4503).

Webbplatsen Community Components nås via

Interaktionen med komponenterna i Communities varierar beroende på:

  • Servern (författare eller publicerad).
  • Anger om besökaren är inloggad eller inte.
  • Om du är inloggad, de privilegier som tilldelats medlemmen.
  • Anger om standardmetoden för SRP, JSRP, används.

Om du vill gå till redigeringsläge infogar du 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 och öppnar komponentens redigeringsdialogruta.
Allmän redigeringsinformation finns i snabbguiden för redigering 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:

community-component1

Komponentsidor component-pages

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

communitykomponentsidor

Huvudtexten i guiden visar:

  1. Titel: Namnet på den markerade komponenten

  2. Bibliotek på klientsidan: En lista med en eller flera nödvändiga kategorier

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

    • Om den här texten läggs till visas den:"Den här komponenten inkluderas via dess parnod."
    • Om den här texten inkluderas visas den:"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 avsnittet Komponent- och Funktionsfunktioner i dokumentationen, medan inställningarna för dialogrutorna beskrivs i avsnittet Webbgruppskomponenter för författare.

För guiden Community Components (Community-komponenter) har vissa inställningar i komponentdialogrutorna överlappats med växlingsläget Inkluderbar. 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:

community-component3

Under fliken Mallar:

community-component4

  • 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.

Publish Interactions 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
Observera att om SRP lämnas som standard till JSRP så syns bara den UGC som anges i publiceringsinstansen vid publiceringen och inte visas från konsolen moderation på författarinstansen.

Bibliotek på klientsidan client-side-libraries

Klientsidans bibliotek (klientlibs) som anges för varje komponent är de som krävs 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

På författarinstansen, där en användare ofta är inloggad som administratör eller utvecklare, kan du använda textrutan till vänster om knappen 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 måste egenskapen scg:showIde 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

    Exempel: http://localhost:4503/crx/de

  2. Markera komponentens jcr:content-nod

    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. Lägg märke till att det nu finns tre flikar för Mallar, CSS och Data.

community-component5

community-component6

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
81e2cd9d-0789-409d-b87c-2a8ce4f28791