Telligent Community
Telligent Community
  • Site
  • User
  • Site
  • Search
  • User
Telligent Community 10.x
  • Verint Community
  • More
Telligent Community 10.x
User Documentation How do I upgrade the user experience of my community?
  • Ask the Community
  • User Documentation
  • API Documentation
  • Manager Training
  • Developer Training
  • Tags
  • More
  • Cancel
  • New
  • +Telligent Community 10.x User Documentation
  • Changing system terminology
  • Community and GDPR
  • How are wiki page editing conflicts handled?
  • How can I adjust what makes a thread popular within forums?
  • How can I administer available emoticons and emoji?
  • How can I allow members to customize their homepage/dashboard?
  • How can I allow users to delete their own accounts?
  • How can I change the requirements for requesting friendships?
  • How can I configure how members can join the site and their initial experience?
  • How can I control the RSS feeds that are provided for a blog?
  • How can I control the types and sizes of files that members can upload?
  • How can I control types, number, and total storage allowance for files in a media gallery?
  • How can I control whether forum thread and reply authors can edit or delete their own posts?
  • How can I control which actions members can perform on a blog?
  • How can I control which actions members can perform within a forum?
  • How can I control which actions members can perform within a media gallery?
  • How can I control which types of files can be embedded within forum threads and replies?
  • How can I customize messaging to new members?
  • How can I customize the content in aggregate blog RSS feeds?
  • How can I customize the content or delivery time of email digest?
  • How can I customize the fields available on members’ profiles?
  • How can I diagnose a problem or get help?
  • How can I enable a guest blogger on a blog?
  • How can I enable authentication via Windows / Active Directory (AD)?
  • How can I enable multiple members to manage a single blog?
  • How can I enable single sign-on (SSO) with another Microsoft .net-based website?
  • How can I enable single sign-on (SSO)?
  • How can I enable support for emailing to start or reply to a forum thread?
  • How can I enable visitors to authenticate through Facebook?
  • How can I enable visitors to authenticate through Google?
  • How can I enable visitors to authenticate through LinkedIn?
  • How can I enable visitors to authenticate through Live Connect?
  • How can I enable visitors to authenticate through Salesforce?
  • How can I enable visitors to authenticate through Twitter?
  • How can I enable visitors to contact the owners of a group?
  • How can I hide a member's forum posts from the community?
  • How can I identify abuse or SPAM within the community?
  • How can I impersonate a user to act on their behalf?
  • How can I include forum behavior in an external website?
  • How can I integrate my community with other websites and services?
  • How can I join a group?
  • How can I limit who or when someone can comment or trackback on a blog post?
  • How can I make a thread stick to the top of the thread list within a forum?
  • How can I manage blog posts with Open Live Writer (formerly Windows Live Writer)?
  • How can I mirror content from another blog or RSS feed?
  • How can I moderate tags within an application?
  • How can I move content from one area of my community to another?
  • How can I prevent SPAM accounts from being created using the ReCaptcha service?
  • How can I prevent spam content from being shown on my community?
  • How can I provide new members with a default set of friends?
  • How can I rebrand my community in an upgrade-safe way?
  • How can I render previews of documents (Word, Excel, PowerPoint, PDFs) in my community?
  • How can I require acceptance of terms of service before member registration?
  • How can I set the default theme and theme selection options for all blogs?
  • How can I set the default theme and theme selection options for all groups?
  • How can I show or require additional profile fields to be completed when members join my community?
  • How can I specify which types of member avatars are allowed and the default member avatar?
  • How can I split a forum thread into multiple threads?
  • How can I start or stop the job service?
  • How can I stop receiving updates from a forum thread?
  • How can I synchronize Active Directory (AD) groups with Telligent Community roles?
  • How can I uninstall the job service?
  • How can I use snippets within blogs to save time or reuse content when writing posts?
  • How can I use the REST API to automate data migrations or data modifications?
  • How can I write blog posts using email?
  • How do I add a community member?
  • How do I add an Achievement?
  • How do I add an idea to an ideation?
  • How do I add or upload a file to a media gallery?
  • How do I administer members?
  • How do I allow users to export their data?
  • How do I ask a question or start a discussion in a forum?
  • How do I automatically create a blog for each new member of the community?
  • How do I ban or disapprove a member?
  • How do I cancel an event in a calendar?
  • How do I capture a forum thread to a wiki?
  • How do I change my avatar?
  • How do I change the types of threads or thread answer and auto-locking configuration for a forum?
  • How do I chat with another member?
  • How do I compare wiki page revisions?
  • How do I configure email integration?
  • How do I configure Telligent Community to meet the privacy requirement of my locale?
  • How do I connect my community to my Verint Knowledge Management site?
  • How do I control the type and functionality of content that can be posted on my community?
  • How do I control types and sizes of files that members can upload?
  • How do I control whether members can post status messages within a group?
  • How do I control which Active Directory (AD) fields are synchronized and editable on member profiles?
  • How do I create a custom page within a theme?
  • How do I create a group?
  • How do I create a Knowledge Collection?
  • How do I create a wiki page?
  • How do I create an application?
  • How do I create an event in a calendar?
  • How do I create rules to automate my community?
  • How do I customize direct communication options such as email, notifications, and private messages?
  • How do I customize email sent from the community?
  • How do I customize the look and feel of my community?
  • How do I delete a blog post?
  • How do I delete a group?
  • How do I delete a Wiki Page?
  • How do I delete an application?
  • How do I delete an event from a calendar?
  • How Do I Deploy my Site to Microsoft Azure?
  • How do I edit a blog post?
  • How do I edit a file or URL in a media gallery?
  • How do I edit a forum thread or reply?
  • How do I edit a wiki page?
  • How do I edit an Achievement?
  • How do I embed custom forms in my community?
  • How do I enable moderation within a forum?
  • How do I enable moderation within a media gallery?
  • How do I enable visitors to contact me through my blog?
  • How do I export my data?
  • How do I get to the administration panel?
  • How do I get to the contextual management panel?
  • How do I implement single sign-on (SSO) with an existing authentication system using cookies?
  • How do I insert a poll into content?
  • How do I install chat support?
  • How do I install Telligent Community?
  • How do I lock a wiki page?
  • How do I manage advertisements in my community?
  • How do I manage comments?
  • How do I manage licenses?
  • How do I manage membership within a group?
  • How do I manage registrations for a calendar event?
  • How do I manage roles and permissions to control what members can do on the community?
  • How Do I Migrate My Existing File Storage to Azure?
  • How do I moderate a forum to move, split, merge, lock threads?
  • How do I moderate content a member creates?
  • How do I monitor the health of my community?
  • How do I preview UI changes in the community?
  • How do I register for an event?
  • How do I rename, change the avatar, or move a group?
  • How do I revert to a previous version of a wiki page?
  • How do I see download counts of files in a media gallery?
  • How do I send an ad-hoc mass email to community members?
  • How do I set the default timezone and date/time formats for my community?
  • How do I setup an about page for a blog?
  • How do I store some files in different locations than others?
  • How do I translate my community?
  • How do I update the status of an idea?
  • How do I upgrade Telligent Community?
  • How do I upgrade the user experience of my community?
  • How do I use the content editor?
  • How do I use wiki link syntax?
  • +How do I view reports?
  • How do I vote on ideas?
  • How do I write a blog post?
  • How does moderation and abuse work?
  • How does Telligent Community support mobile devices?
  • How does Telligent ensure the quality of Telligent Community?
  • How should I define groups and applications in my community?
  • How should I store user contributed media?
  • How should I support multiple languages on my community?
  • Release Notes
  • What are jobs?
  • +What are the system requirements?
  • What best practices should be followed when customizing the user interface?
  • What is a blog?
  • What is a calendar?
  • What is a forum thread?
  • What is a forum?
  • What is a gallery?
  • What is a group?
  • What is a hashtag?
  • What is a Knowledge Document?
  • What is a mention?
  • What is a theme?
  • What is a wiki?
  • What is an Achievement?
  • What is an activity stream?
  • What is an application?
  • What is chat?
  • What is document preview?
  • What is featured content?
  • What is friending and following?
  • What is ideation?
  • What is liking?
  • What is private messaging?
  • What is RSS?
  • What is the question and answer workflow in forums?
  • What type of video files can I embed in my community?
  • What types of videos can I embed in or attach to content?

