Como criar um mu-plugin WordPress

Criar um "mu-plugin" (must-use plugin) para WordPress garante de forma eficaz que funcionalidades críticas estejam sempre ativas no seu site. Esse plugin é ativado automaticamente e não pode ser desativado pelo painel do WordPress, o que o torna ideal para recursos essenciais ou personalizações.

Outro caso de uso para um mu-plugin é adicionar funções extras a um plugin ou ao núcleo do WP. Por exemplo, o WP Staging conta com diversos filtros e hooks que podem agregar mais recursos às funcionalidades de staging ou de backup do WP Staging. Todos esses filtros documentados podem ser adicionados a um mu-plugin personalizado.

Introdução aos Must-Use Plugins

Os mu-plugins, ou plugins "must-use", são um tipo especial de plugin do WordPress. Ficam armazenados em um diretório separado (wp-content/mu-plugins) e são carregados automaticamente pelo WordPress. Esses plugins são ideais para códigos que precisam sempre ser executados, como funções personalizadas de um site, e ficam imunes a desativações acidentais.

Vantagens dos Mu-Plugins

  1. Ativação automática: os mu-plugins são ativados automaticamente e não podem ser desativados por acidente.
  2. Segurança reforçada: como não podem ser desativados pelo painel administrativo, oferecem uma maneira mais segura de implementar funcionalidades críticas.
  3. Facilidade de gestão: ideais para administrar múltiplos sites WordPress, pois simplificam a manutenção dos plugins essenciais.

Criar um Mu-Plugin

1. Acesse os arquivos do seu site

  • Acesse os arquivos do seu site via FTP ou pelo gerenciador de arquivos da sua hospedagem.

2. Localize o diretório Mu-Plugin

  • Navegue até o diretório wp-content.
  • Verifique se a pasta mu-plugins existe. Se não existir, crie-a.

3. Crie o arquivo do seu Mu-Plugin

  • Crie um novo arquivo PHP para o seu mu-plugin. Por exemplo, my-mu-plugin.php.
  • Use um editor de texto simples para escrever o seu código PHP.

4. Adicione o código ao seu Mu-Plugin

  • O seu mu-plugin deve começar com a tag de abertura do PHP <?php.
  • Abaixo está a estrutura básica de um arquivo mu-plugin:
PHP
<?php
/*
Plugin Name: My Custom Mu-Plugin
Description: A custom must-use plugin to enhance my WordPress site.
Version: 1.0
Author: Mickey Mouse
*/

// Your custom code goes here

Passo 5: envie o seu Mu-Plugin

  • Envie o arquivo .php para o diretório mu-plugins do seu servidor.

Passo 6: verifique a ativação

  • Como os mu-plugins são ativados automaticamente, verifique no seu site se o código personalizado está funcionando.

Exemplo de Mu-Plugin: texto personalizado no rodapé do admin

Como exemplo, vamos criar um mu-plugin simples que altera o texto do rodapé na área administrativa do WordPress.

PHP
<?php
/*
Plugin Name: Custom Admin Footer
Description: Changes the footer text in the WordPress admin area.
Version: 1.0
Author: Your Name
*/

add_filter('admin_footer_text', function () {
    echo 'Customized by Tony Stark - Powered by WordPress';
});

Conclusão

Criar um mu-plugin é um processo simples e direto que pode melhorar bastante a funcionalidade e a segurança do seu site WordPress. Seguindo os passos acima, você poderá implementar personalizações sempre ativas e proporcionar uma experiência consistente e confiável para o seu site.

Lembre-se de testar seus mu-plugins minuciosamente em um ambiente de staging antes de implantá-los em um site em produção, para garantir que funcionem como esperado.

Artigos relacionados

Rene Hermenau

Autor: Rene Hermenau

Sobre o autor: René Hermenau é o fundador do WP STAGING. Ele trabalha com backups do WordPress, ambientes de staging, migrações, gestão de bases de dados e fluxos de implantação seguros.