Tema do Site Hub Não se Aplica aos Sites Filhos: Causa e Solução

Quando você associa um site filho a um hub site do SharePoint, o tema do hub site deve ser aplicado automaticamente ao site filho. Em alguns casos, o site filho mantém seu esquema de cores e identidade visual originais. Esse problema ocorre porque o site filho tem um tema personalizado aplicado no nível do site que substitui o tema do hub. Este artigo explica por que o tema do hub site falha ao ser aplicado e fornece instruções passo a passo para forçar o tema do hub nos sites filhos.

Por que o Tema do Hub Site Não se Aplica aos Sites Filhos

Os hub sites do SharePoint podem propagar um tema para todos os sites filhos associados. Esse recurso foi projetado para manter uma identidade visual consistente em um grupo de sites relacionados. O tema do hub é armazenado nas configurações de tema do hub site e é enviado para os sites filhos quando eles são associados ao hub.

A causa raiz do tema não ser aplicado é um conflito entre o tema do hub e um tema personalizado que foi aplicado diretamente ao site filho. Quando um site filho tem um tema personalizado definido por meio das próprias configurações “Alterar a aparência”, esse tema personalizado tem prioridade sobre o tema do hub. O SharePoint não substitui automaticamente o tema personalizado de um site filho quando ele é associado a um hub site. O tema do hub só é aplicado se o site filho estiver usando o tema padrão ou nenhum tema personalizado.

Como Funciona a Herança do Tema do Hub

A herança do tema do hub é um envio único no momento da associação. Se o site filho já possui um tema personalizado, o tema do hub é ignorado. Alterar o tema do hub site posteriormente não atualiza automaticamente os sites filhos que possuem temas personalizados. Você deve remover o tema personalizado do site filho ou reaplicar manualmente o tema do hub.

Cenários Comuns que Causam o Conflito

As seguintes ações podem criar um tema personalizado em um site filho que bloqueia o tema do hub:

• Um proprietário do site alterou o tema usando o painel “Alterar a aparência” após a criação do site.
• O site filho foi criado a partir de um modelo que incluía um tema personalizado.
• Um site foi migrado de outro ambiente e trouxe seu próprio tema.
• Um administrador de conjunto de sites aplicou um tema no nível do site usando PowerShell ou PnP.

Passos para Forçar o Tema do Hub Site nos Sites Filhos

Siga estas etapas para remover o tema personalizado de um site filho e aplicar o tema do hub site. Você precisa de pelo menos permissão de Proprietário do Site no site filho.

1. Verifique se o hub site tem um tema definido
   Acesse o hub site. Clique no ícone de engrenagem e selecione Alterar a aparência. Em Tema, confirme que um tema está selecionado e salvo. Se nenhum tema estiver definido, escolha um e clique em Salvar.
2. Navegue até as configurações de tema do site filho
   Abra o site filho que não está recebendo o tema do hub. Clique no ícone de engrenagem e selecione Alterar a aparência.
3. Remova o tema personalizado do site filho
   No painel Alterar a aparência, role até a seção Tema. Clique em Redefinir para o tema padrão ou selecione o tema padrão do SharePoint. Essa ação remove qualquer tema personalizado que substitui o tema do hub. Clique em Salvar.
4. Aplique o tema do hub manualmente
   Após redefinir o tema, volte para Alterar a aparência. Em Tema, procure uma opção chamada Do hub ou Tema do hub site. Selecione-a e clique em Salvar. O tema do hub site agora aparece no site filho.
5. Reassocie o site filho ao hub (se necessário)
   Se o tema ainda não for aplicado, remova o site filho do hub e adicione-o novamente. Vá para Configurações do site > Configurações do hub site. Em Hub site associado, clique em Remover do hub. Aguarde um minuto, depois pesquise pelo hub site e clique em Registrar para reassociar.

Usando PowerShell para Aplicar o Tema do Hub a Vários Sites Filhos

Se você tem muitos sites filhos com temas personalizados, use o SharePoint Online Management Shell para redefinir o tema em massa. Você precisa do módulo SharePoint Online Management Shell instalado e credenciais de administrador global ou do SharePoint.

1. Conecte-se ao SharePoint Online
   Abra o PowerShell e execute Connect-SPOService -Url https://seutenant-admin.sharepoint.com. Insira suas credenciais de administrador.
2. Obtenha o tema do hub site
   Execute Get-SPOHubSite -Identity https://seutenant.sharepoint.com/sites/HubSite. Anote o valor de SiteDesignId. Esse ID identifica o tema associado ao hub.
3. Redefina o tema do site filho
   Para cada site filho, execute Set-SPOSite -Identity https://seutenant.sharepoint.com/sites/SiteFilho -DenyAddAndCustomizePages 0 para permitir alterações de tema. Em seguida, execute Set-SPOSite -Identity https://seutenant.sharepoint.com/sites/SiteFilho -OverrideTheme para remover o tema personalizado.
4. Aplique o tema do hub ao site filho
   Execute Invoke-SPOSiteDesign -Identity -WebUrl https://seutenant.sharepoint.com/sites/SiteFilho. Substitua pelo ID anotado na etapa 2.

Se o Tema do Hub Site Ainda Não For Aplicado

O site filho mostra a opção “Do hub”, mas o tema não muda

Esse problema pode ocorrer quando o próprio hub site não tem um tema aplicado ou o tema foi alterado após a associação do site filho. Vá para o hub site e confirme se um tema está salvo em Alterar a aparência. Em seguida, selecione manualmente Do hub no site filho novamente.

O tema do site filho é redefinido após alguns minutos

Um script personalizado ou um design de site aplicado ao site filho pode estar reaplicando um tema personalizado. Verifique se o site filho tem um script de site que é executado periodicamente. Vá para Configurações do site > Scripts do site e revise os scripts ativos. Remova ou modifique scripts que definem um tema.

O tema do hub site não se aplica a novos sites filhos

Se novos sites criados a partir do hub não herdarem o tema, o tema do hub site pode não fazer parte do design do site. Verifique se o hub site tem um design de site que inclui um tema. Vá para a central de administração do SharePoint, selecione Sites ativos, escolha o hub site e clique em Hub site. Verifique o campo Design do site. Se estiver vazio, atribua um design de site que inclua um tema.

Item	Tema do Hub Site	Tema Personalizado do Site Filho
Origem	Definido nas configurações de Alterar a aparência do hub site	Definido diretamente nas configurações de Alterar a aparência do site filho
Herança	Enviado para sites filhos no momento da associação	Substitui o tema do hub quando presente
Remoção	Não pode ser removido dos sites filhos sem quebrar a associação ao hub	Pode ser redefinido para o padrão ou para o tema do hub manualmente
Aplicação em massa	Requer PowerShell ou design do site	Deve ser removido individualmente ou via PowerShell

Agora você pode identificar e corrigir o conflito de tema do hub site nos sites filhos. Comece verificando as configurações de tema do site filho e removendo qualquer tema personalizado. Se você gerencia muitos sites, use o método PowerShell para redefinir temas em massa. Para problemas persistentes, revise scripts do site e designs do site que possam estar reaplicando temas personalizados. As principais configurações a lembrar são Alterar a aparência > Redefinir para o tema padrão e a opção Do hub no seletor de temas.