Configuring Reviews

Select the placed Reviews component to access and select the Configure icon which opens the edit dialog.

Under the Allowed Ratings tab, specify the complete list of ratings to be shown to members. The first rating should be an overall/general rating, as it is the rating which provides the average rating for the Review Summary (Display) component. The next two ratings in the default configuration should be given a different title, other than "Subrating 1" or "Subrating 2".

Allowed Ratings
A list of ratings from which a member can choose.
Use the up arrow, down arrow and delete buttons to modify the visible selections.
Click Add Item to add another rating choice.

Under the Required Ratings tab, re-enter items from the list of Allowed Ratings that are required to be rated. If an item is only specified on the Allowed Ratings tab, it may be left unmarked when submitted by the member.

On the website, required ratings are marked with an asterisk. If an item is required and left unmarked, a message is displayed to the member and the submission is denied until all required ratings are marked.

Required Ratings
A subset of allowed ratings, indicating which ratings are required.
Use the up arrow, down arrow and delete buttons to modify the visible selections.
Click Add Item to add another response choice.

Observação:

If an item is entered on the Required Ratings tab that is not specified on the Allowed Ratings tab, then it is not included in the items to rate.

Closed
If checked, the review is closed to new reviews and replies. Default is unchecked.

Allow File Uploads
If checked, allow file attachments to be uploaded for the review. Default is unchecked.

Max File Size
Relevant only if Allow File Uploads is checked. This field limits the size (in bytes) of an uploaded file. Default is 10 MB.

Max Message Length
Maximum number of characters that may be entered into the text box. Default is 4096 characters.

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. Default is none specified such thatall file types are allowed.

Rich Text Editor
If checked, posts may be entered with markup. Default is unchecked.

Allow Voting
If checked, include the Voting feature for a topic. Default is unchecked.

The "Average" reflects the votes for the first item listed on the Allowed Ratings tabs of the review being summarized.

Configuring Reviews Summary (Display)

Select the placed Reviews Summary (Display) component to access and select the Configure icon which opens the edit dialog.

Under the Review Summary tab

Review Path
enter or browse to the placed instance of the reviews component to summarize, for example, if added to the Web Page of the Geometrixx Engage site, the path would be :
/content/sites/engage/en/page/jcr:content/content/primary/reviews

Include histogram
If checked, include the display of a bar graph indicating how many of each star rating there are in the reviews being summarized. Default is unchecked.

Changing to a Custom Review Type

The Reviews component uses the Comment System.

By changing the Comment Resource Type, the comment system will no longer generate an instance of a comment using the default, but rather one that has been customized (extended) by developers.

Once the custom resource types is known, enter Design Mode and double click on the placed Comments component to open a dialog with an additional tab.

Under the Resource Types tab, specify the custom resourceType for new instances of the Comments or Voting components :

Comment Resource Type
Navigate to the resourceType of an extended comment component (single comment) in /apps. For example, /apps/social/commons/components/hbs/comments/comment
This resource will identify the resourceType of the UGC created when a visitor posts a comment.

Voting Resource Type
Navigate to the resourceType of an extended voting component in /apps. For example, /apps/social/components/hbs/voting
This resource will identify the resource type of the UGC created when a visitor posts a vote.

Comment System Resource Type
Navigate to the resourceType of an extended comments component (Comment System) in /apps. Leave blank unless the page template dynamically includes the Comment System in the underlying script instead of being added to the page as a resource (comments node). Learn more by reading about the {{include}} helper

Site Visitor Experience

Moderators and Administrators

When the signed in user has moderator or administrator privileges, they are able to perform the moderation tasks permitted by the configuration of the component, regardless of who authored the review.

Members

When the site visitor is signed in, depending on the configuration, they may

post a new review

edit their own review

delete their own review

flag others' review comments

Only one rating per member is allowed. The member may change their rating at any time.

Anonymous

Site visitors who are not signed in may only read posted reviews, translate them if supported, but may not add a rating or a review, nor flag others' review comments.