Escrevendo um plugin simples para WordPress, Tutorial para iniciantes

Na linguagem dos leigos, um plug-in WordPress é um programa simples que ajuda você a personalizar e aprimorar seu site WordPress sem precisar editar a programação principal. Quando você domina Desenvolvimento de plugins WordPress, você poderá adicionar todo tipo de funcionalidade ao seu blog WordPress em pouco tempo. Mas antes de se tornar um profissional, você deve aprender as cordas.


Um plug-in do WordPress é um programa, ou um conjunto de uma ou mais funções, escrito na linguagem de script PHP, que adiciona um conjunto específico de recursos ou serviços ao blog do WordPress, que pode ser perfeitamente integrado ao blog usando pontos de acesso e métodos fornecida pela Interface do Programa de Aplicativos Plugin do WordPress (API). – Escrevendo um plugin, WordPress Codex

Na postagem de hoje, orientaremos você no processo de criação do seu primeiro plugin do WordPress. Manteremos o tutorial simples para atender pela primeira vez o desenvolvedor que tem pouco ou nenhum conhecimento de PHP (a linguagem de script por trás do WordPress).

Antes de começarmos a codificação real, no entanto, veremos algumas coisas que você deve entender sobre o desenvolvimento de plugins do WordPress.

Informações básicas antes de criar um plug-in WordPress

Nesta seção, revelaremos o primeiros passos você precisa seguir ao criar um plugin do WordPress. Além disso, mencionaremos todas as várias coisas que você precisa levar em consideração ao escrever seu plugin. Ótimo. Vamos começar com o básico.

Como nomear um plug-in WordPress

Antes de tudo, você precisa criar um nome exclusivo para o seu plugin WordPress. Uma das melhores maneiras de determinar um nome favorável é pensar no que o seu plugin fará. Portanto, por exemplo, se o seu plug-in ajudar as pessoas a compartilhar conteúdo por meio das mídias sociais, você pode incluir a frase “compartilhamento de mídia social” no nome. Outra coisa, os nomes de plug-ins podem ser várias palavras, portanto, não diminua a criatividade.

O nome do seu plug-in deve ser exclusivo para evitar conflitos com outros plug-ins. Para garantir que seu nome seja exclusivo, você pode fazer uma pesquisa no Google sobre o nome. Além disso, você pode pesquisar os vários diretórios de plug-ins, incluindo o Repositório do plugin WordPress.

Para nomear qualquer plug-in, precisamos criar pelo menos um arquivo de plug-in (o principal arquivo PHP), que nos apresenta nossa próxima seção.

Como criar arquivos de plug-in

Um plug-in pode ser composto por um único arquivo PHP ou vários arquivos, dependendo do que foi projetado para fazer. O arquivo mais importante é o principal Arquivo PHP, que é equivalente a index.php e index.html nos temas WordPress e nos designs HTML, respectivamente.

É recomendável que os desenvolvedores do WordPress nomeiem seu arquivo principal de plug-in após o plug-in por convenção. Por exemplo, o arquivo principal do plug-in chamado WP Renym seria wp-renym.php. Se adicionar um separador em seu nome, use apenas hífens (-) entre palavras, em vez de sublinhados (_).

Como mencionado acima, um plug-in pode ser composto de um ou mais arquivos (imagens, JavaScript, idioma, arquivos CSS, etc.). De qualquer forma, seus arquivos de plug-in devem residir em um único diretório. Portanto, para um plug-in chamado WP Renym, o wp-renym.php arquivo seria colocado em um wp-renym pasta. Subpastas adicionais podem ser adicionadas dentro da pasta principal do plugin para conter e organizar outros arquivos.

Depois de definir todo o código de um plug-in, você comprime sua pasta principal em um arquivo zip (nesse caso, seria o arquivo wp-renym.zip) para ser carregado e instalado em um site WordPress.

Adicionando um cabeçalho de arquivo ao arquivo PHP principal

Ao nomear seu plug-in, você deve adicionar outros detalhes, como descrição, versão, licença, nome do autor – basicamente tudo o que aparecerá sob e ao lado do plug-in no Tela de plugins do WordPress – o cabeçalho do plugin. Para isso, você deve usar um cabeçalho de informações do plug-in padrão na parte superior do seu arquivo PHP principal. É assim que um cabeçalho típico se parece:


/ *
Nome do plug-in: nome do seu plug-in
URI do plug-in: http: // link para a página inicial do plug-in
Descrição: descreva o que é o seu plug-in em poucas frases curtas
Versão: 1.0
Autor: Seu nome (Yay! Aqui vem a fama ...)
Autor URI: http: // link para seu site
Licença: GPL2 etc
URI da licença: http: // link para sua licença de plug-in
* /

