Lithium Community 18.3 Release Notes

New Features 

• Product Catalog Importer and Product Editor improvements
• Changes to attachment MIME type validation
• User Statistics component added to the Page Tab Components list 
• GDPR support enhancements 
  • GDPR self-enablement 
  • Retrieve Personally Identifiable Information (PII)
  • Delete Personally Identifiable Information (PII)
  • Download your community content and personal information 
  • Delete device identifiers from your account 
• Export Case Portal cases to a CSV file 

Product Catalog Importer and Product Editor improvements 

You can now add the following product details in the Community Admin Product Editor and with the Product Catalog Importer: 

• Manufacturer: You may use alphanumeric characters, Unicode characters, dots, dashes, and underscores 
• Product Price: Decimals are allowed, but not required 
• Currency: ISO 4217 compliant 
• Availability: Available or Unavailable. Custom values are not supported. 

About currency and price display

We require customers to import/enter:

• numeric values – numeric values up to 2 decimal places
• currency ISO codes (see below)

We will display currency and price value in the appropriate format as determined by:

• Currency ISO code
• Locale

For example, this means that a customer can add prices to the system via API, Admin, or XML by setting the price value field to 1999.99 and not 1,999.99 (not a number) AND the currency value to EUR. When rendered in a French community, the currency should display as 1999,99€.

 

For complete details, see Integrate your product catalog (if using the XML-based Product Catalog Importer) or Add, edit, or delete a product using Community Admin (if using Community Admin).  

Changes to attachment MIME Type validation 

As of 18.3, attachments must meet the following requirements to pass validation:  

• Match the MIME type expected from the attachment file extension 
• Match MIME types of attachment file extensions defined by the File extensions for attachments setting in Community Admin > System > File Attachments.  

No changes have been made to image MIME type validation. 

User Statistics component added to the Page Tab components List 

The User Statistics component (users.widget.single-statistic) displays user metrics such as the number of overall posts, accepted solutions, kudos by or for a user. We describe how to use and configure this component in Configure the Community Metrics and User Statistics components. Prior to this release, the User Statistics component did not appear in the Components list in the Page tab in Studio. You can now find the component under the User Profile section of the Components list. 

 

GDPR support enhancements 

Still in Limited Release, Lithium's support for GDPR (General Data Protection Regulation) now includes these new features:

• Ability to enable/disable GDPR from Community Admin 
• Retrieve Personally Identifiable Information (PII)
• Delete Personally Identifiable Information (PII)
• Download your community content and personal information 
• Delete device identifiers from your account 

Learn more about GDPR. 

 

Ability to enable or disable GDPR from Community Admin 

With the 18.3 Release, GDPR (General Data Protection Regulation) is still available to customers in a limited capacity. Contact Lithium Support to discuss your needs. After the Support team has enabled GDPR for your community, you can turn it on/off yourself directly from Community Admin.

 

To enable/disable GDPR from Community Admin: 

1. Sign in to the community as an Admin. 
2. Go to System > Admin. 
3. Select or clear the Enable GDPR setting. 
   
   
4. Click Save. 

 

Retrieve Personally Identifiable Information (PII)

To view and edit your PII data:

1. Sign in to Community.
2. Go to Profile > My Settings > Personal.

Delete Personally Identifiable Information (PII)

 You can delete your user’s data in two ways:

• Delete API: Use the delete API to delete a single user or a set of users, using the User ID(s).
  To learn more about this API, see the GDPR Community API support documentation.

• Close Account: You can also delete a user’s PII directly from the user's profile in the community.
  This feature is available under My Settings > Personal > Close Account in the user’s profile.

Note: The Close Account option appears in the My Settings page, only if you have enabled this feature for your users.
To learn more about this option, read Enable community members to close their own accounts section.

When PII deletion is initiated, a user’s profile is permanently anonymized, and their content is attributed to an “Anonymous User”. The “Anonymous User” has a standard username and a default avatar to distinguish the profile from other users. The deleted data includes only the PII of the user, while the user's contributions (posts, comments, kudos, and so on) will be maintained as, and associated with, an anonymous user.

 

Download your community content and personal information 

When GDPR is enabled, community members can opt to download their community content and personal information associated with their account for offline storage/reference. Community members who decide to leave the community can download this content before they close their account. 

To download your Community Content and Personal Information: 

1. Sign in to the community. 
2. Open the user menu and click My Settings. 
   
   
3. Go to Personal > Personal Information. 
   
   
4. Scroll to the bottom of the page and click one or both of the download links: 
    

Your file is downloaded to your desktop as a machine-readable .json file.   

 

Delete device identifiers from your account 

When GDPR is enabled on your community, members can opt to delete device-related information from their account, specifically the IP addresses which have been used by this account and the mobile device associated with the account. 

To delete personal device information from your community account: 

1. Sign in to the community. 
2. Open the user menu and click My Settings. 
   
   
3. Go to Personal > Personal Information. 
   
   
4. Scroll to the Device Identifiers section. 
5. To delete the IP addresses used by this account, click Delete next to the list of IP addresses. 
   
   
6. To delete the mobile device associated with this account, click Delete next to the Mobile Device name. 
   Note: If you delete your Device ID, you will no longer receive notifications from the community app to your mobile device. Notifications will be restored the next time you sign in to the community app. 

 

Export Case Portal cases to a CSV file 

You can export all the cases in your Case Portal implementation to a .csv file. Although you can filter the Case Portal search results based on Origin, Type, and so on, your downloaded file will contain all the cases that are currently available in the Case Portal, regardless of any filter you might have applied. 

Note: You must have Case Portal admin permissions to use this feature. 

To export cases to a CSV file: 

1. Sign in to the community as an Admin. 
2. Go to the Case Portal home. 
3. Click Export CSV.   

Known Issue: Names of any custom case fields you have created display their corresponding API names (not the custom field names you defined) in the downloaded CSV columns headers. 

 

API Changes 

Note:  Community API v2 updates in these release notes will appear in the API reference documentation on the Developer Documentation Portal once the Lithium Community has been updated to release 18.3. This means that you might not see the changes listed in this section immediately.

 

We have made changes to the following Community API v2 resources: 

• Product 
• Price 
• User 

Product Resource updates 

We have added the following fields to the Product resource: 

• manufacturer 
• price 
• availability 

See the Product resource documentation for details 

Price Resource 

We have added a new Price resource that represents the currency and value of a product price. See the Price resource documentation for details.   

User Resource updates 

We have added a new datetime field, deleted_time, to the User resource. You can use this field in the WHERE clause to constrain queries to user accounts deleted within a specified time range. The field requires that your community has the Close Account feature enabled. The Close Account feature is enabled by Lithium Support.  See the User resource documentation for details. 

You Found It. We Fixed It. 

• When publishing Community changes with Studio Publish, all nodes are now being updated properly. We also made updates to improve request throughput while reading Studio Plugin assets and improve the reliability and stability of Studio Publish. 
• Clicking or selecting Forgot username or password on the Community sign in page, and then selecting the Reset Password link, now takes the user to the Reset Password page as expected. 
• We have resolved an issue with mime type validation for attachments. The validation now works correctly. See Changes to Mime Type Validation under the New Features section above for more details. 
• We fixed a similar issue with mime type validation where customers were receiving invalid file type errors for mime types that were whitelisted. 
• Community users can now upload images to Image Contest comments. 
• We fixed an issue where JavaScript displayed in Masonry cards instead of a video preview when a video was placed in the message body or teaser. Video previews now display correctly in Masonry cards. Note that teaser text is used instead of video preview if the body contains a video, but the teaser contains only text. 
• Community users who use Facebook login for Community access, and then delete their Community accounts can now create a new Community account using Facebook credentials without experiencing any Community access issues.