A maioria dos desenvolvedores WordPress conhece plugins tradicionais. Mas poucos exploram o potencial dos mu-plugins — os must-use plugins. Diferente dos plugins comuns, os mu-plugins são carregados automaticamente em todas as execuções do WordPress, não podem ser desativados pelo painel e são perfeitos para comportamentos obrigatórios ou ajustes estruturais no sistema.
Neste post, explicamos o que são, como funcionam, onde ficam, como criar, quando usar e por que eles são úteis em ambientes de produção ou ambientes gerenciados.
1. O que é um mu-plugin
mu-plugin é a sigla para must-use plugin, ou seja, um plugin que deve ser usado obrigatoriamente. Ele é carregado automaticamente pelo WordPress, sem depender do painel de administração, da ativação manual ou do tema ativo.
São plugins que residem em uma pasta específica (mu-plugins) e que o WordPress reconhece como parte do sistema.
2. Onde ficam os mu-plugins
Enquanto os plugins tradicionais ficam em:
wp-content/plugins/
Os mu-plugins ficam em:
wp-content/mu-plugins/
Importante: a pasta
mu-pluginsnão existe por padrão. Você precisa criá-la.
3. Diferença entre plugin comum e mu-plugin
| Característica | Plugin tradicional | mu-plugin |
|---|---|---|
| Pode ser ativado/desativado via painel | Sim | Não |
| Carregado automaticamente | Não | Sim |
| Pode conter múltiplos arquivos por plugin | Sim | Não (apenas 1 arquivo por plugin) |
| Ideal para | Funcionalidades optativas | Funcionalidades obrigatórias e ajustes do core |
| Dependente de tema ativo | Sim (em alguns casos) | Não |
4. Como criar um mu-plugin
- Crie a pasta (se necessário):
mkdir -p wp-content/mu-plugins
- Crie um arquivo PHP dentro dela, por exemplo:
wp-content/mu-plugins/meu-ajuste-obrigatorio.php
- Coloque dentro algo como:
<?php
/*
Plugin Name: Ajuste Obrigatório do Site
Description: Este mu-plugin força configurações obrigatórias no WordPress.
*/
add_filter( 'upload_size_limit', function() {
return 10 * 1024 * 1024; // 10 MB
});
- Salve e pronto. Não precisa ativar. Está em execução.
5. O que pode ser feito com mu-plugins
- Forçar configurações obrigatórias do site
- Bloquear funcionalidades específicas (como o update do core)
- Adicionar ajustes de segurança
- Registrar tipos de post personalizados obrigatórios
- Alterar comportamentos default do WordPress
- Implementar integrações internas, logs ou rastreamentos
6. Regras e limitações
- Cada arquivo em
mu-plugins/é tratado como um plugin isolado. Diferente da pastaplugins/, que pode conter subpastas por plugin. - Se quiser ter múltiplos arquivos em um mu-plugin, você precisa criar um loader principal.
- Eles não são atualizados automaticamente pelo WordPress.
- Não aparecem na página “Plugins” comum, mas sim em uma aba separada chamada “Plugins obrigatórios”.
7. Exemplo: mu-plugin para remover update do core
<?php
/*
Plugin Name: Bloqueia Update do Core
Description: Oculta notificação de nova versão do WordPress.
*/
add_filter( 'pre_site_transient_update_core', '__return_null' );
Coloque esse código em wp-content/mu-plugins/bloqueia-core.php e pronto. Sem aviso de update do core.
8. Conclusão
mu-plugins são essenciais para desenvolvedores que precisam de controle total sobre o comportamento do WordPress em produção. Eles garantem que certas lógicas rodem sempre, sem depender de ativação via painel, e evitam que usuários ou terceiros desativem funcionalidades críticas.
Se você mantém sites para clientes, servidores multi-site, ou ambientes que exigem estabilidade, os mu-plugins são ferramentas que você deveria estar usando diariamente.