The 14.9 Release highlights improvements to Ratings and Reviews and Community Mobile v2, along with administration features to help drive greater community member engagement and give community managers more control over the communities they manage. This release includes new email templates and revamped documentation for Ratings and Reviews, along with video playback support for Community Mobile v2
New features and enhancements
- Rating and Reviews improvements
- Video playback support for Community Mobile v2
- Ability to disable spell check for search
- New permission for featuring TKB articles
- Include images and attachments with Salesforce cases
Ratings and Reviews improvements
Note: These Ratings and Reviews additions are available with Reviews Version 2. (Go to Studio > Features to set the Reviews feature version.)
Product review subscriptions and notifications
Community members can now subscribe to product reviews and receive email notifications about comments on the review conversations they participate in.
The subscription process for reviews is different than the process for other conversation styles in the community, such as forum discussions, where you subscribe to a particular topic within the community post.
In a forum, for example, a community member subscribes to a topic on a Topic Page or from a reply form. Because product reviews are displayed on a website’s product pages using ActiveCast widgets, community members create review subscription settings via their My Settings page in the community.
- Users who create a product review or comment on product reviews are automatically subscribed to it if Automatically subscribe me to all topics or reviews I participate in is selected in My Settings > Subscriptions & Notifications > Notification Settings.
- Users receive email notifications about comments posted about a product review they posted or commented on if Notify me when I post, reply, submit a review, or comment is selected in My Settings > Subscriptions & Notifications > Notification Settings.
Note: Administrators can configure these settings as default notification settings in Community Admin > Users > Notification Defaults.
Important: If these settings are not enabled, users will not be subscribed to product reviews nor receive email notifications about new review comments for reviews they subscribe to.
Helpfulness ratings notifications for reviews
Users can choose to receive email notifications when another community member rates a product review they posted as Helpful.
To enable helpfulness notifications for your community:
- Go to Community Admin > Features > Ratings.
- Select the Turn on Notifications for helpfulness
- Click Save.
Additionally, users must enable Helpfulness ratings on my reviews in My Settings > Subscriptions & Notifications > Notifications Settings.
Note: An administrator can configure the default setting for this in Community Admin > Users > Notification Defaults.
New review notification email templates
We have added two review notification email templates. You can edit the content of these templates in Studio > Text Editor > Email Text. For instructions on how to edit email text, see About email text and templates.
Note: These templates do not introduce new Velocity context objects.
Reviews notification email template
The Reviews notification email template (email_content.template.reviews.text) is sent when a user comments on a product review.
The system sends an email to community members subscribed to a product review when a user posts a comment to that review. If there is a URL set for the product being reviewed, then the notification email links to that URL. If there is not a URL configured for the product, then the template defaults to the product page in the community.
- Reviews must be enabled in Community Admin > Features > Reviews > Review Settings.
- To receive notifications of review comments, a user or administrator must have configured the following Notification Settings: Notify me when I post, reply, submit a review, or comment and Automatically subscribe me to all topics or reviews I participate in. A user sets these configurations in My Settings > Subscriptions & Notifications > Notification Settings. An administrator sets notification defaults for users in Community Admin > Users > Notification Defaults.
Helpfulness notification email template
The Helpfulness notification email template (email_content.template.helpfulness.text) is sent when a user rates a product review as helpful.
The system sends an email to the author of a product review when the product review receives a positive Helpfulness rating.
- Reviews must be enabled in Community Admin > Features > Reviews > Review Settings.
- Ratings must be enabled in Community Admin > Features > Ratings
- A user or administrator must have enabled notifications for Helpfulness ratings on reviews. A user will configure this in My Settings > Subscriptions & Notifications > Notification Settings. An administrator can set default notification settings in Community Admin > Users > Notification Defaults.
- Helpfulness must be configured as a rating style supported in the community. To do this, enter “helpfulness” in Community Admin > Features > Ratings > Supported rating styles.
Improved ratings and reviews API documentation
We have overhauled the API documentation for the Community API calls used with the Ratings and Reviews feature:
- Product
- ProductDiscussion
- Rating
- RatingSystem
- RatingsHistogram
- RatingHistogramEntry
- HelpfulnessRatingSummary
Also, check out our new Review data model article in the Developer Network. Visit the Ratings and Reviews section of our Documentation Knowledge Base for updated administrator documentation.
Deprecated APIs
We have deprecated two calls on the User resource that are tied to an outdated rating system:
- User/average_message_rating
- User/average_rating
Instead, we recommend using calls on User/reviews.
Video playback support for Community Mobile v2
The Community Mobile v2 media experience now supports playback of inline video content.
Learn more about uploading video.
Ability to disable spell check for search
You now have the ability to turn off spell check in the Search tool for your community. Typically, customers choose to disable spell check in search when they have terms that they don’t want spell check to auto-correct.
To enable or disable spell check in search for your community:
- Go to Community Admin > System.
- Click Search.
- Set the Turn on spell check option as needed.
- Click Save.
New permission for featuring TKB articles
You can now give users permission to feature or stop featuring articles in the TKB.
When a user features a TKB article, the article is displayed in the Featured TKB Article component:
Featuring articles is a great way to enable people to highlight specific content within a TKB. For example, you might want to promote a specific author, customer story, or solution for a support call driver.
Note: The article must include a teaser to enable it to be displayed in this component. Also, the most recently featured article is displayed at the top of the featured topics list.
To set the featuring TKB articles permission:
- Go to Community Admin > Users.
- Click Permissions.
- Scroll down to the Knowledge Base Articles group and set the Feature and stop featuring articles permission as needed.
- Click Save.
When enabled, you can feature the TKB article from the article options menu:
Include images and attachments with Salesforce cases
You can now enable users to be given the option to include inline images and attachments when escalating a topic to Salesforce.
Note: When enabled, this feature provides a checkbox where the user can choose to include all inline images and attachments to the case. Users cannot choose to include or not include individual items.
To enable users to attach images and attachments to Salesforce cases:
- Go to Community Admin > Mod Tools.
- Click Salesforce.
- Select Enable users to include inline images and attachments.
- Click Save.
You Found It. We Fixed It
- On certain topic pages on Mobile v2, the icon for flagging a message was missing, preventing users from flagging topics. This issue has been fixed.
- When users attempted to visit posts for closed groups via subscription notification URLs, they received an error instead of the sign in page. This issue has been fixed.
- Issues with regard to posts with labels not showing when filtering for posts with that label are now fixed. Now, when you filter for posts that use a particular label, the posts are displayed in the filter results.
- Previously, if you included an at-sign (@) in an FAQ question text key, Studio Publish would be disabled. This issue has been fixed.
- Previously, if you tried to add a label to a forum post using Internet Explorer 8 or 9 resulted in the label not being added to the post, even it labels are required post in the forum. This browser-specific issue has been fixed.
- The issue with a user ban being released when switching between a “login ban” and an “IP ban” has been fixed. Now, the ban continues to function properly, regardless of the new ban criteria.
- When choosing to “Send Email to Self” from Studio to test how an email template looks, the HTML version of the email template was always being sent, even if you set the admin user preference to send the plain text version. This issue has been fixed.
- When the “Display rich content from pasted URLs” setting under Community Admin > Posts & Topics is enabled, posting certain URLs produced a “Please enter a valid URL” error message. This issue has been fixed and valid URLs no longer produce this error.
- We have fixed the issue where the REST API call <DOMAIN>/restapi/vc/posts/count returns the wrong number of posts.
Refer to the attached Known Issues list for an update on open issues that we’re currently investigating.
Review release notes and updates for all of our products! Select a label to browse by product or resource type.