Todos os parâmetros no cabeçalho acima são auto-explicativos, por isso não vou entrar em detalhes. Apenas certifique-se de incluir as informações relevantes http: // ou https: // ao escrever seus URIs de plug-in e de autor ou os links não funcionarão.

Siga seu cabeçalho com as seguintes informações de licença, se você usar um Licença GPL2 ou uma licença compatível com o GPL2:

/ * Copyright YEAR PLUGIN_AUTHOR_NAME (email: seu endereço de email)
(Plugin Name) é um software gratuito: você pode redistribuí-lo e / ou modificar
sob os termos da Licença Pública Geral GNU, publicada pela
Free Software Foundation, versão 2 da Licença ou
qualquer versão posterior.

(Nome do plug-in) é distribuído na esperança de que seja útil,
mas SEM QUALQUER GARANTIA; sem sequer a garantia implícita de
COMERCIALIZAÇÃO ou ADEQUAÇÃO PARA UMA FINALIDADE ESPECÍFICA. Veja o
Licença Pública Geral GNU para mais detalhes.

Você deveria ter recebido uma cópia da Licença Pública Geral GNU
junto com (Nome do plug-in). Caso contrário, consulte (http: // link para sua licença de plug-in).
* /

O escopo deste tutorial não nos permite ir além dessas etapas básicas. Você precisará verificar o escrevendo um plugin guia no codex para saber mais sobre ganchos de plug-in do WordPress, tags de modelo, salvando dados de plug-in em bancos de dados, mecanismo de opções de plug-in e atualizando seu plug-in entre outras coisas. O códice também inclui uma enorme Recursos de plug-in coleção cheia de guias de vídeo, tópicos avançados e muito mais.

Agora que abordamos o básico, vamos escrever um plug-in WordPress simples que execute duas funções básicas (mas bacanas):

  • Substitua palavras no seu conteúdo por sua própria escolha de palavras
  • Adicione uma nota “Obrigado por ler este tutorial …” no final de cada postagem do blog.

Como escrever um plugin simples para WordPress – WP Renym

Nesta seção, escreveremos código para o plug-in WP Renym que venho mencionando o tempo todo.

O que você precisa:

Nomeando nosso plug-in

Primeiro, verificamos o repositório do plugin WordPress e fizemos uma pesquisa no Google em nosso nome; WP Renym estava livre. Minha escolha inicial foi WP Rename, mas já foi usada.

Seguindo em frente… Abra um novo arquivo no seu editor de código e adicione o seguinte código na parte superior depois de abrir o plugin com :

/ *
Nome do Plugin: WP Renym
URI do plug-in: http: // link para a página inicial do plug-in
Descrição: este plugin substitui as palavras por sua própria escolha..
Versão: 1.0
Autor: Freddy Muriuki
Autor URI: http: // link para seu site
Licença: GPL2 etc
URI da licença: https: // link para sua licença de plug-in

Copyright YEAR PLUGIN_AUTHOR_NAME (email: seu endereço de email)
(Plugin Name) é um software gratuito: você pode redistribuí-lo e / ou modificar
sob os termos da Licença Pública Geral GNU, publicada pela
Free Software Foundation, versão 2 da Licença ou
qualquer versão posterior.

(Nome do plug-in) é distribuído na esperança de que seja útil,
mas SEM QUALQUER GARANTIA; sem sequer a garantia implícita de
COMERCIALIZAÇÃO ou ADEQUAÇÃO PARA UMA FINALIDADE ESPECÍFICA. Veja o
Licença Pública Geral GNU para mais detalhes.

Você deveria ter recebido uma cópia da Licença Pública Geral GNU
junto com (Nome do plug-in). Caso contrário, consulte (http: // link para sua licença de plug-in).
* /

Salve o arquivo como wp-renym.php na pasta wp-renym. Se você ainda não tem a pasta, crie-a. wp-renym.php será o seu principal arquivo PHP.

Adicionando funções

Agora, para adicionar as funções reais ao plug-in. Logo abaixo do código acima, adicione a seguinte função para corrigir erros ortográficos de wordpress para WordPress:

função renym_wordpress_typo_fix ($ text) {
retornar str_replace ('wordpress', 'WordPress', $ text);
}
add_filter ('the_content', 'renym_wordpress_typo_fix');

renym_wordpress_typo_fix é o nome exclusivo que atribuímos à nossa função. Ao adicionar novas funções, nunca as inicie com wp_ – isso para evitar futuras incompatibilidades com as funções de código do WordPress que usam o prefixo wp_.

Nossa função PHP usa ($ text) como argumento e retorna a primeira string ‘wordpress’ substituída pela segunda string ‘WordPress’.

Adicionamos um filtro (add_filter) ao nosso plug-in para informar nossa função ( renym_wordpress_typo_fix ) para trabalhar no texto que selecionamos, que neste caso é o conteúdo completo da postagem (the_content).

Para substituir mais de uma palavra (talvez você queira editar várias palavras em seu blog ou usar o plug-in como um simples filtro de palavrões), substitua o código acima pelo seguinte:

função renym_content_replace ($ content) {
$ search = array ('wordpress', 'cabra', 'Páscoa', '70', 'sensacional');
$ replace = array ('WordPress', 'café', 'férias da Páscoa', 'setenta', 'extraordinário');
retornar str_replace ($ pesquisa, $ substituir, $ conteúdo);
}
add_filter ('the_content', 'renym_content_replace');

No código acima, já selecionamos as palavras para substituir, por exemplo wordpress, cabra, Páscoa, etc. Também selecionamos as palavras de substituição, por exemplo WordPress, café, férias da Páscoa etc. Espero que o código seja um pouco auto-explicativo:

  • o renym_content_replace A função aceita ($ content) como argumento, substitui todas as palavras contidas na matriz de pesquisa $ e retorna as palavras agora modificadas ao WordPress.
  • $ search contém todas as palavras a serem substituídas
  • $ replace contém as palavras de substituição
  • str_replace faz o que faz de melhor, substituindo palavras por novas

Observe como adicionamos o prefixo renym para todas as funções. Isso evita conflitos com outros plugins que podem estar instalados. Você deve adquirir o hábito de adicionar prefixos às suas funções, esteja desenvolvendo plugins, temas ou widgets.

Se você concluiu as etapas acima, seu plug-in pode substituir todas as palavras selecionadas com eficiência. Agora, adicione a nota “Obrigado por ler este tutorial …” que aparecerá na parte inferior de cada postagem. Adicione o seguinte código ao seu arquivo principal de plug-in ( renym_content_replace ) antes do fechamento do colchete PHP ( ?> ) Que vem na última linha:

função renym_content_footer_note ($ content) {
$ content. = '
Obrigado por ler este tutorial. Talvez da próxima vez eu deixe você me comprar um café! Para mais tutoriais sobre WordPress, visite nosso Blog
'; retornar $ conteúdo; } add_filter ('the_content', 'renym_content_footer_note');

Salve as alterações. o renym_content_footer_note A função adiciona a marcação HTML ao parâmetro $ content e retorna o novo valor ao WordPress. Também adicionamos uma classe de rodapé ao nosso texto para que ele possa ser facilmente estilizado mais tarde.

Incluímos um filtro (add_filter) que informa nossa função de operar no texto que selecionamos, que é o conteúdo da postagem, conforme representado pelo the_content.

Compactar sua pasta

Neste ponto, seu final wp-renym.php O arquivo deve ficar assim:

Obrigado por ler este tutorial. Talvez da próxima vez eu deixe você me comprar um café! Para mais tutoriais sobre WordPress, visite nosso Blog';
retornar $ conteúdo;
}
add_filter ('the_content', 'renym_content_footer_note');

?>

Salve todas as suas alterações. Compacte a pasta WP Renym em um wp-renym.zip arquivar (em um Mac é tão fácil quanto clicar com o botão direito, comprimir arquivos – e no PC eu acredito que seja muito parecido). Apenas verifique se o arquivo é salvo como extensão .ZIP ou se o plug-in não será instalado.

Use seu plug-in

Faça o upload e ative seu novo plug-in WP Renym por meio do Tela de plugins do WordPress. Parabéns por escrever seu primeiro plugin!

Instale o plug-in Renym WordPress

Recursos

Para saber mais sobre o desenvolvimento de plugins do WordPress, confira os seguintes recursos:

Conclusão

Espero que este tutorial tenha apontado você na direção certa, no que diz respeito à compreensão dos plugins. Este post deve servir como um trampolim para o desenvolvimento de plugins WordPress complexos que fazem o que você quiser. Não pare por aqui, confira os recursos que eu recomendei acima para aumentar seu conhecimento sobre o desenvolvimento de plugins do WordPress.

Se você achou este tutorial útil ou se tem mais alguma coisa a acrescentar, gostaríamos de saber. Compartilhe seus pensamentos na seção de comentários abaixo. Vejo você por aí ��

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map