O que, Porquê e Como Criar um Plugin WordPress Específico para o Site

Um plugin específico do site permite que você adicione facilmente trechos de código ao seu site WordPress sem depender do seu tema. Ele permite que você use código personalizado para melhorar seu site e não se preocupe em ter que refazer tudo quando seu tema for atualizado.

Na WPBeginner, criamos muitos plugins específicos do site para adicionar shortcodes, novos tipos de postagem e outros recursos ao nosso site no passado. Além disso, também ajudamos nossos clientes a começar com plugins específicos do site.

Neste artigo, explicaremos como criar um plugin WordPress específico do site e por que ele é importante.

Plugin WordPress Específico do Site

O Que é um Plugin WordPress Específico do Site?

Um plugin WordPress específico do site é um plugin independente que você pode usar para adicionar todos os trechos de personalização que não dependem do tema.

Ao trabalhar em seu site, você frequentemente encontrará tutoriais do WordPress pedindo para você adicionar código ao arquivo functions.php do seu tema ou a um plugin específico do site.

O WordPress não vem com um plugin específico do site. Você precisará criar o seu próprio e, em seguida, instalá-lo e ativá-lo.

Por Que Criar um Plugin WordPress Específico do Site?

Como mencionamos anteriormente, você frequentemente encontrará tutoriais mostrando algum código que você pode adicionar ao arquivo functions.php do seu tema ou a um plugin específico do site.

Esses códigos personalizados podem ser usados para adicionar novos tipos de postagem, taxonomias, shortcodes e toneladas de hacks para melhorar seu site.

Se você adicionar o código personalizado ao arquivo functions do seu tema, ele desaparecerá se você atualizar ou trocar de tema.

Você pode criar um tema filho e usar o arquivo functions do tema filho para salvar seu código. No entanto, seu código ainda desaparecerá se você trocar de tema.

Um plugin WordPress específico para o site permite que você adicione facilmente trechos de código personalizados ao seu site WordPress e garanta que eles sejam independentes do tema. É um plugin WordPress autônomo, o que significa que não depende do seu tema, e você pode atualizar ou trocar de tema livremente.

