3205475 - How to apply a custom Theme on Learning Sites

Symptom

Customer would like to use a specific BizX Theme customized for the Learning Site, without modifying the global theme of internal users or using the native Learning user design

Environment

SAP SuccessFactors Learning

Reproducing the Issue

When Learning-only users are registering on a Site, their Learning page is using the default styles (either default theme from Theme Manager or the native Learning user Landing page style)
Customer would like to apply a different theme from Theme Manager to these Learning-only users, without overwriting any of the default styles

Cause

If enableLatestBranding=false --> Learning-only users registering on a Site will use the same style which is applied for native Learning users
If enableLatestBranding=true --> Learning-only users registering on a Site will use the globally applied theme from Theme Manager

Resolution

You can use the feature called Branding to apply a specific Platform theme to the Learning Sites of your Learning-only users, without overwriting the design for your internal users.

Steps required (please read them carefully before start, to make some decisions in advance):

Set enableLatestBranding=true in LMS_ADMIN config file. When set to “true”, applies the default SuccessFactors Platform theme to elements that support theming when accessing Learning via a Site, and allows a Learning brand to override that default SuccessFactors Platform theme.
- Note: createIntegratedExternalUser=false in the BizX configuration file is required to go further with next steps, because those customers who are still using this deprecated feature are synching their Site users to Platform, thus those users will see the global Theme and not using Brands in LMS, which is expected.
After this, create a theme in Theme Manager you would like to use on this Site and remember it's name
Go to LMS Admin > Brands
1. Add New
2. Once created, open it and in the field SuccessFactors Platform Theme select the desired Theme from the dropdown.
3. You can also select custom Introduction Panel IDs if you have created them before in LMS and define custom HTML Header and Footer if needed
  - If you need these customized and would prefer some assistance with the process, please engage a certified Partner or Professional Services as explained in KBA: 2149831
  - However, if you need only the Platform theme to be applied and do not want to override it with further customization, just leave these fields empty
  - Introduction panel:
    
    Controls the text that appears to users in the news panel. Set in System Administration > Application Administration > User Introductions.
  - Header:
    
    This is the content that appears at the top of the Site's page. You can include dynamic content, called "System Components." To see a list of system components and what each adds, choose the Show System Components link. You can also include inline HTML tags like <br> for break or <i> for italic text.
    
    Note
    
    If you define a header style, it overrides the theme completely. Any component that isn't specified here will use the default theming from the UI component. It’s highly recommended that you work with someone who has HTML expertise.
  - Footer:
    
    This is the content that appears at the bottom of the Site's page. You can include dynamic content, called "System Components." To see a list of system components and what each adds, click the Show System Components link. You can also include inline HTML tags like <br> for break or <i> for italic text.
4. Go to People > Organizations and select the one which will be used on the Site for the registering Learning-only users
  1. On field Branding Style, add the newly created Brand to associate them
5. Go to your Site and add the Organization ID if not done already
6. Test the results
  - Note the followings:
    1. The theme will apply only to those who are included in the Organization, so if you did not have Organization added to the Site when some users registered, they would not see the Brand
    2. When a new user registers, the automatic login is not using the Branding yet, it will be applied only on the first real login with credentials

Keywords

Branding, Brands, Site, Theme Manager, theme, Learning-only , KBA , LOD-SF-LMS-EXT , Sites and External Users , LOD-SF-LMS-THM , Theme Related Issues , LOD-SF-PLT-THM , Theme Manager Issues , How To

Product

SAP SuccessFactors Learning 2111 ; SAP SuccessFactors Learning 2205