Como bloquear atualizações do core do WordPress sem impedir atualizações de plugins e temas (mu-plugin)

Em ambientes de produção, é comum bloquear atualizações automáticas do WordPress para evitar quebras inesperadas após atualizações maiores. Porém, manter plugins e temas atualizados ainda é essencial por questões de segurança e compatibilidade.

Este post mostra como impedir que o core do WordPress seja atualizado automaticamente, sem afetar as atualizações de plugins, temas e traduções. Também mostra como ocultar o aviso de nova versão do WordPress no painel administrativo, de forma limpa e sem recorrer a gambiarras que causam erro 500.


1. Impedindo atualizações automáticas do core

Adicione o seguinte trecho ao seu wp-config.php:

define( 'WP_AUTO_UPDATE_CORE', false );

Isso impede que o WordPress atualize automaticamente o core, inclusive atualizações pequenas (minor). Plugins, temas e arquivos de tradução continuam com suas atualizações automáticas ativas.


2. O problema: notificação de nova versão continua aparecendo

Mesmo com a atualização automática desativada, o painel administrativo continuará exibindo um aviso informando que há uma nova versão do WordPress disponível. Isso é o comportamento padrão e não representa erro de configuração.


3. Tentativas incorretas que causam erro

Alguns tutoriais sugerem colocar o seguinte código no wp-config.php:

add_filter( 'pre_site_transient_update_core', '__return_null' );

Essa abordagem quebra o site com erro 500, pois o wp-config.php é processado antes das funções do WordPress estarem disponíveis. Filtros e hooks não devem ser inseridos no wp-config.php.


4. Solução correta: usar um mu-plugin

Para ocultar a notificação de atualização do core de forma correta e segura, crie um must-use plugin (mu-plugin). Esse tipo de plugin é carregado automaticamente e não depende do tema ativo.

Passo a passo:

  1. Crie a pasta mu-plugins (caso ainda não exista):
mkdir -p wp-content/mu-plugins
  1. Crie o arquivo oculta-core-update.php com o seguinte conteúdo:
<?php
/*
Plugin Name: Oculta Atualização do Core
Description: Remove a notificação de nova versão do core do WordPress no painel.
*/
add_filter( 'pre_site_transient_update_core', '__return_null' );
  1. Salve o arquivo em wp-content/mu-plugins/.

Ao acessar o painel administrativo, a notificação de atualização do WordPress não será mais exibida. As atualizações de plugins, temas e traduções continuarão funcionando normalmente.


5. Considerações finais

  • Não é possível escolher até qual versão o WordPress deve ser atualizado automaticamente. O WordPress sempre sugere a versão mais recente.
  • O define WP_AUTO_UPDATE_CORE serve apenas para permitir ou bloquear a atualização automática do core.
  • Para ocultar a notificação de nova versão, o uso de mu-plugin é a única forma segura e funcional.
  • Evite colocar filtros ou ações no wp-config.php. Esse arquivo não foi feito para isso.
Rolar para cima