How do I upgrade the user experience of my community?

Whenever a major release or service release is installed, Telligent Community leaves the user experience of your community as it was. If any changes were made to components of the user experience, the administrators of the community will get a system notification providing next steps to review and publish those changes.

Table of Contents

  • Notification of user experience changes
  • Beginning the Review
  • Reviewing Changes
  • Theme Upgrading in 10.2
    • Theme Migration
    • Theme Upgrading
  • Review Effort Notes

Notification of user experience changes

As part of the upgrade process of Telligent Community, the platform components are updated and your community's user experience is preserved to allow you to review user experience changes and choose which changes you'd like to incorporate within your community as a post-upgrade step. If changes were made from the previous version of Telligent Community to the newly upgraded version, a system notification will be set to the administrators of the community:

Clicking this notification will open the message which will identify your user experience (and other upgrade-related) options:

Depending on the version of Telligent Community that you upgraded from, the options available will change. Each optional post-upgrade step includes a description to help guide you to make decisions appropriate to your community.

For sites using the Social theme, the Update the Social Theme process should be used to start a review of the updates to the default user experience of Telligent Community. To start reviewing the updates to the Social theme, click Update the Social Theme.

Beginning the Review

When you first select to update the social theme, the User Experience Upgrade panel will show:

This explains the review process in a little more detail and allows you to begin the review. Click Review Upgraded Theme to start. When you click this button, the user experience changes that were made between the last version installed and the newly upgraded version of Telligent Community will be staged for your review. The staged changes are only visible to you and are not published for any other visitor to your community. When the staging process is complete, you'll be taken to the Preview Staged Changes panel and preview mode will be enabled for you.

