WP Rocket subdomínios não otimiza: como corrigir

Tipo Performance & Velocidade

Nome do erro WP Rocket não otimiza subdomínios EN: WP Rocket not applying optimizations on subdomains

Severidade Atenção

Descrição O WP Rocket não otimiza subdomínios quando o plugin foi ativado em rede (Network Activate) em vez de ativado individualmente em cada subsite, ou quando o WordPress acessa o admin por uma URL diferente da do front-end, impedindo o plugin de gerar a configuração e o cache por domínio.

O que é WP Rocket que não otimiza subdomínios?

WP Rocket subdomínio não otimiza é o sintoma de um multisite WordPress em que o cache e as otimizações do WP Rocket (minificação, lazy load, preload) funcionam no site principal, mas não são aplicados nos subsites hospedados em subdomínios como loja.seusite.com ou blog.seusite.com. As páginas do subdomínio continuam sendo servidas sem cache, sem HTML minificado e sem os ganhos de performance que o plugin entrega no site principal.

O WP Rocket trata cada site de uma rede multisite de forma independente: ele cria um arquivo de configuração por domínio em wp-content/wp-rocket-config e gera uma pasta de cache separada para cada subsite. Para isso funcionar, o plugin precisa estar ativado em cada subsite individualmente e precisa enxergar a URL correta do domínio. Segundo a documentação oficial do WP Rocket, o plugin não deve ser ativado em rede em uma instalação multisite, e o admin precisa ser acessado pelo mesmo domínio usado no front-end. Quando essas duas condições não são respeitadas, o subdomínio fica sem otimização.

Como identificar

As páginas do subdomínio (ex.: loja.seusite.com) carregam sem cache do WP Rocket, enquanto o site principal carrega otimizado.
O comentário de rodapé do HTML ‘Performance optimized by WP Rocket’ não aparece no código-fonte das páginas do subdomínio.
O painel de cada subsite não mostra a aba de configurações do WP Rocket, ou mostra apenas a configuração herdada da rede sem permitir ajustes individuais.
Minificação de CSS/JS e lazy load funcionam no domínio principal, mas não têm efeito nas páginas do subdomínio.
Não existe um arquivo de configuração com o nome do subdomínio dentro de wp-content/wp-rocket-config (ex.: falta o subdominio.seusite.com.php).
A pasta de cache do subdomínio em wp-content/cache/wp-rocket permanece vazia mesmo após visitar as páginas.

