Change log

Comments and Ratings

Allow logged-in users to post comments and ratings against items and/or respond to other user’s comments.

Promote engagement amongst your site members and allow users to give a star rating and comment on any module items you configure for Comments. Comment authors can edit or delete their own comments for full control over their content.

Comments can also be threaded, to show replies nested under their parent comments, or simply displayed as a flat list - sorted by date or other Comment properties.

Moderator controls and Workflow Notifications are also built-in for fine-grain approval control and management of Comments so that admins are notified of new Comments and can approve, decline, or mark as spam if needed.

The Comments module comes with complete interfacing and styles for both the Comment submission form and Comment/Rating layouts and logic, but can also be customised with your own Liquid layouts and styles.

Managing Comments

View

From the Comments list view you can see all Comments in a paginated table layout (with pagination controls at the bottom of the table) and a sortable column headers.

You can also filter the list via the inputs at the top of the table, where you can filter by date ranges, Comment 'Status' and 'Module'.

Additionally, you’ll find controls for editing and deleting Comments, as detailed further below.

Settings

You can access settings for the Comments under the "EDIT SETTINGS" menu which allow for fine-grain moderation and workflow configurations for each CMS module available in your site.

The setting options are described below:

Name
Description
Module Name
The name of the CMS module the settings apply to.
Moderation of the new Comments
If checked, moderation rules will apply for all NEW Comments made against items for the given module. This means that new Comments will be marked as 'Pending' and will need approval from site admins before being published to the website.
If unchecked, new Comments against the given module will be automatically approved and published.
Moderation of the edited Comments
If checked, moderation rules will apply for all EDITED Comments made against items for the given module. This means that existing Comments, that are edited on the website front-end by their authors, will be marked as 'Pending' and will need approval from site admins before being republished to the website.
If unchecked, edited Comments against the given module will be automatically approved and published.
Comments sending policy

Comment Once Only
A member will only be able to post one Comment per module item (including any Comments still pending or marked as spam for the given item).

Comments unlimited
A member will be able to post an unlimited number of Comments per module item.

Workflow notifications
Assign the Workflow/s to be triggered upon successful Comment submission.

Import / Export

Found under the main auxiliary menu (), you can import/export data to/from your Comments module where you can then further update your items in bulk using a spreadsheet application and re-import item data in an Excel file format (.xlsx).

If re-importing to update existing items, be sure to maintain the same 'ID' values from those exported items.

Export the current items in order to get a template import file you can use for importing new data. If you're starting from scratch, first create a dummy item with some sample data so you can see the import format needed.

Delete

Individual items can be deleted either by clicking the trash can icon () to the right of the item or when on the item's edit page, click the trash can icon () in the lower right of the page.

Additionally, you can make bulk selections from the item list view (by ticking the checkboxes on the left of each item) and click the "DELETE SELECTION" button that will appear at the base of the list view.

Editing Comments

From the Comments item list view, click on the pencil icon () of any existing item in the list to view/edit its details.

Currently, you cannot add a new Comment from this section. However, you can import Comments or add a reply Comment.

Upon viewing/editing an item you'll have access to the following data, as detailed below:

Details

The Comment-specific fields defining the Comment are described below:

Name
Description
Date
The date and time the Comment was created.
Module Item
The name of the module item the Comment was submitted against (this field is not editable).
Name
The name of the CRM Contact who submitted the Comment (this field is not editable).
Email
The email address of the CRM Contact who submitted the Comment (this field is not editable).
State
The moderation status assigned to the Comment.
Rating

A rating integer, between 0 and 100, representing a rating value for the module item.

The default Comment form includes a star rating system of 5 stars, with stars valued at 20, 40, 60, 80, 100 incrementally.

Comment
A multiline text field containing the body content of the Comment.

Replying to Comments

From the Comments item list view, click on the arrow icon () of any existing item in the list to create a reply Comment.

Displaying Comments

To render the Comments module on your website simply add one of the Comment component tags to your module item’s detail Layout.

You can generate the code for the component tag from the Component Manager, expanding the ‘Comments’ option and selecting either “Thread List” or “Flat List” and further configuring the components options as needed.

Thread List will display Comments with any reply Comments nested underneath the parent Comment. While Flat List will simply display all Comments in a single list.

The default output of these component tags will handle the display of Comments, styles and scripting logic to allow commenting to work for logged-in users. Including the display of the Comment submission form, edit, delete and reply links and all other interface elements.

By default, only the Comments list will be displayed for non-logged-in site visitors.

For more information on configuring the Comment component tags see the Related Articles below for both the ‘Comments’ and ‘CommentThreads’ articles.


Related Articles

  • Liquid Objects & Usage
    {{ member }} object
    This liquid object will output the Member's details of whom submitted a Form. You can...
  • Content Modules
    Secure Zones
    Secure Zones provide a way of creating restricted content on your website that only registered Secure Zone Members are able to access after successfully logging in.
  • Liquid Components
    member_update_form
    This component renders a contact update form for a specified CRM contact so that a CRM Admin role, who is logged in to the front-end, can update the specified contact’s CRM info or secure zone subscriptions.
  • Liquid Components
    commentThreads
    This component fetches a threaded list of Comments (and star ratings) assigned to a given module item along with the Comment submission form and author edit links for logged-in members.
  • Liquid Components
    comments
    This component fetches a single list of Comments (and star ratings) assigned to a given module item along with the Comment submission form and author edit links for logged-in members.
  • Liquid Components
    favorites
    The Favorites functionality allows logged-in users to save an item reference (from any module) to their account and render those items on a page for them to refer back to as needed.
  • Liquid Components
    frontend_API

External Resources

There are currently no external resources available.

Please let us know if you have any other contributions or know of any helpful resources you'd like to see added here.

Questions?

We are always happy to help with any questions you may have.
Visit the Treepl Forum for community support and to search previously asked questions or send us a message at support@treepl.co and we will consult you as soon as possible.