Модернизация фирменного стиля сайта

Статья
04/08/2023

Важно!

Средства модернизации и все остальные компоненты PnP — это инструменты с открытым исходным кодом, поддерживаемые активным сообществом, которое предоставляет для них поддержку. Со стороны официальных каналов поддержки Майкрософт отсутствуют соглашения об уровне обслуживания (SLA) для инструментов с открытым исходным кодом.

Современный пользовательский интерфейс SharePoint работает с фирменным стилем не так, как классическая среда SharePoint. В частности, он просто игнорирует пользовательские эталонные страницы и альтернативные конфигурации CSS (которые несовместимы с современным пользовательским интерфейсом). Вы можете оставить эти параметры на модернизированном сайте, чтобы они по-прежнему применялись к странице, отображаемой в классическом пользовательском интерфейсе, но удобнее будет включить эталонные страницы OOB и удалить альтернативную конфигурацию CSS.

Наряду с этими эталонными страницами и альтернативными параметрами CSS могла использоваться классическая пользовательская тема. Классические пользовательские темы работают как на классических, так и на современных страницах, но более долговечной моделью является новая тема SharePoint под управлением клиента, которая, естественно, также применяется как к классическим, так и к современным страницам.

Определение сайтов, использующих эталонные страницы или альтернативные конфигурации CSS

Чтобы определить, на каких сайтах используются пользовательские эталонные страницы или альтернативные параметры CSS, рекомендуем запустить сканер модернизации SharePoint. Это средство выполняет подробный анализ всех сайтов в клиенте и создает отчеты со сведениями о сайтах, на которых по-прежнему есть несовместимые эталонные страницы или альтернативные параметры CSS. С учетом выходных данных сканера вы можете исправить эти сайты.

Возврат к стандартной конфигурации

Ниже приведен пример скрипта PnP PowerShell, иллюстрирующий возврат к стандартной конфигурации.

$minimumVersion = New-Object System.Version("2.24.1803.0")
if (-not (Get-InstalledModule -Name SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -ErrorAction Ignore))
{
    Install-Module SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -Scope CurrentUser
}
Import-Module SharePointPnPPowerShellOnline -DisableNameChecking -MinimumVersion $minimumVersion

Connect-PnPOnline -Url "<your site url>"

# Set out-of-the-box master page
Set-PnPMasterPage -MasterPageSiteRelativeUrl _catalogs/masterpage/seattle.master -CustomMasterPageSiteRelativeUrl _catalogs/masterpage/seattle.master

# Remove the alternate CSS setting
$web = Get-PnPWeb -Includes AlternateCssUrl
$web.AlternateCssUrl = ""
$web.Context.ExecuteQuery()

Примечание.

PnP PowerShell — это решение с открытым исходным кодом, поддержка которого предоставляется активным сообществом. Для инструментов с открытым исходным кодом не существует соглашения об уровне обслуживания в отношении поддержки корпорацией Майкрософт.

Использование темы SharePoint, которой управляет клиент

В SharePoint доступно множество готовых стандартных тем, но если вы хотите использовать фирменную символику своей компании, рекомендуем создать тему компании и скрыть готовые темы. После завершения этой настройки пользователи смогут выбирать только настроенные вами фирменные темы SharePoint, а вы можете программным образом устанавливать такие темы в рамках модернизации.

Добавление фирменной темы SharePoint

Ниже представлен пример скрипта PnP PowerShell, иллюстрирующий добавление фирменной темы SharePoint:

$minimumVersion = New-Object System.Version("2.24.1803.0")
if (-not (Get-InstalledModule -Name SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -ErrorAction Ignore))
{
    Install-Module SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -Scope CurrentUser
}
Import-Module SharePointPnPPowerShellOnline -DisableNameChecking -MinimumVersion $minimumVersion

Connect-PnPOnline -Url "<your tenant admin url>"

# Define your company theme colors
$themepalette = @{
      "themePrimary" = "#00ffff";
      "themeLighterAlt" = "#f3fcfc";
      "themeLighter" = "#daffff";
      "themeLight" = "#affefe";
      "themeTertiary" = "#76ffff";
      "themeSecondary" = "#39ffff";
      "themeDarkAlt" = "#00c4c4";
      "themeDark" = "#009090";
      "themeDarker" = "#005252";
      "neutralLighterAlt" = "#f8f8f8";
      "neutralLighter" = "#f4f4f4";
      "neutralLight" = "#eaeaea";
      "neutralQuaternaryAlt" = "#dadada";
      "neutralQuaternary" = "#d0d0d0";
      "neutralTertiaryAlt" = "#c8c8c8";
      "neutralTertiary" = "#a6a6a6";
      "neutralSecondaryAlt" = "#767676";
      "neutralSecondary" = "#666666";
      "neutralPrimary" = "#333";
      "neutralPrimaryAlt" = "#3c3c3c";
      "neutralDark" = "#212121";
      "black" = "#000000";
      "white" = "#fff";
      "primaryBackground" = "#fff";
      "primaryText" = "#333"
     }

# Add the company theme
Add-PnPTenantTheme -Identity "CustomCompanyTheme" -Palette $themepalette -IsInverted:$false

Использование фирменной темы SharePoint

Чтобы применить фирменную тему SharePoint, вы можете воспользоваться приведенным ниже скриптом.

$minimumVersion = New-Object System.Version("2.24.1803.0")
if (-not (Get-InstalledModule -Name SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -ErrorAction Ignore))
{
    Install-Module SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -Scope CurrentUser
}
Import-Module SharePointPnPPowerShellOnline -DisableNameChecking -MinimumVersion $minimumVersion

Connect-PnPOnline -Url "<your site url>"

# Set the company theme
Set-PnPWebTheme -Theme "CustomCompanyTheme"

Поделиться через