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:
-
Standardgränssnitt:
https://<server>:<port>/editor.html/content/community-components/en.html
-
Klassiskt användargränssnitt:
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:
Komponentsidor component-pages
Markera en komponent i listan till vänster på sidan.
Huvudtexten i guiden visar:
-
Titel: Namnet på den markerade komponenten
-
Bibliotek på klientsidan: En lista med en eller flera nödvändiga kategorier
-
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
-
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.
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:
Under fliken Mallar:
-
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.
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
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:
-
Bläddra till CRXDE Lite
Exempel: http://localhost:4503/crx/de
-
Markera komponentens
jcr:content
-nodExempel:
/content/community-components/en/comments/jcr:content
-
Lägg till en egenskap
- Namn
scg:showIde
- Typ
String
- Värde
true
- Namn
-
Välj Save All
-
Läs in kommentarsidan igen i stödlinjen
http://localhost:4503/content/community-components/en/comments.html
-
Lägg märke till att det nu finns tre flikar för Mallar, CSS och Data.
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.