Moderniser la personnalisation du site

Article
04/08/2023

Importante

Les outils de modernisation et tous les autres composants PnP sont des outils open source bénéficiant d’une prise en charge par une communauté active. Il n’existe aucun contrat de niveau de service pour la prise en charge des outils open source des canaux de support Microsoft officiels.

L’interface utilisateur moderne de SharePoint gère la personnalisation différemment de l’interface utilisateur SharePoint classique. Plus particulièrement, elle ignore simplement les pages maîtres personnalisées ou les autres configurations CSS (qui sont incompatibles dans l'interface utilisateur moderne). Vous pouvez choisir de laisser en place ces configurations sur votre site modernisé afin qu’elles s’appliquent toujours aux pages affichées dans une interface utilisateur classique. Il est cependant préférable de passer aux pages maîtres OOB et de supprimer la configuration CSS alternative.

En parallèle à ces pages maîtres et à ces paramètres CSS alternatifs, vous pourriez utiliser un thème personnalisé classique. Ces thèmes personnalisés classiques fonctionnent sur les pages classiques comme modernes, mais le modèle le plus pérenne est le nouveau thème SharePoint contrôlé par le client, qui s’applique également aux pages classiques comme modernes.

Détecter les sites qui utilisent des pages maîtres ou des variantes CSS

L’approche recommandée pour détecter les sites qui utilisent une page maître personnalisée ou l’option CSS alternative consiste à exécuter le scanneur de modernisation de SharePoint. Cet outil effectue une analyse approfondie de tous les sites de votre client et crée des rapports qui donnent des détails sur les sites qui contiennent toujours des pages maîtres ou des paramètres CSS alternatifs incompatibles. En fonction du résultat du scanneur, vous pouvez corriger ces sites.

Rétablir la configuration par défaut

Vous trouverez ci-dessous un script PowerShell PnP qui permet de rétablir la configuration par défaut :

$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()

Remarque

PnP PowerShell est une solution open source pour laquelle un support est assuré par la communauté active. Il n’existe pas de contrat SLA Microsoft pour le support technique relatif à cet outil open source.

Utiliser un thème SharePoint contrôlé par le client

SharePoint offre une série de thèmes par défaut prêts à l’emploi que vous pouvez utiliser. Cependant, si vous voulez renforcer la personnalisation de votre entreprise, nous vous recommandons de créer le thème de votre entreprise et de masquer les thèmes prédéfinis. Une fois cette configuration terminée, vos utilisateurs peuvent sélectionner uniquement les thèmes SharePoint de l’entreprise que vous avez configurés. Vous pouvez donc définir un thème programmable SharePoint d’entreprise de ce type dans le cadre de votre effort de modernisation.

Ajouter un thème SharePoint d'entreprise

Exemple de script PowerShell PnP indiquant comment ajouter un thème SharePoint d’entreprise :

$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

Utiliser le thème SharePoint de votre entreprise

Pour appliquer votre thème SharePoint d’entreprise, vous pouvez utiliser le script ci-dessous :

$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"