Dito isso, vamos dar uma olhada em como adicionar facilmente código personalizado usando um plugin específico para o site. Mostraremos duas maneiras de fazer isso, e você pode escolher o método que funciona melhor para você (dica: o Método #2 é mais fácil para iniciantes).

Método 1: Criar Manualmente um Plugin WordPress Específico para o Site

Sabemos que isso pode parecer um pouco técnico para iniciantes, mas tentaremos tornar o mais simples possível para você.

Primeiro, você precisa criar uma nova pasta na sua área de trabalho e nomeá-la com o nome do seu site. Por exemplo: meu-site-plugin.

Criando sua pasta de plugin específica do site

Agora, abra um editor de texto simples no seu computador, como o Bloco de Notas ou o TextEdit.

Você precisa criar um novo arquivo e salvá-lo como meu-site-plugin.php na pasta do plugin na sua área de trabalho.

Criando o arquivo do plugin para o seu plugin específico do site

O arquivo do seu plugin precisa de um código de cabeçalho específico para que o WordPress possa reconhecê-lo como um plugin. Vá em frente e adicione o seguinte código ao seu arquivo meu-site-plugin.php:

<?php /* Plugin Name: Site Plugin for example.com Description: Site specific code changes for example.com */ /* Start Adding Functions Below this Line */ /* Stop Adding Functions Below this Line */ ?> 

Você pode substituir example.com pelo nome do seu próprio domínio. Assim que fizer isso, seu plugin específico do site estará pronto.

Existem duas maneiras de fazer o upload do seu plugin específico do site para o seu site. Você pode fazer o upload através do seu painel de administração do WordPress ou usar FTP.

1. Instalar Plugin Específico do Site da Área de Administração do WordPress (Recomendado)

Este método é mais fácil e recomendado para todos os usuários.

Primeiro, você precisa criar um arquivo zip da pasta do seu plugin específico do site.

Usuários do Windows podem simplesmente clicar com o botão direito na pasta do plugin e selecionar Enviar para » Pasta compactada (zip).

Criando arquivo zip no Windows

Usuários de Mac precisam clicar com o botão direito.

Em seguida, selecione “Compactar meuwebsite-plugin”.

Criando uma pasta zip no Mac

Assim que você tiver o arquivo zip do plugin, vá para a página Plugins » Adicionar Novo na área de administração do seu WordPress.

Em seguida, clique no botão ‘Upload Plugin’ no topo.

fazer upload do plugin

Em seguida, clique no botão ‘Escolher Arquivo’ para selecionar o arquivo zip que você criou anteriormente e, em seguida, clique no botão ‘Instalar Agora’.

O WordPress agora fará o upload e instalará o plugin para você. Assim que for carregado, você precisará clicar no botão ‘Ativar Plugin’ para começar a usar seu plugin específico do site.

Ativar plugin

2. Faça o upload do seu plugin específico do WordPress via FTP

Para este método, você não precisa criar um arquivo zip. Você estará fazendo o upload do plugin via FTP.

Primeiro, você precisará se conectar ao seu site usando um cliente FTP.

Uma vez conectado, vá para a pasta /wp-content/plugins/ na coluna do site remoto. Em seguida, você precisa selecionar a pasta do seu plugin específico do site e fazer o upload para o seu site.

Enviando plugin via FTP

Seu cliente FTP agora transferirá a pasta do seu plugin específico do site para o seu site WordPress. Isso instalará o plugin no seu site.

No entanto, você ainda precisará ativar o plugin para começar a usá-lo. Você pode fazer isso indo para a página ‘Plugins’ dentro da sua área de administração do WordPress e, em seguida, clicando no link ‘Ativar’ abaixo do seu plugin específico do site.

Ativar plugin

Isso é tudo. Seu plugin específico do site agora está pronto para ser usado.

Adicionando Snippets de Código Personalizado ao Seu Plugin Específico do Site

Existem duas maneiras de editar seu plugin e adicionar snippets de código personalizados a ele.

O primeiro método é fazê-lo através da área de administração do WordPress. Você pode ir para a página Plugins » Editor.

Você verá uma mensagem de aviso e precisará clicar no botão ‘Eu entendo’ para continuar. Alternativamente, se você deseja uma maneira mais segura de editar os arquivos, pule para o segundo método abaixo.

Aviso de atenção na ferramenta de edição de plugins

Em seguida, você precisará selecionar seu plugin específico do site no menu suspenso rotulado ‘Selecionar plugin para editar’.

O editor carregará seu arquivo de plugin e você poderá adicionar trechos de código a ele.

Selecione um plugin para editar na ferramenta de editor de arquivos de plugin

Quando terminar, clique no botão ‘Atualizar Arquivo’ para salvar suas alterações.

Se algo estiver faltando em seu código ou se ele tiver o potencial de quebrar seu site, o editor de plugins desfará automaticamente suas alterações.

No entanto, se o editor falhar e você vir a tela branca da morte, você poderá usar o FTP para editar seu arquivo de plugin e desfazer essas alterações.

O segundo método é editar diretamente o arquivo do plugin usando FTP. Simplesmente vá para a pasta do plugin usando seu cliente FTP. Clique com o botão direito no arquivo do plugin e selecione ‘Visualizar/Editar’.

Editando arquivo de plugin via FTP

Você também pode baixar o arquivo do plugin para o seu computador, editá-lo e depois carregá-lo de volta.

Método 2: Adicionando Código Personalizado Usando WPCode (Recomendado)

Este método é muito mais simples e oferece uma maneira melhor de gerenciar seus trechos de código individuais no WordPress usando WPCode.

A primeira coisa que você precisa fazer é instalar e ativar o plugin gratuito WPCode em seu site. Para mais detalhes, consulte nosso guia passo a passo sobre como instalar um plugin do WordPress.

Post Relacionado: Para mais informações, confira nossa análise completa do WPCode.

Após a ativação, o plugin adicionará um novo item de menu rotulado como ‘Code Snippets’ ao seu menu de administração do WordPress. Clicar nele o levará a uma página onde você pode gerenciar todos os seus códigos personalizados.

Para adicionar seu primeiro trecho de código, clique no botão ‘Add New’.

Clique no Botão Adicionar Novo para Adicionar seu Primeiro Trecho de Código Personalizado no WordPress

Isso o levará à página ‘Add Snippet’. Aqui, você pode escolher um trecho de código da biblioteca pré-fabricada ou adicionar seu código personalizado.

Para adicionar código personalizado, navegue até a opção ‘Add Your Custom Code (New Snippet)’ e clique no botão ‘Use snippet’.

Adicione seu novo trecho de código personalizado no WPCode

Agora, você pode inserir um título para o seu trecho de código personalizado. Pode ser qualquer coisa que ajude você a identificar o código.

Depois disso, você pode prosseguir e colar seu trecho de código na caixa de código. Você também precisa selecionar o tipo ‘Trecho de PHP’ na lista suspensa ‘Tipo de Código’ à direita.

Adicionando código personalizado

Você também pode adicionar notas para o código na seção ‘Informações básicas’.

Você deve usar esta área para anotar o que este código faz, onde você o encontrou e por que você o está adicionando ao seu site. Isso ajudará o “você do futuro” a se lembrar por que o “você do passado” adicionou este código.

Adicione notas e tags para identificar e organizar seus trechos de código

Você também tem a opção de atribuir tags aos seus trechos de código, o que pode ajudar a organizar os trechos de código por tópico e funcionalidade.

O plugin também permite que você selecione como deseja executar o trecho de código. Na seção ‘Inserção’, você pode selecionar o método ‘Inserção Automática’ para inserir e executar o código automaticamente em seu site.

Você pode escolher entre as opções área administrativa, front-end ou em todos os lugares. Se você não tiver certeza, mantenha a opção padrão ‘Executar em Todos os Lugares’.

Escolha o método de inserção para o seu snippet de código personalizado

Ou, você pode escolher o método ‘Shortcode’. Com este método, o trecho não é inserido automaticamente. Depois de salvar o trecho, você receberá um shortcode que poderá inserir manualmente em qualquer lugar do seu site.

Você também pode usar a seção ‘Lógica Condicional Inteligente’ para mostrar ou ocultar trechos inseridos automaticamente com base em um conjunto de regras.

Use lógica condicional inteligente para decidir quando os trechos devem ser carregados

Por exemplo, você pode carregar trechos de código apenas para usuários logados, carregar trechos de código PHP apenas em URLs de páginas específicas, mostrar trechos de código com base no tipo de página e muito mais.

Finalmente, você pode alternar o interruptor de ‘Inativo’ para ‘Ativo’ e, em seguida, clicar no botão ‘Salvar Trecho’.

Salvar e ativar seu trecho de código personalizado

Se você quiser salvar o trecho de código sem ativá-lo, você pode clicar apenas no botão ‘Salvar Trecho’.

Depois de salvar e ativar um trecho de código, ele se tornará automaticamente eficaz em seu site, se esse for o método de inserção que você escolheu.

Para mais detalhes, veja nosso guia sobre como adicionar facilmente trechos de código personalizados no WordPress.

Esperamos que este artigo tenha ajudado você a aprender por que e como criar um plugin do WordPress específico para o site. Você também pode querer ver nossa lista de dicas úteis para o arquivo de funções e os hacks mais desejados do WordPress para usar melhor seu plugin específico para o site.

Se você gostou deste artigo, por favor, inscreva-se em nosso Canal do YouTube para tutoriais em vídeo do WordPress. Você também pode nos encontrar no Twitter e no Facebook.

Aviso: Nosso conteúdo é apoiado pelos leitores. Isso significa que, se você clicar em alguns de nossos links, poderemos ganhar uma comissão. Veja como o WPBeginner é financiado, por que isso importa e como você pode nos apoiar. Aqui está nosso processo editorial.

O Kit de Ferramentas Definitivo para WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!

Interações do Leitor

119 CommentsLeave a Reply

  1. É possível adicionar trechos de código como o Código do Google Analytics, código do Adsense em um Plugin Específico do Site. Ou só é possível adicionar códigos que geralmente colocamos no arquivo functions.php.

    Quero dizer, é possível adicionar códigos no plugin específico do site que geralmente colocamos no arquivo Header.php.

  2. oi
    Obrigado por este tuto
    no entanto, existe uma maneira de fazer este plugin (para não ser visível) não na lista de plugins e também em uma pasta específica (não na pasta wp-content)?

    Obrigado

    • Na verdade sim, existe:
      Em vez de colocar o plugin em …/wp-content/plugins/, você o coloca em …/wp-content/mu-plugins/ (Você pode ter que criar esse diretório, se ele ainda não existir.

      Plugins que são colocados em mu-plugins são SEMPRE executados, então a única maneira de desativar um plugin MU (MU atualmente é interpretado como “must use” - deve usar) é excluí-lo (ou renomear o diretório mu-plugins para outra coisa…).

  3. Olá, tentei fazer o plugin específico do site, mas não está funcionando, recebo esta mensagem “O pacote não pôde ser instalado. Nenhum plugin válido foi encontrado.

    Falha na instalação do plugin.
    O que eu faço?

    • Olá Judith,

      Isso geralmente significa que as informações do cabeçalho do plugin estão incorretas. Você pode tentar novamente e garantir que o cabeçalho do seu plugin esteja exatamente no formato exibido no tutorial.

      Admin

      • Eu recebo este mesmo erro. Tentei umas 10 vezes. Fiz o upload pelo admin e pelo FTP. Não consigo fazer o upload. Estou usando o TextEditor para colar o código. Notei várias coisas que você não menciona na postagem que me pergunto se podem ser um problema. Primeiro, não me deixa salvar o arquivo como .php. Tenho que salvá-lo como .php.rtf OU .rtf e depois voltar e renomear o arquivo depois de salvo.
        Segundo, não tenho certeza do que você quer dizer com garantir que o formato do cabeçalho do plugin seja exatamente o mesmo. O número da linha deve estar lá? Se sim, não consigo fazer isso funcionar. Se eu copiar e colar com os números de linha, a linha vertical verde não aparece e não há espaço entre os números de linha e o código. Ou devo apenas copiar o código (sem os números de linha)? De qualquer forma, tentei tudo o que pude com meu aplicativo Textedit atual e ele não funcionará.
        Alguma ideia? Posso enviar capturas de tela do que exatamente tenho se você quiser.

        • Olá Jonathan,

          Você precisará salvar o arquivo como .php. Por favor, use um editor de texto diferente no Windows, você pode usar o Bloco de Notas ou baixar o Notepad++. No Mac, você pode usar o TextEdit ou baixar e instalar o TextWrangler.

          Você não precisa copiar e colar os números das linhas.

        • No meu caso, o problema foi que o arquivo tinha codificação Unicode. Alterá-la para ANSI corrigiu o problema.

  4. Olá,
    Bom dia!
    Gostaria de saber como configurar um white paper no meu artigo de blog para que os visitantes possam baixá-lo adicionando o endereço de e-mail.
    Obrigado, Ikram

  5. Editei alguns códigos no Style.css. Eles serão sobrescritos se eu atualizar um tema?
    É possível criar um arquivo style.css neste plugin específico do site?

  6. Tela branca ao publicar páginas.
    O código funciona para mostrar páginas filhas em uma página pai usando o shortcode, no entanto, estou recebendo uma tela branca. Alguém sabe o porquê?

  7. O plugin gerou 3 caracteres de saída inesperada durante a ativação. Se você notar mensagens de "headers already sent", problemas com feeds de sindicação ou outros problemas, tente desativar ou remover este plugin.

  8. Acredito que a melhor abordagem para adicionar código personalizado a um site é um tema filho. Não importa se precisamos personalizar o tema ou não. Tenho o hábito de sempre usar um tema filho, mesmo que não haja personalização. Esse hábito economizou meu tempo e esforço muitas vezes. Não acho que seja bom criar um plugin extra para tal personalização.

    Eu acredito no uso mínimo de plugins, não importa o quão simples você tenha criado um.

  9. O que é melhor, plugin específico do site ou Tema Filho? ou ambos?

    Preciso criar um tipo de post personalizado para adicionar algumas funcionalidades importantes ao meu site, então o plugin é melhor ou o tema filho e seu functions.php?

    Obrigado!

    • A questão é que você está criando o plugin sozinho, usando as funções da mesma forma exata. Portanto, a resposta à sua pergunta seria que nenhum é melhor, porque você deve usá-los JUNTOS.

  10. Como eu criaria um novo diretório de plugin no Azure? Tenho o WordPress rodando no Azure usando MS SQL Server, que ativei usando o Project NAMI.

  11. não funciona em multisite com o tema publisher, você pode me ajudar? este é o meu site e também me diga como posso remover a imagem em destaque dentro da postagem, não da página inicial das postagens mais recentes

  12. Olá,
    Vocês, iniciantes em WP, são demais. E quero agradecer por suas lutas por nós.
    Agora, vamos ao ponto. Instalei um tema e, nesse tema, há uma função que exibe a barra de ferramentas do WP para convidados. Tentei muitas vezes encontrar essa função nos arquivos do tema para removê-la, mas não consegui. Então, por favor, ajudem-me a remover essa barra de ferramentas, que é exibida para todos os visitantes com o logotipo do WordPress e o próprio link do WordPress para o site deles. Captura de tela anexada.

  13. Algo assim funciona para plugins também? Estou descobrindo que estou fazendo algumas alterações em plugins que adiciono ao meu site... muitas vezes excluindo certas linhas de código que não quero. Presumo que, depois de atualizar esse plugin, todas as minhas alterações serão apagadas. Como posso evitar isso?

  14. Olá, obrigado pela postagem. Estou recebendo um erro quando ativo o plugin por algum motivo:

    Parse error: syntax error, unexpected '*', expecting identifier (T_STRING) on line 9

    Alguma ideia do que fiz de errado?

    Obrigado!

    • Olá Elizabeth,

      Há um asterisco inesperado no código na linha 9, que está bloqueando o script php. Edite o arquivo novamente e copie o código exatamente como mostrado acima. Certifique-se de não copiar os números das linhas no código, clique no botão Copiar no canto superior direito da caixa de trecho de código.

      .

      Admin

  15. Tentei nomear a nova pasta como você fez no exemplo, mas recebi um erro que dizia algo como que você não pode usar um nome assim. Esta instrução pode ser útil para alguns – mas é muito difícil e confusa para mim e não ajuda em nada. Como eu disse – você precisa explicar isso até os mínimos detalhes ou, caso contrário, esses tutoriais não ajudarão. O nome deste site é wp BEGINNER – e é isso que eu sou. Você projeta esses tutoriais para os mais experientes.

    Acho que terei que começar a ir a outros lugares para obter instruções para iniciantes porque, na maioria das vezes, o wp beginner não é útil – é mais como um clube apenas para técnicos.

  16. Como chego a /wp-content/plugins/yoursitename-plugin/ no WordPress e faço upload de um arquivo lá? Estou perdido na primeira linha de instrução. Vocês sempre assumem que sabemos essas coisas em suas instruções, mas elas não são claras o suficiente.

    Fui ao cpanel e abri wpcontent > plugins – e ele mostra uma lista de plugins – mas a partir daqui estou perdido. Como faço para fazer o upload de um arquivo aqui? Sou iniciante – e vocês parecem sempre explicar as coisas como se estivessem instruindo técnicos experientes. Não sou, mas vou ao WP Beginner para tentar aprender. Geralmente é difícil seguir suas instruções e acabo tendo que ir a outro lugar no Google para encontrar coisas explicadas em um nível de iniciante.
    Se você quiser ser mais prestativo, tente detalhar um pouco mais as coisas de forma mais simples.

    • Olá Steven,

      Eu conheço o sentimento! Estou longe de ser um especialista em WordPress e vivo praticamente de pesquisas no Google e neste site tentando aprender. Sei um pouco e consegui fazer isso funcionar. Envie-me seu e-mail e eu lhe enviarei os passos com capturas de tela. Eu não testei colocar código real no plugin, então veremos se isso funciona... mas eu consegui ver o plugin recém-criado na minha página de administração.

  17. Obrigado pelas ótimas dicas e instruções simples de como fazer. Criei facilmente um Plugin WordPress Específico do Site para o meu site e ativei os shortcodes para widgets. Agora tenho menos preocupação ao trocar de temas, e não precisei instalar outro plugin. Novamente, obrigado!

  18. olá, segui as instruções de como fazer um plugin para o meu site. fiz o upload mas não consigo vê-lo na minha lista de plugins.

    alguma ideia do porquê?

  19. Não consigo encontrar onde as pastas ficam no diretório do plugin. Tentei procurar por: /wp-content/plugins/yoursitename-plugin/ (com o nome do meu site).

  20. Deixe pra lá, descobri e consegui ativá-lo. Meu servidor de hospedagem estava com problemas, deve ter expirado ou algo assim... valeu!

  21. Segui suas instruções, mas não sei como ativá-lo. Ele não aparece na minha lista de plugins no meu wp-admin. Você pode ajudar?

Deixar uma resposta