Reviewing Changes

The changes should now be presented to you within the Preview Staged Changes panel and the preview should be enabled. This allows you (and only you) to navigate around the community and see how it looks with the latest user experience upgrades provided in the default user experience in Telligent Community. For more details about previewing and reviewing staged changes, see How do I preview UI changes in the community?

The Preview Staged Changes panel categorizes changes by their type and includes a few unique categories that are only shown as part of a user experience upgrade:

  • Upgraded Customized Widgets: These are widgets that have been updated that were previously customized for your community. These widgets require the most careful review. You may want your development team (the one that made the customizations) to review these widgets. If you click the change count button, the list of specific widgets to review will be shown and each will have an Edit option to open the widget in Widget Studio where a visual diff can be performed to review and merge the changes as applicable.
  • Upgraded Widgets: These widgets were not customized for your community but were updated as part of the current upgrade. These widgets should be able to be visually reviewed by navigating the site (developer review is not required).
  • Removed Widgets: These widgets were removed from the platform as part of the latest upgrade. Generally this is because their functionality was merged with other widgets and any necessary page changes related to widget removal are listed within the Pages category in the Preview Staged Changes panel.

The recommended review is to

  1. Navigate around the site and review general styling and functionality changes.
  2. If you notice any anomalies, you can directly edit pages and theme styles using the existing page and theme edit tools (see How do I customize the look and feel of my community?) to address the issues. These changes can be staged for preview on top of the user experience upgrade changes so that all changes can be published at once.
  3. Specifically review the widgets in the "Upgraded Customized Widgets" list. Consult with your development team to review these changes.
  4. Approve or deny all changes, either at the category level or by reviewing the specific changes within a category.
  5. When all changes are approved or denied, click Commit Reviewed Items.

Theme Upgrading in 10.2

The 10.2 release introduces Theme Studio for editing the implementation of themes using a developer-centered integrated development environment. When upgrading to 10.2, all existing themes are first migrated to be compatible with Theme Studio and then the upgrade process outlined above is used to upgrade the migrated theme to expose new theme functionality.

Theme Migration

