Como corrigir o conflito de fontes entre Perfmatters e Astra Pro no WordPress
O que é conflito de fontes entre Perfmatters e Astra Pro?
O conflito de fontes entre Perfmatters e Astra Pro surge porque os dois plugins atuam sobre a mesma camada de tipografia, mas com objetivos diferentes. O Astra Pro carrega as fontes definidas no Customizer (Aparencia, Personalizar, Tipografia), normalmente Google Fonts servidas pelos servidores do Google e enfileiradas no cabeçalho da página. O Perfmatters, por sua vez, oferece opções de performance que interceptam exatamente esse carregamento: Disable Google Fonts, Local Google Fonts e Remove Unused CSS.
Quando essas opções do Perfmatters são ativadas sem considerar o Astra, o resultado e a tipografia do tema deixar de aparecer como configurada. Com Disable Google Fonts ligado, a requisicao da fonte do Astra e removida e o navegador cai para a fonte de sistema (fallback). Com Local Google Fonts, a fonte passa a ser servida do seu próprio servidor, o que pode quebrar se o Astra usar uma variante (peso ou estilo) que não foi baixada. E com Remove Unused CSS, regras de @font-face do Astra podem ser cortadas como se fossem CSS não utilizado, derrubando a renderizacao da fonte.
Como identificar
- Depois de ativar o Perfmatters, o site volta a exibir a fonte de sistema (Arial ou Times) no lugar da fonte configurada no Astra Pro.
- A tipografia aparece correta por um instante e depois muda, ou pisca, durante o carregamento da página (flash of unstyled text).
- Apenas alguns pesos ou estilos da fonte saem errados, por exemplo o negrito ou o italico aparecem como fonte padrão enquanto o regular fica certo.
- No painel de rede do navegador (F12, aba Network) a requisicao para fonts.googleapis.com ou fonts.gstatic.com não aparece mais depois que o Perfmatters foi ativado.
- Icones de fonte do tema ou de plugins (icon fonts) somem ou viram quadrados após ativar Remove Unused CSS no Perfmatters.
Como prevenir
- Defina uma única fonte de verdade para a tipografia: ou o Astra carrega as Google Fonts, ou o Perfmatters as hospeda localmente, nunca os dois competindo pela mesma fonte.
- Ao ativar Local Google Fonts no Perfmatters, confira sempre todos os pesos e estilos usados pelo Astra antes de publicar, para nenhuma variante cair em fallback.
- Ative o Remove Unused CSS com cuidado e sempre teste o site numa aba anonima, mantendo o CSS de tipografia do tema na lista de exclusão quando necessário.
- Limpe o cache do Perfmatters e do CDN após qualquer mudanca de fonte e valide visualmente antes de considerar o ajuste concluido.
Causa
- A opção Disable Google Fonts do Perfmatters esta ativada e remove a requisicao das Google Fonts que o Astra Pro enfileira pela tipografia do Customizer, fazendo o navegador cair para a fonte de sistema.
- A opção Local Google Fonts do Perfmatters esta ativada, mas a variante de peso ou estilo usada pelo Astra (por exemplo 600 ou italico) não foi baixada para o servidor local, entao essa variante específica não renderiza.
- A opção Remove Unused CSS do Perfmatters corta as regras @font-face ou o CSS de tipografia injetado pelo Astra Pro por considera-lo CSS não utilizado na primeira carga, derrubando a fonte.
- O Astra esta configurado para servir System Fonts ou uma fonte local enquanto o Perfmatters tenta otimizar Google Fonts inexistentes, ou o contrario, gerando uma fonte final divergente da configurada no Customizer.
- O cache de página do Perfmatters (ou de outro plugin de cache) ainda serve o HTML antigo com o link de fonte original, conflitando com o novo comportamento de fontes após a mudanca de opção.
Como resolver
- Descubra qual plugin esta controlando a fonte: Abra o site numa aba anonima e inspecione a tipografia. Em Perfmatters, Options, Fonts, anote o estado de Disable Google Fonts, Local Google Fonts e (em Assets) Remove Unused CSS. Em paralelo, confira em Aparencia, Personalizar, Tipografia qual fonte o Astra define. Isso revela se o Perfmatters esta removendo, hospedando ou cortando a fonte do Astra.
Painel WP -> Configurações -> Perfmatters -> Fonts Painel WP -> Aparencia -> Personalizar -> Tipografia Navegador -> F12 -> aba Network -> filtre por 'font' e recarregue a página - Decida quem serve a fonte e desligue a opção conflitante: Escolha uma única fonte de verdade. Se o Astra deve servir Google Fonts, desligue Disable Google Fonts no Perfmatters. Se você prefere o Perfmatters hospedando localmente, mantenha Local Google Fonts ligado e confirme que ele cobre a fonte do Astra. Nunca deixe Disable Google Fonts e a tipografia Google do Astra ativos ao mesmo tempo.
Painel WP -> Configurações -> Perfmatters -> Fonts -> desligue 'Disable Google Fonts' Ou mantenha 'Local Google Fonts' ligado e siga para o passo 3 - Cubra todas as variantes ao usar Local Google Fonts: Se optar por hospedar local, abra a tipografia do Astra e anote a familia e cada peso ou estilo em uso (por exemplo 400, 600 e italico). Garanta que o recurso Local Google Fonts do Perfmatters baixou essas variantes; faltando uma, o Astra usa fallback so naquele peso. Use a mesma familia nos dois lados.
Painel WP -> Aparencia -> Personalizar -> Tipografia -> anote familia + pesos Painel WP -> Configurações -> Perfmatters -> Fonts -> Local Google Fonts (confirme as variantes) - Exclua o CSS de fonte do Remove Unused CSS: Se a fonte some so com Remove Unused CSS ligado, ele esta cortando o @font-face do Astra. Adicione o handle ou seletor de tipografia do Astra na lista de exclusão do Remove Unused CSS, ou desligue o recurso para o tema e teste novamente. Assim o CSS de fonte volta a carregar na primeira pintura.
Painel WP -> Configurações -> Perfmatters -> Assets -> Remove Unused CSS Adicione o seletor/handle da fonte do Astra na lista de exclusão (Excluded Stylesheets/Selectors) - Limpe o cache e revalide: Toda mudanca de fonte exige limpar o cache de página e o cache do navegador, senao o HTML antigo continua servindo o link de fonte anterior. Limpe o cache do Perfmatters (e de outros plugins de cache e do CDN) e recarregue o site numa aba anonima para confirmar a tipografia correta.
Painel WP -> Configurações -> Perfmatters -> limpe o cache (Clear Cache) Limpe também o cache do CDN/Cloudflare se houver Navegador -> recarregue com Ctrl+Shift+R numa aba anonima
<?php
/**
* Faz preload da fonte servida localmente pelo Perfmatters/Astra para
* reduzir o flash of unstyled text quando os dois plugins coexistem.
* Ajuste o caminho do .woff2 para a variante exata usada pelo Astra.
*/
add_action( 'wp_head', 'full_preload_local_font', 1 );
function full_preload_local_font() {
$font_url = content_url( '/uploads/perfmatters/fonts/inter-v13-latin-600.woff2' );
printf(
'<link rel="preload" href="%s" as="font" type="font/woff2" crossorigin>' . "n",
esc_url( $font_url )
);
}














