Content
Bulk content archive (Early Access)
- Granular permissions to edit published blog articles
- Allow Co-Authors to edit published Blogs and TKB articles
- Userid field added to Bulk Download Member Data report
- Bulk Data API v2.0
- Bulk content archive (EA)
- Allow co-authors to edit published articles
- Contributor types accessible through LiQL
- Attachments in Private Message
New Features
Bulk content archive (Early Access)
We are happy to announce that we’ve extended the Content Archive feature to include support for archiving content in bulk.
With the initial Content Archive release, you could archive only one article at a time. With bulk archive, you can archive multiple articles at once, making it easier to keep your content organized and up-to-date.
With bulk archive, you can:
- Specify criteria to search for specific community content.
- Review the matching content and select all matching results or select one or more specific articles from the list.
- Archive the selected posts in bulk.
Enablement
To be considered for the Early Access (EA) program, contact your CSM. If selected, your CSM will work with the Support team to enable the feature.
Once enabled, you can turn on/off the feature from the Admin panel. Go to ADMIN > Mod Tools > Content Archive > Turn on content archive.
Note:
- If the Bulk Content Archive has not been enabled for your instance and the admin setting Mod Tools > Content Archive> Turn on content archive is turned on, you can archive only one content at a time.
- You can only restore or unarchive posts one at a time from the Archives page. There is no option to unarchive posts in bulk.
- All bulk archived content is moved to your community’s Archive Page.
Check out this video to get an overview of the Bulk Archive feature. The video shows how you can bulk archive content from a TKB board with articles created at least one month ago, with no more than two views and no replies in the past one month.
Bulk content archive
1. Click the Archives link under the Community dashboard on your community home page
2. Hover the Options menu
3. Click Bulk Archive
4. You will land on the Bulk Archive tool page.
Choose from where you want to archive content.
5. In this example we choose Hi-Fi Products
6. Select the type of posts you want to archive.
7. In this example we choose TKB
8. Select how old the posts that you want to archive are.
9. In our example, we select posts that were created at least 1 month ago.
10. Enter a valid number for Maximum Views for the posts that you want to archive. This will enable the In the Past dropdown.
11. In this example, we enter 2
12. Select a timeframe for the views.
13. In this example, we select 1 month, which means that the posts must have had a maximum of only two views in the past one month.
14. Select a timeframe for which the posts have not had any replies within the time frame selected in the Created At Least and In the Past dropdowns.
15. in this example, we select 1 month, which means that the posts have had no replies in the past 1 month.
16. In our example we leave the Author filter empty Click Search.
17. A row is added to the Job table as shown. The STATUS column shows that the job is currently searching the community for the filters submitted.
18. You must refresh the Bulk Archive page to check the STATUS change of the job.
The STATUS changes to Ready to archive when the search completes and has fetched results.
Click Ready to archive.
19. You will land on the Search Results page, which displays the posts retrieved for the job submitted.
From here, you can either archive a few or all posts retrieved.
20. If you want to archive only a few posts, select only those posts.
The number of posts you select are displayed.
21. Click Archive Selected.
22. Click Next.
23. Click Archive.
24. The selected post is queued for archival.
25. If you want to archive all posts in one go, click Archive All.
26. Click Next.
27. Click Archive.
28. All posts are queued for archival.
29. Scroll up and click Bulk Archive.
30. The STATUS column for this job now shows that all posts are archived to the community's Archive page.
Here's an interactive tutorial
Click the icon in the top right corner before you begin, for best experienced in Full Screen.
Bulk Content Archive
1. On your community page, select the discussion board from where you want to bulk archive.
In our example we select a TKB board.
2. You will land on the selected board page.
3. Hover over the Options menu.
4. Click Bulk Archive
5. Since you landed on this page from the TKB board, the values for Location and the Type of Post are pre-selected.
However, you can always choose a different Location and Type of Post from here.
6. Select how old the posts that you want to archive are.
7. In our example, we select posts that were created at least 1 month ago.
8. Enter a valid number for Maximum Views for the posts that you want to archive. This will enable the In the Past dropdown.
In this example, we enter 2
9. Select a timeframe for the views.
10. In this example, we select 1 month, which means that the posts must have had a maximum of only two views in the past one month.
11. Select a timeframe for which the posts have not had any replies for.
12. In this example, we select 1 month, which means that the posts have had no replies in the past 1 month.
13. In our example we leave the Author filter empty
14. Click Search
15. A row is added to the Job table as shown. The STATUS column shows that the job is currently searching the community for the filters submitted.
16. You must refresh the Bulk Archive page to check the STATUS change of the job.
The STATUS changes to Ready to archive when the search completes and has fetched results.
Click Ready to archive.
17. You will land on the Search Results page, which displays the posts retrieved for the job submitted.
From here, you can either archive a few or all posts retrieved.
18. If you want to archive only a few posts, select only those posts.
The number of posts you select are displayed.
19. Click Archive Selected
20. Optionally, enter the URL of the related content. When you attempt to view archived content (via a permalink or bookmark) you will be directed to this content.
In our example, we will leave this field empty.
Click Next
21. Click Archive
22. The selected post is queued for archival.
23. If you want to archive all posts in one go, click Archive All.
24. Click Next
25. Click Archive
26. All posts are queued for archival.
27. Scroll up and click Bulk Archive.
28. The STATUS column for this job now shows that all posts are archived to the community's Archive page.
Here's an interactive tutorial
https://www.iorad.com/player/1877100/Bulk-content-archive
https://www.iorad.com/player/1868612/Bulk-content-archive
Related articles:
- Learn more about the Bulk Content Archive feature
- Here’s an example of how the feature works
- Learn more about enabling the feature.
Enhancements
Granular permissions to edit published blog articles
Prior to this release, there was no way to restrict members to only edit published blogs. Members had to be granted the “Manage own article” or “Manage all articles” permission to edit blogs after they are published. This enabled members with these permissions to perform other content actions (delete, move and so on).
With this release, we introduce two new permissions that enable members to only edit published blogs, and then take them through the publishing workflow process.
- Edit my published blog posts: This permission is tied to the BlogAuthor role. Members with the BlogAuthor role can edit their published blogs and send the edited version for review.
- Edit all published blog posts: Members with this permission and the Start new articles permission can edit their blogs and those published by other members and send the edited version for review.
Note:
- You must be on Blogs version 3.1 to use these new permissions. Go to Studio > Features and select 3.1 for the Blog version.
- Once you have updated to Blogs v3.1, you must deny Manage own articles permission in the BlogAuthor role. BlogAuthors will have Edit my published blog posts permission by default.
Related articles:
Allow Co-Authors to edit published Blogs and TKB articles
Co-Authors of Blogs and TKB articles can now edit published articles. To do this,
- Co-Authors of blogs must have the Edit my published blog posts permission.
- Co-Authors of TKBs must have the Edit my published TKB posts permission.
Note:
- For Blogs, you must be on Blogs version 3.1 to use these new permissions. Go to Studio > Features and select 3.1 for the Blog version.
- For TKBs, you must be on TKB version 4.1 to use these new permissions. Go to Studio > Features and select 4.1 for the TKB version.
Userid field added to Bulk Download Member Data report
With this release, we are adding the "Userid" field to the "Bulk Download Member Data" report. This field retrieves members' community userid and helps community managers identify the partially registered users who registered without a username.
Learn more about community member metrics
Security Announcement
As part of our efforts to continuously improve the security of our applications, Khoros will be upgrading our Web Application Firewalls (WAFs) for all customers over the next few months. These advanced WAFs provide enhanced capabilities that will enable us to better prevent bad requests from hitting applications earlier in the process, thereby improving the stability, reliability, and security of your communities.
While the rules and filters have been vetted and tested, due to the nature and customizability of the Community platform, there is a small risk that there could be some level of unexpected impact. Issues caused by the WAF could result in end-users receiving a 403 forbidden response to an operation. Contact Support if you see this behavior and provide as much detail as possible about the action you were taking and the timing of that action (including timezone information).
The change will first be rolled out to all stage instances and after a few weeks, we will roll out changes to production instances in batches.
API Updates
Bulk Data API v2.0
We are happy to announce the launch of Bulk Data API v2.0 with this release. The Bulk Data API v2.0 brings more user-actions and associated fields along with the existing actions and fields.
Note: This new version will be available on November 8, 2021.
Bulk Data API now includes this information:
- Subscriptions
- Private messaging
- Idea status change
- Event discussion style
- Group hub interactions
- 'Me too' user action
- Product associations
- Search metric enhancements
- TKB helpfulness rating
- Archival action
- User Rank changes
The earlier version, v1.0, is still available. We will announce the deprecation of v1.0 in a future Community Release Notes.
There are schema changes associated with Bulk Data API v2.0, and fields have also undergone re-ordering. We recommend updating the data store according to the schema changes before querying Bulk Data API V 2.0.
The new version supports exporting data belonging to past time ranges.
Note that, these newly added action keys and associated fields will be fully available for date ranges post Nov 8, 2021. Which means that, when data for a past time range is pulled using Bulk Data API v2.0, all the currently available action keys and corresponding fields will be present. However, the newly added action keys and associated fields may not be fully available for past date ranges.
For detailed information on Bulk Data API v2.0 action keys and fields, refer to the Bulk Data API v2.
Bulk content archive (EA)
With the introduction of the Bulk Content Archive feature, we also provide Bulk Content Archive APIs to archive content in bulk.
Use these APIs to:
- Create bulk archive processes
- Retrieve details on currently running archiving processes
- Get the number of posts retrieved for the search filters applied
- Retrieve all results
- Delete and cancel a bulk archive process
To learn more, see bulk content archive and the archive bulk content use case.
Allow co-authors to edit published articles
As mentioned earlier, Co-Authors of Blogs and TKB articles can now edit published articles. We also introduce APIs to achieve the same. All permissions and versions changes are applicable to use APIs, as mentioned in this section.
To learn more about these APIs, see Edit blog and KB articles after publication
Contributor types accessible through LiQL
The current API to retrieve the contributors for TKBs and blogs returns both the co-authors and contributors together. With this release, we introduce a new constraint to list the co-authors and contributors separately.
This new constraint, called messages_contributed.contributor_type, is added to the user object with two acceptable values:
- co-author
- contributor
Learn more about the messages_contributed.contributor_type.
Attachments in Private Message
We have updated the threaded private message POST/notes_threads with the attachments field.
You Found it. We Fixed it!
General Fixes
- We have fixed the issue where the RSVP links to No and Maybe were missing for languages other than English in Events version 1.2. This issue has been fixed on both the main page of the event and in private messages.
- Earlier, comments or replies in Blogs v3 made via Khoros Care or API v1 did not appear on the community page. We have fixed this issue.
- We have fixed the issue where the search page displayed a misleading message saying “No search results found” even before entering a search keyword.
- Earlier, the thumbnails for all videos uploaded before the migration from Ooyala to Brightcove were missing. This issue is now fixed. All videos uploaded before the migration are accessible.
- The issue that the comment box for comment syndication did not load on the external website is now rectified.
- The issue that topics from the community were not automatically escalated to salesforce is resolved.
- In communities where the Search Subscription and Email Metrics is enabled, the “change and discontinue your search” link in the Search Subscription emails were redirected to an error page. This issue is now fixed.
- The issue that, when Admins changed the "Any edits & comments on knowledge bases articles I subscribe to" settings under the Admin > Users > Notification defaults, they were not updated, is now fixed.
- Earlier, in an SSO-enabled community that uses dual authentication where users can register using a non-SSO method or an SSO method, non-SSO users could register using an e-mail address associated with another account. Even though the system recognized that the e-mail was already associated with another profile, it still accepted registration. This issue is now fixed. Now, when non-SSO users register, they will continue to be informed that the e-mail they selected is already in use and registration is rejected.
- Earlier, when users with appropriate permissions tried to fetch a post or a reply to a post marked as spam using APIs, they received a "Permission Denied" error message, which was misleading. This is fixed. Now, when they fetch such posts and replies, they will see a success message without the content.
Accessibility Fixes
- Earlier, the community pages that used the “BoardBrowserListTaplet” and “NodeListTaplet” components had a clickable icon and an adjacent message subject link next to it which both led to the same page. Some customers didn’t want two different UI elements that served the same purpose. We have addressed this issue by introducing a Studio parameter called "disableIconLink" to enable/disable links on the icons for the "BoardBrowserListTaplet" and "NodeListTaplet" components.
By default, links on icons for these components are enabled.
To disable the links on icons from Studio:
1. Go to Studio.
2. Choose the community page where you want to make these changes.
3.Click Switch to XML View on the top-right section.
4.Add the parameter disableIconLink="true" to the component with id="forums.widget.board-browser-list" for BoardBrowserListTaplet and id="nodes.widget.child-node-list" for NodeListTaplet component as below:
<component id="nodes.widget.child-node-list" disableIconLink="true"/>
<component id="forums.widget.board-browser-list" disableIconLink="true"/>
- The issue where the screen reader did not read out the information about the pagination controls when users entered, left, or navigated within a pagination component is now resolved.
-
Previously, when community breadcrumb links were too long to fit on the page and the links were truncated with an ellipsis (for example, Community Name> TKB page name >name of the TKB arti…), the screen reader read out only the visible characters. This did not provide complete information to users. We have fixed this issue, and now the entire breadcrumb link is read.
- A NVDA-specific screen reader issue where it announced incomplete information for the search filter buttons on the search edit field for Private Messages is now fixed.
- On the Private Messenger page, the screen reader used to read out the "Inbox" and “Sent” buttons as "Show option button", which was misleading. This issue is now resolved. The screen reader now announces that they are drop-down menus with proper labels.
- We have fixed the issue where the focus moved to multiple non-interactive elements on the page while navigating with the keyboard Tab key.
- We have fixed the issue where the screen reader did not read out if the Additional Options or Teaser or SEO Options in the Post form were collapsed or expanded.
-
The issue where the screen reader read out the name of the file instead of the alternate caption provided for an image is now fixed. Now, when you upload an image with an alternate caption, the screen reader reads out the alternate caption.
-
Earlier, screen readers were unable to identify if a table on the community page was a “data” table or a “presentation” table. This was because the roles for both table types were set to "presentation".
To fix this issue, we have introduced the “isTableRolePresentation” parameter that enables you to remove the role="presentation" attribute for the table from Studio.
For example, on the “Move Messages Page”, for the “move-messages-form” component, pass isTableRolePresentation="false", to remove the role="presentation" attribute. This means that the role is “table” for this component.
<component id="move-messages-form" isTableRolePresentation="false"/>
Note:
- The default value of “isTableRolePresentation” is “true”.
- The default role is “presentation”.
This parameter is available for these components:
File Name
Page Name
Component Name
AllDrafts.tml
Blog Console Page
BlogConsolePage
RecentBlogArticlesTaplet.tml
View Profile Page
blogs.widget.recent-blog-articles
MoveMessagesForm.tml
Move Messages Page
move-messages-form
ThreadList.tml
forums.widget.thread-list
TaggedMessagesTaplet.tml
Tag View Page
tags.widget.leaderboard-messages
tags.widget.leaderboard-messages-title
tags.widget.leaderboard-messages-community-title
tags.widget.my-recent-tagged-messages
tags.widget.frequent-tagged-messages
tags.widget.recently-tagged-messages
ForumPage.tml
Forum Page
message-list
MessageHistoryPage.tml
Message History Page
content
MessageTrackerPage.tml
Message Tracker Page
MessageTrackerPage
RecentPostsPage.tml
Recent Posts Page
post-list
TagDetailPage.tml
Tag Detail Page
tag-list
UnansweredTopicsPage.tml
Unanswered Topic Page
unanswered-list
UnreadPostsPage.tml
Unread Posts Page
unread-list
ForumsFilteredByLabelPage.tml
Forum Filter by Label Page
post-list
GroupPage.tml (common)
Group Page
message-list
TopMessagesLeaderBoard.tml
Kudos Leaderboard Page
tabs
KudosUserPage.tml
Kudos User Page
KudosUserPage
ProductMessageList.tml
Product Page
products.widget.product-message-list
RecentQuestionsPage.tml
Recent Questions Page
question-list
TkbHistoryViewList.tml
TKB Article History Page
history
TkbPage.tml
TKB Page
message-list
- We have fixed the issue where the color contrast between the “Close” button and the background was insufficient for low-vision users to see the icon clearly. Now, the contrast between foreground and background colors meets the WCAG 2 AA contrast ratio thresholds.