Criar um plugin para WordPress é mais fácil do que você pensa
Publicados: 2014-06-1025% de desconto em produtos Beaver Builder! Apresse-se, a promoção termina... Saiba mais!
Até alguns anos atrás, eu não tinha escrito um único plugin para WordPress. Eu criei e personalizei muitos temas para nossos clientes, mas por algum motivo, dizia a mim mesmo que criar um plugin estava além das minhas capacidades.
Em retrospectiva, eu não poderia estar mais errado.
Se você já se sentiu assim, deixe-me dizer uma coisa. Criar um plugin para WordPress não está além de suas capacidades. Qualquer pessoa que tenha habilidades suficientes para escrever PHP básico e modificar um tema pode criar um plugin.
Foi assim que iniciei o plugin Beaver Builder ( é gratuito, então você pode experimentá-lo ) e como você pode iniciar o seu também.
Se você é como eu, provavelmente está adicionando funcionalidades ao seu tema em vez de criar um plugin. Há muitos casos em que isso é aceitável, mas também há casos em que é melhor adicionar funcionalidades personalizadas a um plug-in. Por que você pode perguntar?
Considere este cenário.
Você adicionou funcionalidade ao seu tema que altera o gravatar padrão para o seu próprio gravatar personalizado. O único problema é que você acabou de mudar de tema e agora acabou. Se você tivesse adicionado esse código a um plugin, ele ainda estaria lá quando você decidisse mudar de tema.
Encontramos esse problema com a rede multisite do Tabata Times. Eles usam vários temas que precisam compartilhar funcionalidades personalizadas. Como você acha que resolvemos esse problema? Você adivinhou, adicionando uma boa parte da funcionalidade em um plugin para que fique disponível para todos os sites da rede, independentemente do tema que estejam usando.
Não se prenda a um tema. Use plug-ins #WordPress para funcionalidade. Compartilhar no XEu não estou brincando. Você pode criar um plugin para WordPress em cinco etapas simples. Deixe-me mostrar como…
A primeira coisa que você precisa fazer é acessar seu site via FTP usando o programa FTP de sua preferência (o meu é o Coda). Se você não estiver familiarizado com FTP, recomendo que leia sobre isso antes de prosseguir.
Depois de acessar seu site via FTP, você precisará navegar até a pasta de plug-ins do WordPress. Essa pasta quase sempre está localizada em/wp-content/plugins.
Agora que você está na pasta de plugins é hora de criar uma pasta para a sua! Vá em frente e crie uma nova pasta, dando a ela um nome exclusivo usando letras minúsculas e travessões, como my-first-plugin. Depois de fazer isso, insira sua nova pasta e passe para a próxima etapa.
Em seguida, você precisará criar o arquivo principal do seu plugin. Para fazer isso, crie um arquivo PHP dentro da sua nova pasta de plugins e dê a ele o mesmo nome, como my-first-plugin.php. Depois de fazer isso, abra o arquivo principal do seu plugin e prepare-se para fazer algumas edições.
Por fim, copie e cole as informações do plugin abaixo em seu arquivo principal do plugin. Certifique-se de editar os detalhes como nome do plug-in e URI do plug-in, pois pertencem ao seu plug-in.
<?php /** * Plugin Name: My First Plugin * Plugin URI: http://www.mywebsite.com/my-first-plugin * Description: The very first plugin that I have ever created. * Version: 1.0 * Author: Your Name * Author URI: http://www.mywebsite.com */
É isso! Você acabou de concluir o número mínimo de etapas necessárias para criar um plugin do WordPress. Agora você pode ativá-lo no administrador do WordPress e desfrutar de toda a sua glória.
Neste ponto, você provavelmente está se perguntando o que esse plugin deve fazer. Bem, isso não faz nada! Eu disse que mostraria como criar um plugin, não disse que mostraria como criar um plugin que faça qualquer coisa.
Brincadeiras à parte, o objetivo deste post é ilustrar como é simples começar a criar plugins para WordPress. Prepare um com as etapas descritas acima e você estará pronto para começar a fazer as coisas acontecerem.
Agora que você tem um plugin, vamos fazer alguma coisa.
A maneira mais fácil de fazer as coisas acontecerem no WordPress é com ações e filtros. Vamos explorar isso criando uma ação simples que adiciona uma linha de texto abaixo de todas as postagens do seu site. Copie e cole este código no arquivo principal do plugin (abaixo das informações do plugin) e salve-o.
add_action( 'the_content', 'my_thank_you_text' ); function my_thank_you_text ( $content ) { return $content .= '<p>Thank you for reading!</p>'; }
Este código se conecta à ação “the_content” que é acionada quando o WordPress renderiza o conteúdo da postagem para o seu site. Quando essa ação for acionada, o WordPress chamará nossa função “my_thank_you_text” que está definida abaixo da chamada “add_action”.
Se você chegou até aqui, esperamos que concordemos que criar um plugin simples para WordPress é relativamente fácil. Mas e se você quiser criar um plugin que faça mais do que realizar uma tarefa simples?
Se você vai começar a codificar seus próprios plug-ins, sugiro que você se familiarize com como as ações e filtros funcionam e quais estão disponíveis para uso. O WordPress Codex é onde passo grande parte do meu tempo, sugiro que você faça o mesmo.
API de plug-in: ações e filtros
API de plug-in: referência de ação
API de plug-in: referência de filtro
Novamente, passo muito tempo no WordPress Codex lendo sobre as funções principais enquanto desenvolvo meus plug-ins. Existem tantas funções básicas que eu não esperaria que você soubesse o que cada uma delas é e faz. Afinal, é para isso que serve o Codex, então use-o!
Finalmente, se você acabar criando um plugin que faz algo bacana, você provavelmente desejará criar uma página de opções para que as pessoas que o utilizam possam modificar a funcionalidade. Não é necessário criar uma página de opções, existem muitos plugins que instalam e fazem algo sem ela, mas ter uma pode ser uma boa adição para os usuários do seu plugin.
Criar uma página de opções está além do escopo deste post, então mais uma vez vou deixar você nas mãos do WordPress Codex.
Escrevendo um plug-in
Criando páginas de opções
Criar plug-ins para WordPress é extremamente libertador e uma ótima maneira de obter um conhecimento mais profundo de como o WordPress funciona. Se ainda não o fez, recomendo fortemente que você tente criar um plugin. Se você fizer isso e encontrar alguma coisa útil, não se esqueça de que você pode distribuí-lo gratuitamente para outras pessoas por meio do diretório de plugins do WordPress.
Você já criou seu primeiro plugin ou planeja criar um em breve? Se sim, eu adoraria ouvir sobre isso nos comentários abaixo!
Um artigo inspirador e estimulante.
Especialmente para mim, como você mencionou que tem medo do lado do código do WordPress.
Gosto e uso muito o WordPress.
Quando se trata de adicionar alguns recursos, eu opto por plug-ins
Mas como você mencionou, os plugins faltam algumas funções para atender todas as minhas necessidades.
Então fico bloqueado para ir mais longe em meus projetos. Porque não consigo fazer as modificações necessárias nos códigos.
Portanto, estou realmente ansioso para poder lidar com o códice do WordPress e sair dos projetos.
Obrigado mais uma vez pelo conteúdo inspirador e motivador.
Legal. Bom o suficiente para um impulso inicial
Que artigo legal! Que tal outro sobre como converter um modelo html em um tema wordpress?
Isso foi extremamente útil! Obrigado
Quebra-gelo muito útil para pessoas como eu que tinham a mesma fobia de olhar 'nos bastidores' dos plugins! Obrigado.
Uau! Muito obrigado por isso, posso escrever plugins agora. sempre me perguntei como esses caras escrevem, nunca imaginei que era tão fácil! Minhas dúvidas foram esclarecidas.
Sempre pensei que os temas filhos fossem a melhor maneira de resolver esse problema, mas, infelizmente, se eu mudar os temas pais, perco a funcionalidade. Isso faz muito sentido. Obrigado!
Sim! Você me pegou em “Eu não disse que mostraria como criar um plugin que faz qualquer coisa. ”
Ótima maneira de ensinar e manter o usuário envolvido!
Agora estou adicionando interface de administração ao meu plugin… muito obrigado!
Acho que pode estar faltando uma tag de fechamento do PHP: ?> Obrigado pelo tutorial!
Se um arquivo contém apenas código PHP, é preferível omitir a tag de fechamento do PHP no final do arquivo. Isso evita que espaços em branco acidentais ou novas linhas sejam adicionadas após a tag de fechamento do PHP, o que pode causar efeitos indesejados porque o PHP iniciará o buffer de saída quando não houver intenção do programador de enviar qualquer saída naquele ponto do script.
Interessante. Os outros tutoriais que li incluem a tag de fechamento, então presumi que fosse um erro, mas você está totalmente certo.
Obrigado
Obrigado por esta postagem para todos nós, novatos do WP. Posso fazer uma pergunta boba – se eu adicionar o código PHP do arquivo functions.php do meu tema filho ao arquivo php principal do novo plugin, ele fará a mesma coisa, mas será independente do tema, certo? Obrigado
Depois de ler todo o seu artigo com atenção, crio meu primeiro plugin para WordPress. Obrigado cara por compartilhar suas informações valiosas.
Belo post, são dicas úteis para mim. Obrigado por compartilhar.
Obrigado por esta ótima postagem que aumentou minha confiança em tocar no código do WordPress e criar meus próprios plug-ins.
Olá e obrigado pela informação
É add_action ou add_filter no código acima?
como eu sei, 'the_content' é um filtro, não uma ação. Então, em vez de add_action você deve usar add_filter
Ótima postagem. Mas há um pequeno bug no código. Em vez de add_action, você deve usar add_filter, pois the_content é um filtro.
Muito obrigado! muito útil
Oi,
Realizei seu tutorial e tive algumas ideias sobre como fazer um plugin. Parece que é realmente um artigo legal para todos os caras que seria prolífico para iniciantes. Mais pode ser ganho e espero que você me ajude.
Excelente! Uma abordagem muito fácil e prática para desenvolver plugins WP, gostei.
Estarei criando um plugin de calculadora para meu WP, que não consegui encontrar em nenhum lugar online.
Obrigado por compartilhar
Posso usar estas etapas para WordPress 5.3.x?
Olá, obrigado pelo básico, como a maioria já disse, mas depois de dar uma olhada no Wordpress, como sugerido, não consigo encontrar a página “Como adicionar” uma página “Ver detalhes”. Você sabe quantas pessoas estão usando, avaliações com estrelas, etc. Um link ou postagem sobre esse assunto seria bom.
Obrigado
Isso é uau! Achei que criar um plugin me custaria o céu e a terra.
Obrigado pela ótima postagem
Obrigado exatamente o que eu precisava!
Isso é ótimo, pois para alguém que está tentando decidir se quero entrar no desenvolvimento de plugins, isso foi realmente útil.
Hoje construí meu primeiro plugin. Obrigado pela inspiração
Este foi um artigo incrível! Acabei de fazer um plugin rápido usando o filtro de uso do módulo BB. Uau!
Ainda não criei um plugin, mas crio regularmente conteúdo personalizado para temas. Quando é bom usar um plugin e quando você não o aconselharia?
Estou considerando quais partes do meu tema atual quero dividir em plug-ins para ajudar no controle de versão.
Não quero ter muitos plug-ins ativados no site, mas também pretendo implementar plug-ins quando for inteligente fazê-lo e estou interessado em sua opinião sobre isso.
Agradável.
Eu estava pensando que criar um plugin para wordpress é uma tarefa muito difícil, mas depois de ler este blog minha mente mudou totalmente
obrigado.
Postagem perfeita! Gosto muito da sua mensagem simples e perfeita. Muito obrigado pela sua bela partilha. Passarei muito tempo no Codex para aprender suas dicas. obrigado novamente
Postagem simplesmente incrível. É útil para todos os blogueiros que usam WordPress.
ótimo e inspirador também