The calendar feature supports providing community event information in a calendar format either to all site visitors or only signed in site visitors (community members), while only authorized members may add events.
This section of the documentation describes
- adding the calendar feature to an AEM site
- configuration settings for Calendar components
To add a Calendar component to a page in author mode, use the component browser to locate
- Communities / Calendar
and drag it into place on a page, such as a position relative to the feature for users to review.
For necessary information, visit Communities Components Basics.
When the required client-side libraries are included, this is how the Calendar component will appear.
Select the placed Calendar component to access and select the Configure icon which opens the edit dialog.
- Events Per Page
Defines the number of evens shown per page. Default is 10.
If checked, posting of calendar events and comments must be approved before they will appear on a publish site. Default is unchecked.
If checked, the calendar is closed to new event entries and comments. Default is unchecked.
- Rich Text Editor
If checked, calendar events and comments may be entered with markup. Default is checked.
- Allow Tagging
If checked, allow members to add tag labels to the events they post (see Tag field tab). Default is checked.
- Allow File Uploads
If checked, allow file attachments to be added to a calendar event or comment. Default is checked.
- Allow Following
If checked, allow members to follow events posted to the calendar. Default is checked.
- Max File Size
Relevant only if Allow File Uploads is checked. This field will limit the size (in bytes) of an uploaded file. Default is 104857600 (10 Mb).
- Allowed File Types
Relevant only if Allow File Uploads is checked. A comma separated list of file extensions with the "dot" separater. For example : .jpg, .jpeg, .png, .doc, .docx, .pdf. If any file types are specifed, then those not specified will not be allowed to be uploaded. Default is none specified such that all file types are allowed.
- Max Attach Image File Size
Relevant only if Allow File Uploads is checked. Maximum number of bytes an uploaded image file may have. Default is 2097152 (2 Mb).
- Allowed Cover Image Types
A comma separated list of image file extensions with the "dot" separater. Default is .jpg,.jpeg,.png,.gif,.bmp.
- Allow Threaded Replies
If checked, allow replies to comments posted to the calendar event. Default is checked.
- Allow Users to Delete Comments and Events
If checked, allow members to delete the comments and calendar events they posted. Default is checked.
- Allow Voting
If checked, include the Voting feature with a calendar event. Default is checked.
- Show Breadcrumbs
Show breadcrumbs on event page. Default is checked.
- Date Range Filter
Defines the number of days added to the current date in order to compute the "To" value of the calendar event listing page filter. Default number is 30.
- Allow Featured Content
if checked, the idea is able to be identified as featured content. Default is unchecked.
Under the User Moderation tab, specify how the posted topics and replies (user generated content) are managed. For more information, see Moderating User Generated Content.
- Deny Posts
If checked, trusted member moderators will be allowed to deny posts and prevent the post from appearing on the public forum. Default is checked.
- Close / Reopen Events
If checked, trusted member moderators may close an event to further edits and comments, and may also reopen an event. Default is checked.
- Flag Posts
If checked, allow members to flag others' events or comments as inappropriate. Default is checked.
- Flag Reason List
If checked, allow members to choose, from a drop-down list, their reason for flagging an event or comment as inappropriate. Default is unchecked.
- Custom Flag Reason
If checked, allow members to enter their own reason for flagging an event or comment as inappropriate. Default is unchecked.
- Moderation Threshold
Enter the number of times an event or comment has to be flagged by members before moderators are notified. Default is 1 ( one time).
- Flagging Limit
Enter the number of times an event or comment has to be flagged before it is hidden from public view. If set to -1, the flagged topic or comment is never hidden from public view. Else, this number must be greater than or equal to the Moderation Threshold. Default is 5.
Under the Tag field tab, the tags which may be applied, if allowed under the Settings tab, are limited according to namespaces chosen.
- Allowed Namespaces
Relevant if Allow Tagging is checked under the Settings tab. The tags which may be applied are limited to those within the namespace categories checked. The list of namespaces includes "Standard Tags" (the default namespace) as well as "Include All Tags". Default is none checked, which means all namespaces are allowed.
- Suggestion Limit
Enter the number of tags to be displayed as a suggestion to the member posting to the forum. Default is -1 (no limits).
Visit Administering Tags to learn how to add a new tag namespace (taxonomy).
Under the Translation tab, if translation is enabled for the community site, translation may be set to translate the entire thread (event and comments) instead of specific posts.
- Translate All
If checked, the event and comments are translated into the user's preferred language. Default is checked.
In the publish environment, the calendar feature will display a search field with a default date range, and any calendar events which fall within that range.
When a calendar event is selected, the calendar event details, description and comments are displayed.
Other abilities depend on whether the site visitor is a moderator, administrator, community member, privileged member or anonymous.
When the signed in user has moderator or administrator privileges, they are able to perform moderation tasks (as permitted by the configuration of the component) on all calendar events and comments posted to an event.
When the signed in user is a community member or privileged member (depending on configuration), they are able to select New Event to create and post a new calendar event.
Specifically, they may
- create a new calendar event
- post a comment to a calendar event
- edit their own calendar event or comment
- delete their own calendar event or comment
- flag others' calendar events or comments
Site visitors who are not signed in may only read posted calendar events, translate them if supported, but may not add an event or comment nor flag others' events or comments.
More information may be found on the Calendar Essentials page for developers.
For moderation of calendar events and comments, see Moderating User Generated Content.
For tagging calendar events and comments, see Tagging User Generated Content.
For translation of calendar events and comments, see Translating User Generated Content.