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

Важно!

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

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

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

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

Используйте средство оценки Microsoft 365 (классическая оценка) и включите компонент расширения для выявления сайтов, использующих настраиваемые страницы master, альтернативные 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"

См. также