The migration process will begin as soon as you upgrade to adjust existing themes to work in Theme Studio. As part of this process, your existing themes and the usage of those themes will be analyzed. Theme Studio provides a better ongoing development and editing environment for implementation of themes (images, CSS, LESS, HTML, configuration, etc) and is preferred for storing these lower-level files and options. During the migration process, the site theme's configuration options, which were historically developer-oriented, will be migrated directly into a site theme located in Theme Studio (Administration > Interface > Themes). Based on the usage of group and blog theme options, options that were never modified (or always modified the same way) will be merged into the implementation of the theme in Theme Studio and any theme options that varied between uses will continue to be supported in the community.

As a result of the migration, your theme should look as it did prior to the upgrade. The options exposed when configuring a theme in Manage Theme > Edit Theme (now Manage Theme > Theme Options) will be adjusted to move as much configuration to Theme Studio as is possible. As a result, after upgrading, you may see fewer or no configuration options (if there are no configuration options to expose, the Manage Theme > Theme Options panel will not be available). 

Theme Upgrading

The theme upgrade process works as outlined above via the upgrade notification and similar upgrade options. When reviewing Social Theme Updates, the new implementation of the Social site theme will me merged into your migrated site theme. Specifically,

  • Any custom CSS, LESS, JS, and supplementary files are merged ahead into the upgraded/merged theme. If you added a site-specific CSS file, it'll still be there in the merged/updated site.
  • Palettes are detected and defined. Theme Studio defines reusable sets of configuration called palettes which enable widgets to be styled similarly. When upgrading to the 10.2 version of the Site Banner, Group Banner, Blog Banner, Custom Navigation, and Featured Content Carousel widgets, the new version of the widgets will read their configuration from the palettes defined by the site theme. To ensure a smooth upgrade, the current configuration of these widgets is analyzed and custom palettes will be added to the site theme to ensure that all palette configurations currently in use on the site are represented in the upgraded/merged theme.
  • Platform-defined custom css is removed. When the site theme was migrated for use with Theme Studio, its custom CSS was moved to the customcss.css file. During the upgrade/merge of the theme, the platform-defined content from the customcss.css file is removed as it is no longer required to make the upgraded theme to react to configuration options.
  • If any custom styling exists in the site theme (a custom CSS, LESS, customcss.css file), many of the platform-defined configuration options will be disabled. Because the platform-defined options use LESS/CSS to implement many configurable behaviors, the presence of custom CSS may cause these options to not function or not function as expected. To prevent the appearance of broken functionality, any configuration options making use of LESS/CSS that could be overridden are disabled. The disabled options are identified in the configuration component of the site theme and can be re-enabled by a theme developer after reviewing the custom CSS/LESS to ensure that it doesn't conflict.
  • If you manually defined a favicon, it will be merged into the upgraded/merged theme. The upgrade will attempt to review your HTML headers to extract a custom favicon file and apply it to the configuration of the upgraded theme. The favicon can later be changed by going to Manage Site Theme > Theme Options. 

The review of the upgraded/merged theme is performed as outlined above when reviewing other upgrade-related UI options. Note that the theme upgrade does not alter the group or blog theme in 10.2. Any custom configuration options that were present in the migrated theme will be present after the UI upgrade as well.

Review Effort Notes

In general, if your community has used the page editor and widget configuration options for customization, your upgrade should be easy -- there should be no widgets in "Upgraded Customized Widgets" and the changes should be easy to review by navigating around the site and accepting all of the changes.

If you had previously invested development effort in customizing widgets or overriding default styling via custom cascading style sheets (CSS), you will need to review your development changes and overrides as part of the user experience upgrade. It is possible that you prefer your customizations over the changes provided by the platform upgrade and you'll want to make a decision on a case-by-case basis.

  • Share
  • History
  • More
  • Cancel
Related
Recommended
  • Telligent
  • Professional Services
  • Submit a Support Ticket
  • Become a Partner
  • Request a Demo
  • Contact Us

About
Privacy Policy
Terms of use
Copyright 2021 Verint, Inc.
Powered by Verint Community