Edit

Share via

Provision a new learning pathways solution

  • Article

There are two manual options when installing Microsoft 365 Learning Pathways. The first is the manual installation. This installs the web part and sets it up for use in your tenant. This won't create any pages other than the admin page and viewer page. The second installation option is to install the Learning Pathways site template previously hosted from the SharePoint Lookbook. To install the site template, follow these instructions. This tutorial walks you through the process of creating a site collection, downloading, and installing the site template. You'll then need to run M365lpConfiguration.ps1 in the Execute PowerShell Configuration Script to set the tenant app property.

Important

If you already have learning pathways provisioned in your tenant, it's recommended that you update learning pathways. If you install a new instance of learning pathways, you will need to manually transfer any customizations from the existing site to the new site.

Prerequisites for multilingual support

  • You need to be a SharePoint Administrator to be able to deploy this solution to the target tenant and have Site Collection.
  • You must set up and configure the tenant-wide App Catalog. See Set up your Office 365 tenant and follow the Create app catalog site section. If your tenant-wide App Catalog is provisioned, you'll need access to an account that has rights to upload a package to it to complete this setup process. Generally, this is an account with the SharePoint administrator role. If an account with that role doesn't work, go to the SharePoint admin center and find the Site Collection Administrators for the app catalog site collection. Then, either sign in as one of the Site Collection Administrators, or add the SharePoint administrator account that failed, to the Site Collection Administrators. You'll also need access to an account that is a SharePoint Administrator.
  • Provisioning with the PnP Lookbook template will provision all 10 languages. If you need multilingual support, ensure that your default language is set on the site collection BEFORE installing the Lookbook template. For more information on multilingual support, see Overview of multilingual support for learning pathways.

Ensure the Tenant Admin account doesn't have a language selected

Before you provision learning pathways, ensure that the Admin Account for the tenant doesn't have a language selected. Here’s how to verify if the Admin account doesn't have a language selected.

  1. With your Edge Admin profile, go to office.com.
  2. Enter the user credentials (if necessary).
  3. In Microsoft 365, click All Apps > Delve.
  4. Click Me > Update Profile.
  5. Scroll down the page and click How can I change language and regional settings.
  6. Click here, and then click the ellipses ....
  7. Under My Display Languages, you should see No languages selected. If a language is selected, unselect it.

To provision learning pathways

There are two manual options when installing Microsoft 365 Learning Pathways. The first is the manual install. This will install the web part and set it up for use in your tenant. This won't create any pages other than the admin page and viewer page. The second installation option is to install the Learning Pathways site template previously hosted from the SharePoint Lookbook. Follow these installation instructions to provision learning pathways to your tenant using either option: Manually installing and configuring Microsoft 365 learning pathways .

Add Owners to Site

As the Tenant Admin, it's unlikely you'll be the person customizing the site, so you'll need to assign a few owners to the site. Owners have administrative privileges on the site so they can modify site pages and rebrand the site. They also have the ability to hide and show content and build custom playlist and subcategories.

  1. From the SharePoint Settings menu, click Site Permissions.
  2. Click Advanced Permission Settings.
  3. Click Microsoft 365 learning pathways Owners.
  4. Click New > Add Users to this group, and then add the people you want to be Owners.
  5. Add a link to Explore the Site in the Share message, and then click Share.

Add translators to the site

If you will be using translators for the site, you can assign them permissions. Translators require Member permissions or higher.

Choose options for using multiple languages on the site

The SharePoint look book service creates the Learning Pathways site in nine languages. The following recommendations apply:

  • Turn off the languages you don’t want to support
  • If you are not supporting a multilingual site, turn off the multi-lingual feature. See the "Turn off multilingual support" section later in this topic.

Remove languages you don’t want to support

For organizations that choose to support only one language, in addition to the default English language, we recommend removing languages that aren’t supported.

  1. From the Learning Pathways site, select Settings from the top-right of the page, and then select Site information.

  2. At the bottom of the site information pane, select View all site settings.

  3. Under Site Administration, select Language settings.

  4. Under Enable pages and news to be translated into multiple languages, slide the toggle to On. It should be On by default.

  5. Under Add or remove site languages, click Remove to remove the languages you don't need for the site. The following shows an example of the Language Settings page to show Italian supported for the site, in addition to the default English language.

    Sample site-languages screen.

Note

When removing languages you cannot remove the default English language.

Assign translators

If you're going to translate pages, optionally assign one or more translators for each language (except the site default language).

  • In the Translator column, start typing the name of a person you want to be a translator, and then select the name from the list.

Note

Anyone in your organization's Active Directory can be assigned as a translator. People assigned as translators will not automatically be given appropriate permissions. When someone without edit permissions to a site tries to access the site, they will be directed to a web page where they can request access.

Turn off multilingual support

If you don’t want a multilingual site, for example, you want an English-only site, it’s recommended that you turn off the multilingual feature.

  1. From the Learning Pathways site, select Settings from the top-right of the page, and then select Site information.
  2. At the bottom of the site information pane, select View all site settings.
  3. Under Site Administration, select Language settings.
  4. Under Enable pages and news to be translated into multiple languages, slide the toggle to On. It should be On by default.
  • Under Enable pages and news to be translated, select Off.

Add languages

Learning pathways supports 9 languages, but it’s recommended that you add only the languages you need to support for the learning pathways site. You can add langauges at any time.

  • Under Add or remove site languages, start typing a language name in Select or type a language, or choose a language from the dropdown. You can repeat this step to add multiple languages. You can add or remove languages from your site at any time by going back to this page.