Das Handbuch Community-Komponenten ist ein interaktives Entwicklungstool für das Social-Komponenten-Framework (SCF). Es bietet eine Liste der verfügbaren AEM Communities-Komponenten oder der komplexeren Funktionen, die aus mehreren Komponenten bestehen.
Neben den grundlegenden Informationen für jede Komponente ermöglicht das Handbuch Experimente darüber, wie die SCF-Komponenten/-Funktionen funktionieren und wie sie konfiguriert oder angepasst werden können.
Weitere Informationen zu Entwicklungserfordernissen für die einzelnen Komponenten finden Sie unter Feature und Component Essentials.
Das Handbuch ist für die Verwendung in Entwicklungs-Installationen von Autoreninstanzen (localhost:4502) und Veröffentlichungsinstanzen (localhost:4503) vorgesehen.
Die Website "Community-Komponenten"finden Sie unter
Die Interaktionen mit den Communities-Komponenten variieren je nach:
Um beim Autor in den Bearbeitungsmodus zu wechseln, fügen Sie entweder editor.html
oder cf#
als erstes Pfadsegment nach dem Servernamen ein:
Standard-Benutzeroberfläche:
https://<server>:<port>/editor.html/content/community-components/en.html
Klassische Benutzeroberfläche:
https://<server>:<port>/cf#/content/community-components/en.html
Beim Autor im Bearbeitungsmodus sind die Links auf einer Seite nicht aktiv.
Um zu einer Komponentenseite zu navigieren, wählen Sie zunächst den Vorschau-Modus aus, um die Links zu aktivieren.
Kehren Sie bei angezeigter Komponentenseite zum Bearbeitungsmodus zurück, um das Dialogfeld der Komponente zu öffnen.
Ansicht der Quick guide to authoring pages für allgemeine Authoring-Informationen.
Wenn Sie mit AEM nicht vertraut sind, Ansicht der Dokumentation unter Basisbehandlung.
Das Handbuch enthält eine Liste der SCF-Komponenten, die für die Vorschau und das Erstellen von Prototypen auf der linken Seite verfügbar sind.
Komponentenhandbuch, wie auf einer Autoreninstanz im Bearbeitungsmodus angezeigt:
Wählen Sie eine Komponente aus der Liste links auf der Seite aus.
Der Hauptteil des Handbuchs wird angezeigt:
Titel: Der Name der ausgewählten Komponente
Clientseitige Bibliotheken: Eine Liste einer oder mehrerer erforderlicher Kategorien
Einschließlich: Wenn die Komponente dynamisch eingeschlossen werden kann, kann der Status im Bearbeitungsmodus des Autors umgeschaltet werden:
Beispielkomponente oder -funktion: eine aktive Instanz der Komponente oder Funktion. Wenn eine Komponente geändert wird, kann sie durch Änderungen an den Vorlagen, CSS und Daten im Abschnitt "Registerkarte"geändert werden.
Nachdem Sie eine Auswahl auf der linken Seite getroffen haben, wird die Komponente unter und nicht neben der Auflistung der Komponenten angezeigt, wenn das Browserfenster zu schmal ist.
Wenn Sie das Handbuch für eine Autoreninstanz verwenden, können Sie die Konfiguration einer Komponente durch Öffnen des Dialogfelds durchführen. Informationen für Entwickler finden Sie im Abschnitt Komponenten- und Funktionskomponenten der Dokumentation, während die Dialogeinstellungen im Abschnitt Communities-Komponenten für Autoren beschrieben werden.
Im Handbuch "Community-Komponenten"werden einige Einstellungen im Komponentendialogfeld mit dem Umschalter Includable überlagert. Um zwischen der vorhandenen Ressource oder einer dynamisch eingeschlossenen Ressource zu wechseln, wählen Sie im Bearbeitungsmodus sowohl die Komponente als auch den inklusiven Text aus und klicken Sie bei gedrückter Dublette, um das Bearbeitungsdialogfeld zu öffnen:
Auf der Registerkarte Vorlagen:
Untergeordnete Komponente mit sling:include einschließen
Wenn diese Option deaktiviert ist, verwendet das Komponentenleitfaden die vorhandene Ressource im Repository (einen jcr-Knoten, der einem par-Knoten untergeordnet ist).
Wenn diese Option aktiviert ist, verwendet das Komponentenleitfaden sling, um dynamisch eine Komponente des resourceType des untergeordneten Knotens (nicht vorhandene Ressource) einzuschließen.
Diese Option ist standardmäßig deaktiviert.
Bei Verwendung des Handbuchs in einer Veröffentlichungsinstanz können die Komponenten und Funktionen als Site-Besucher (nicht angemeldet) und als Mitglieder mit verschiedenen Berechtigungen beim Anmelden angezeigt werden.
Wenn die SRP standardmäßig auf JSRP gesetzt ist, ist UGC, der in die Veröffentlichungsinstanz eingegeben wird, nur bei der Veröffentlichung sichtbar und *nicht *ist in der Konsole Moderation auf der Autoreninstanz sichtbar.
Die clientseitigen Bibliotheken (clientlibs), die für jede Komponente aufgelistet werden, sind die erforderlichen, auf die verwiesen werden soll, wenn die Komponente auf einer Seite platziert wird. Die clientlibs bieten eine Möglichkeit zum Verwalten und Optimieren des Downloads von Javascript und CSS, die zur Wiedergabe der Komponente im Browser verwendet werden.
Weitere Informationen finden Sie unter clientlibs für Communities-Komponenten.
Verwenden Sie für die Autoreninstanz, bei der einer häufig als Administrator oder Entwickler angemeldet ist, das Textfeld links neben der Schaltfläche Impersonate, um die Komponente als ein anderer Benutzer anzuzeigen, und klicken Sie dann auf die Schaltfläche, um den Benutzernamen einzugeben oder aus der Pulldown-Liste auszuwählen. Klicken Sie auf "Zurück", um den Identitätswechsel zu signalisieren und zu beenden.
Die Instanz im Veröffentlichungsmodus muss nicht imitiert werden. Verwenden Sie einfach den Link Anmelden/Abmelden, um verschiedene Benutzer zu imitieren, z. B. Demobenutzer.
Bei Aktivierung steht jede SCF-Komponente für die Prototypisierung möglicher Anpassungen zur Verfügung, indem die Vorlage, das CSS und die Daten der Komponente vorübergehend geändert werden.
Dieses Tool ist schreibgeschützt. Keine der an Vorlagen, CSS oder Daten vorgenommenen Änderungen werden im Repository gespeichert.
Um schnell mit Anpassungen zu experimentieren, muss die scg:showIde
Eigenschaft dem content-JCR-Knoten der Komponentenseite hinzugefügt und auf true gesetzt werden.
Verwenden der Kommentarkomponente als Beispiel für die Autor- oder Veröffentlichungsinstanz, die mit Administratorberechtigungen angemeldet ist:
Gehen Sie zu CRXDE Lite
Beispiel: http://localhost:4503/crx/de
Wählen Sie den Knoten jcr:content
der Komponente aus
Beispiel: /content/community-components/en/comments/jcr:content
Eigenschaft hinzufügen
scg:showIde
String
true
Wählen Sie Alle speichern
Laden Sie die Seite "Kommentare"im Handbuch erneut.
http://localhost:4503/content/community-components/en/comments.html
Beachten Sie, dass es jetzt 3 Registerkarten für Vorlagen, CSS und Daten gibt.
Wählen Sie die Registerkarte "Vorlagen", um die mit der Komponente verknüpften Vorlagen anzuzeigen.
Mit dem Vorlageneditor können lokale Bearbeitungen kompiliert und auf die Beispielkomponenteninstanz oben auf der Seite angewendet werden, ohne dass die Komponente im Repository betroffen ist.
Wenn Sie die Kompilierung auf lokalen Bearbeitungen ausführen, werden alle Fehler hervorgehoben, indem Sie einen Punkt in die Bundstege setzen und den Text rot markieren.
Wählen Sie die Registerkarte "CSS", um die mit der Komponente verknüpfte CSS anzuzeigen.
Wenn eine Komponente aus mehreren Komponenten besteht, kann ein Teil des CSS unter einer der anderen Komponenten aufgeführt werden.
Mit dem CSS-Editor kann das CSS geändert und auf die Beispielkomponenteninstanz oben auf der Seite angewendet werden.
Eine Regel kann ausgewählt werden, um die Teile des DOM mithilfe dieser Regel hervorzuheben, indem Sie neben der Regel im Bundstegen klicken.
Wählen Sie die Registerkarte "Daten", um die Endpunktdaten ".social.json"anzuzeigen. Diese Daten können bearbeitet werden und werden auf die Beispielkomponenteninstanz angewendet.
Syntaxfehler können in der Bundstege markiert und im Editor hervorgehoben werden.