16.2 Release Notes

Khoros Alumni (Retired)

10 years ago

In the 16.2 Release, we’ve continued to make enhancements to some key feature areas that improve the community member and admin experiences. Key features included in this release are user account management, Featured Threads, user profile settings, the LSI bulk data API, our FreeMarker context objects, and the Lithium-Klout SDK.

New Features
Bug Fixes

New Features

Enable one user to close account user’s account
Set the display order for Featured Threads
Updates to the My Settings page
Additions to LSI Bulk Data API
New FreeMarker context object
Submit email templates with the Lithium-Klout SDK (Open Beta)
Wrap components in a div container

Enable one user to close another user’s account

We have added a new user management permission that enables permissioned users to close another user’s account without having to first “switch” to that user’s account. This new permission is denied to users (except Admins) by default, and you should only grant this permission to a few, trusted users--most likely the site admin and/or a senior moderator.

To enable a user to close the account of another user:

Sign in to Community Admin as an Admin.
Go to Users > Permissions.
Click Roles.
Click Edit next to the role.
Scroll down to the User Management section.
Grant the Close other users’ accounts permission.

Note: The user must also be granted the Manage Communities permission.
Click Save.

With this permission, you do not need to switch to another user to close that user’s account.

To close another user’s account:

Go to Community Admin > Users > Edit Users.
Enter the name of the user or the user’s ID and click Select User.
Enter the username of the account you want to close.
Click Close Account.

You will be prompted to enter your username to close the account.

Set the display order for Featured Threads

In the 15.4 release, we added the ability for you to manually sort the display order for TKB articles in a knowledge base. We have now extended this functionality to Featured Threads. Previously, you could sort Featured Threads only by Date or Kudos. Now, you can choose to sort these threads manually so they appear in a specific order in the Featured Threads component.

To sort Featured Threads manually:

Sign in to Community Admin.
Go to Content > Featured Threads.
If needed, click Choose and go to the node where you want to sort Featured Threads.
Click the Ordering tab.
Click the Manual sort option and click Save.
Click and drag Featured Threads up and down into the order you want them to appear on your community site. (Alternatively, you can enter the number in the Article Order column and click Enter on your keyboard.)

Note: If no topics appear in the list, no topics have been set to be featured. Learn how to feature a topic so it appears in this list.
When you are happy with the order of the topics, click Save Order at the bottom of the list.

Note: To revert the list back to the original order, click Reset before clicking Save Order.

Your changes are reflected in the Featured Threads component on your live community site.

Note: When new topics are added to the Featured Threads list, they are added to the bottom of the list, until you manually move it to a new position.

Learn more about Featured Topics and how to display them on your community.

Updates to the My Settings page

We have renamed and moved the Personal Profile and Social Connect tabs in the user My Settings section. Specifically, we have renamed Personal Profile to Personal and Social Connect to Social and moved them to be next to each other.

We’ve made these changes to simplify the language and co-locate these settings in preparation for other changes we’ll be rolling out in future releases.

Additions to LSI Bulk Data API

We have added new fields to the LSI Bulk Data API to enable users to now query for SSO ID, Geography, and Unique ID, as follows:

user.sso.id: SSO ID of user taking action, if SSO ID is available
document.id: Unique identifier for each event
request.geo.city: City of user taking action converted from browser IP using IP2Location DB 11
request.geo.country_code: Two-character country code from ISO 3166 of user taking action converted from browser IP using IP2Location DB11
request.geo.geohash: Geohash using latitude and longitude of user taking action converted from browser IP using IP2Location DB11
request.geo.postal: Zip/postal code of user taking action converted from browser IP using IP2Location DB11
request.geo.region: Region or state name of user taking action converted from browser IP using IP2Location DB11
request.geo.timezone: + or - hour offset from UTC of user taking action converted from browser IP using IP2Location DB11
request.geo.latitude: Latitude of user taking action converted from browser IP using IP2Location DB11
request.geo.longitude: Longitude of user taking action converted from browser IP using IP2Location DB11

Learn more about Using the LSI Bulk Data API.

New method on http.response FreeMarker context object

If you use customized URLs in your community, you can set the canonical URL link element on the response using http.response.setCanonicalUrl(http.request.url). This method takes the request URL and sets it as the canonical URL to improve search engine optimization (SEO).

Note: This method, like other http.response methods that set something on the response, can be used only in the Page Initialization Script.

Let’s looks at an example. By default, Lithium enables you to filter on a single label, but some communities want to filter by multiple labels. You can filter by multiple labels by passing them in the request URL. A request URL for the Idea Exchange Page that filters on ideas with the labels "woodworking" and "furniture" looks something like this:

https://example_community.com/t5/IdeaExchangePage/idb-p/your_project_gallery/label-name/woodworking/label-name/furniture/page/2

This customized URL is supported; however, by default, Lithium includes only the first label in the canonical link element on the response:

Stripping the second label name can impact SEO for the community.

The code snippet below shows how to use http.response.setCanonicalUrl(http.request.url) to set the request URL as the canonical URL using FreeMarker code in your Page Initialization Script:

<#if page.name = "IdeaExchangePage" >

${http.response.setCanonicalUrl(http.request.url)}

</#if>

With this code in place, the canonical link element in the response includes both labels as passed in the request.

Submit email templates with the Lithium-Klout SDK (Open Beta)

This feature is released in Open Beta. We now support submitting email templates to your stage server using the Lithium-Klout SDK. Localized templates are supported. Note that the icons, alerts, and confirmations used to identify email templates in the SDK plugin which prevent Studio overrides are not implemented at this time.

For instructions on how to submit email templates, see the SDK documentation and go to Develop > Customize.

Wrap components in a div container

We’ve added documentation for a way to wrap components in a div container with a specified class name directly in a page quilt. Read about this feature in the Developers Knowledge Base.

You Found It. We Fixed It.

We have fixed the issue where you received an error when trying to view drafts or unpublished revisions of a TKB article from the TKB dashboard.
We have fixed the issue where the private note notification email was always using the “alternative” content type, even when the Plain text option was selected under My Settings > Subscriptions & Notifications > Email Format. Now, the text version of the email is set when this option is selected.
Previously, when the reason notifications feature was enabled, and you clicked the Cancel button while editing a message/thread (Options > Edit Message), you received an unexpected error. This issue is now resolved.
Responsive fix: We have fixed the issue where the User Slide Out menu did not open when the Community Navigation widget was not also on the page.