Comments Essentials comments-essentials
This page provides the fundamentals of working with the comment system (comments component) and options for managing the user-generated content (UGC) produced when members post comments or replies.
The comments component establishes a comment system such that each individual post is represented by a comment component (singular). It is the comment system which is included on the page. The comment system creates the individual comments when invoked.
Essentials for Client-Side essentials-for-client-side
One Instance Per Page one-instance-per-page
Pagination and the use of URLs for caching and linking require that the URL be unique per comment system. Therefore, only one instance of a comment system is allowed per page.
Other features already include the comment system. These are:
Flag Reason List flag-reason-list
The flagging reason list can be customized by adding flagreasonlist.hbs to your app to overwrite what is in
/libs/social/commons/components/hbs/comments/comment/flagreasonlist.hbs
This applies to any component which extends a comment system.
Essentials for Server-Side essentials-for-server-side
Accessing Posted Comments (UGC) accessing-posted-comments-ugc
UGC should be moderated using one of the standard methods for moderation.
See Moderating User-Generated Content.
As of AEM 6.1 Communities, use of a common store for UGC includes programmatic access to UGC regardless of the chosen storage option (such as ASRP, MSRP, or JSRP).
The location and format of the UGC in the repository is subject to change without warning.
See:
- Storage Resource Provider Overview - Introduction and repository usage overview.
- SRP and UGC Essentials - SRP utility methods and examples.
- Accessing UGC with SRP - Coding guidelines.
- SocialUtils Refactoring - Mapping deprecated utility methods to current SRP utility methods.