Antes de começar: Antes de mexer na ativação de plugins da rede, em arquivos dentro de wp-content ou em permissões de pasta, faça um backup completo do multisite (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para conseguir reverter caso algum subsite pare de carregar.

Como prevenir

Nunca ative o WP Rocket em rede no multisite: ative individualmente em cada subsite para que cada subdomínio tenha sua própria configuração e cache.
Padronize o acesso ao wp-admin de cada subsite pelo mesmo domínio público do front-end, evitando URLs internas que confundem a detecção de domínio do plugin.
Monitore as permissões das pastas wp-content/wp-rocket-config e wp-content/cache para garantir que o servidor web consegue gravar a config e o cache de novos subdomínios.
Ao adicionar um novo subdomínio à rede, inclua na rotina ativar o WP Rocket no subsite e validar o arquivo de configuração correspondente antes de colocar no ar.

Causa

O WP Rocket foi ativado em rede (Network Activate) no multisite: a documentação oficial orienta NÃO ativar em rede, pois isso força a mesma configuração em todos os subsites e impede o ajuste e a geração de cache por subdomínio.
O subsite do subdomínio nunca teve o WP Rocket ativado individualmente em Plugins do próprio subsite, então o plugin não está em execução para aquele domínio.
O admin do subsite está sendo acessado por uma URL diferente da usada no front-end (caso comum com domain mapping), fazendo o WP Rocket não detectar o domínio correto e não criar o arquivo de configuração do subdomínio.
A pasta wp-content/wp-rocket-config ou wp-content/cache não tem permissão de escrita pelo usuário do servidor web, então o WP Rocket não consegue gravar o arquivo subdominio.seusite.com.php nem a pasta de cache do subsite.
A constante DONOTCACHEPAGE ou um cookie de sessão está ativo no subdomínio (por área logada ou loja), sinalizando ao WP Rocket para não cachear aquelas páginas específicas.

Como resolver

Desative a ativação em rede do WP Rocket: No painel da rede, em Meus Sites e Rede, abra os plugins da rede e desative o WP Rocket caso ele esteja ativado em rede. A documentação oficial orienta a NÃO ativar o WP Rocket em rede, porque a ativação em rede aplica a mesma configuração a todos os subsites e impede ajustes e cache por subdomínio.
```
Painel WP -> Meus Sites -> Administração da Rede -> Plugins
Localize o WP Rocket e clique em Desativar na Rede
```
Ative o WP Rocket dentro de cada subsite: Entre no painel do subsite do subdomínio e ative o WP Rocket ali, individualmente. Assim cada subsite passa a ter sua própria configuração e sua própria pasta de cache, como recomenda a doc oficial para multisite.
```
Painel do subsite (ex.: loja.seusite.com/wp-admin) -> Plugins -> Plugins Instalados
Localize o WP Rocket e clique em Ativar
```
Acesse o admin pelo mesmo domínio do front-end: Se você usa domain mapping ou domínio proxy, acesse o wp-admin pelo mesmo domínio que aparece para o visitante. O WP Rocket usa a URL do admin para gerar o arquivo de configuração; acessar por outra URL faz o plugin não detectar o subdomínio e não criar a config do subsite.
```
Acesse o wp-admin pela URL pública do subdomínio (ex.: https://loja.seusite.com/wp-admin)
Evite acessar o admin por uma URL interna ou pelo domínio do site principal
```
Confirme o arquivo de configuração do subdomínio: Via FTP ou gerenciador de arquivos, verifique se existe um arquivo com o nome do subdomínio dentro de wp-content/wp-rocket-config. O WP Rocket cria um arquivo .php por domínio; se ele não existir, o subdomínio não tem configuração e por isso não é otimizado.
```
Abra a pasta: wp-content/wp-rocket-config/
Procure o arquivo do subdomínio, ex.: subdominio.seusite.com.php
Garanta permissão de escrita na pasta (chmod 755 na pasta, 644 nos arquivos)
```
Limpe o cache do subsite e regere a configuração: No painel do subsite, limpe o cache do WP Rocket e salve as configurações novamente para forçar a regeneração do arquivo de configuração e da pasta de cache do subdomínio. Depois visite a página pública e confira o comentário do WP Rocket no rodapé do HTML.
```
Painel do subsite -> Configurações -> WP Rocket -> Limpar Cache
Painel do subsite -> WP Rocket -> Salvar Alterações (regera a config)
Abra o subdomínio e veja o código-fonte: deve aparecer 'Performance optimized by WP Rocket'
```

PHP

<?php
/**
 * Força o WP Rocket a usar o domínio público (front-end) ao gerar a
 * configuração de cada subsite do multisite, mesmo se o admin for
 * acessado por outra URL. Cole no functions.php do tema da rede
 * ou em um mu-plugin.
 */
add_filter( 'rocket_config_dir_name', 'full_wp_rocket_dir_por_subdominio' );
function full_wp_rocket_dir_por_subdominio( $dir_name ) {
    if ( ! is_multisite() ) {
        return $dir_name;
    }
    // Usa o host do site atual (subdomínio) como base da pasta de config.
    $home = wp_parse_url( home_url(), PHP_URL_HOST );
    if ( $home ) {
        $dir_name = sanitize_file_name( $home );
    }
    return $dir_name;
}

Perguntas frequentes

Por que o WP Rocket não otimiza meu subdomínio no multisite

Quase sempre porque o plugin foi ativado em rede ou não foi ativado no subsite do subdomínio. A documentação oficial do WP Rocket orienta ativar o plugin individualmente em cada subsite, e não em rede, para que cada subdomínio gere sua própria configuração e seu próprio cache.

Devo ativar o WP Rocket em rede num multisite WordPress

Não. A doc oficial recomenda NÃO ativar o WP Rocket em rede, porque a ativação em rede aplica a mesma configuração a todos os subsites e impede ajustes individuais. Ative o plugin separadamente dentro de cada subsite da rede.

Preciso de uma licença para cada subdomínio do WP Rocket

Não para subdomínios do mesmo domínio principal. Segundo o WP Rocket, uma única licença cobre subsites que compartilham o mesmo domínio de topo, como loja.seusite.com e blog.seusite.com. Domínios de topo diferentes exigem licenças separadas.

Onde o WP Rocket guarda a configuração de cada subdomínio

Em wp-content/wp-rocket-config, com um arquivo .php por domínio. Para subdominio.seusite.com, por exemplo, o plugin gera o arquivo subdominio.seusite.com.php. Se esse arquivo não existir, o subdomínio fica sem configuração e sem otimização.

Uso domain mapping e o subdomínio não otimiza, o que fazer

Acesse o wp-admin pelo mesmo domínio público usado no front-end. O WP Rocket detecta o domínio pela URL do admin; ao acessar por outra URL, o plugin não cria o arquivo de configuração correto e o subdomínio não é otimizado.

O cache do subdomínio é separado do cache do site principal

Sim. O WP Rocket trata cada subsite de forma independente e mantém uma pasta de cache separada por domínio dentro de wp-content/cache/wp-rocket. Limpar o cache de um subsite não afeta o cache dos outros subdomínios da rede.

Por que a pasta de cache do subdomínio fica vazia

Normalmente por falta de permissão de escrita em wp-content/cache, por uma constante DONOTCACHEPAGE ativa, ou porque o plugin não foi ativado naquele subsite. Confira a permissão da pasta, ative o WP Rocket no subsite e limpe o cache para forçar a regeneração.

Grave

Como corrigir o erro de JavaScript ao combinar arquivos no WP Rocket

A opção Combine JavaScript Files do WP Rocket junta todos os scripts em um único arquivo; quando dois scripts dependem de ordem ou de uma variavel global, a juncao gera erro de JavaScript e quebra menu, carrossel, slider ou formulário. A correção e excluir o arquivo conflitante do combine.

Atenção

Como corrigir o cache do WP-Optimize que quebra os listings do JetEngine no WordPress

O WP-Optimize cache quebra o JetEngine listing quando o cache de página serve uma versão estática e antiga do Listing Grid, ou quando o merge e minify de CSS/JS do WP-Optimize embaralham os scripts que o JetEngine e o JetSmartFilters usam para montar e filtrar o grid via AJAX.

Grave

Como corrigir o conflito de nonce expirado entre WP Rocket e reCAPTCHA

O nonce do reCAPTCHA expira com o WP Rocket quando a página do formulário é entregue do cache com um token de segurança gerado horas antes. O visitante envia esse nonce já vencido, o reCAPTCHA ou o formulário rejeita a verificação e a submissão falha, mesmo o usuário sendo humano.

Atenção

Como corrigir o impacto de scripts de terceiros (Analytics e Pixel) no WordPress

Scripts de terceiros como Google Analytics e Facebook Pixel carregam de domínios externos no head e bloqueiam a thread principal, elevando o Total Blocking Time e o LCP. A correção adia esses scripts até a interacao e hospeda o analytics localmente.

Atenção

Como corrigir a falha de backup do banco no WP-Optimize no WordPress

A falha de backup do banco no WP-Optimize acontece quando o backup que o plugin tira antes de otimizar (via motor do UpdraftPlus) não chega ao fim por estouro de memória PHP, timeout de execução, falta de espaco em disco ou ausencia de permissão de escrita na pasta wp-content/updraft.

Grave

Como corrigir o erro de permissão ao gerar cache no WP Rocket

O erro de permissão de cache do WP Rocket ocorre quando o PHP não consegue gravar em wp-content/cache. Sem permissão de escrita (CHMOD 0755) na pasta de cache, o plugin não cria os arquivos estáticos e as páginas continuam sem otimização.

Setores

Extensões

Integrações

Como corrigir o WP Rocket que não otimiza subdomínios no WordPress

O que é WP Rocket que não otimiza subdomínios?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o erro de JavaScript ao combinar arquivos no WP Rocket

Como corrigir o cache do WP-Optimize que quebra os listings do JetEngine no WordPress

Como corrigir o conflito de nonce expirado entre WP Rocket e reCAPTCHA

Como corrigir o impacto de scripts de terceiros (Analytics e Pixel) no WordPress

Como corrigir a falha de backup do banco no WP-Optimize no WordPress

Como corrigir o erro de permissão ao gerar cache no WP Rocket

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos