Eis a lista do que você precisará para criar um plugin WordPress:<\/p>
- \n
- Um editor de texto<\/li>\n\n\n\n
- Acesso FTP<\/a> ao seu plano de hospedagem<\/li>\n\n\n\n
- Uma instalação WordPress<\/a> ativa<\/li>\n<\/ul>
Você precisará do editor de texto para escrever o código do plugin. Alguns editores HTML<\/a> populares incluem o Notepad++<\/a> e o Atom<\/a>.<\/p>
Após instalar o editor de texto, conecte-o ao seu servidor FTP para realizar a modificação de código.<\/p>
Em seguida, configure um cliente FTP para fazer o upload do plugin ao seu site. Nós recomendamos usar o software FileZilla, pois ele é bastante simples de ser configurado.<\/p>
Por fim, certifique-se de que você tem uma instalação do WordPress ativa e atualizada. Existem várias maneiras de atualizar o WordPress<\/a> caso você tenha desativado as atualizações automáticas. Não se esqueça de fazer o backup dos seus arquivos<\/a> antes de realizar o update para evitar a perda de dados.<\/p>
Alternativamente, você pode instalar o WordPress localmente<\/a>. Este método não requer um site ativo, tampouco um domínio ou um plano de hospedagem. Dessa forma, você pode testar o seu plugin sem que seus visitantes vejam as mudanças imediatamente.<\/p>
Ter conhecimentos básicos de PHP será uma vantagem para o processo de desenvolvimento do seu plugin. Isso porque você precisará escrever funções personalizadas e trabalhar com funções próprias do WordPress. Ou seja: você ao menos precisará ter alguma familiaridade com convenções de nomes e estruturas de arquivos na linguagem PHP.<\/p>
Plugins WordPress x Temas WordPress<\/strong><\/h2>
A funcionalidade de um site WordPress pode ser alterada por meio de plugins e temas.<\/p>
Temas do WordPress têm um arquivo functions.php<\/strong> armazenado na pasta \/wp-includes\/<\/strong>. Ele permite que você adicione códigos personalizados para criar novas funções.<\/p>
Este método é eficaz para alterações menores, mas não é prático para mudanças maiores, que afetem o site como um todo.<\/p>
Isso porque as funcionalidades escritas no arquivo functions.php<\/strong> dependem se o tema está ativo ou não. Se você trocar ou desativar o tema, o WordPress reverterá as mudanças feitas no arquivo e exibirá uma mensagem de erro quando o site tentar chamar as funções perdidas.<\/p>
A não ser que você use um child theme<\/em>, atualizar o tema também substituirá o arquivo functions.php<\/strong>, te forçando a restaurar manualmente os códigos personalizados.<\/p>
É por isso que criar um plugin personalizado é tão útil. Ao fazer isso, você facilita a modificação de aspectos padrão do WordPress para que a plataforma se adapte às suas necessidades.<\/p>
Você pode adicionar plugins a qualquer instalação WordPress. Recursos trazidos pelo plugin permanecerão funcionais mesmo que você troque de tema. Além disso, você poderá atualizar o WordPress sem perder funções já criadas, economizando seu tempo e esforço.<\/p>
\n![\"\"](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2024\/06\/BR-New-WP_in-text-banner.png\/public\")
<\/a><\/figure><\/div>O Que São Hooks WordPress?<\/strong><\/h2>
Os plugins WordPress interagem com o código nuclear da plataforma por meio de hooks (ou ganchos). Existem dois tipos de hooks no WordPress:<\/p>
- \n
- Hooks de ação<\/strong> – adicionam ou removem funções.<\/li>\n\n\n\n
- Hooks de filtro<\/strong> – modificam dados produzidos pelas funções.<\/li>\n<\/ul>
Ações e Hooks de Ação<\/strong><\/h3>
Uma ação é uma função PHP chamada por meio de um hook de ação específico sempre que um usuário visita uma página WordPress. Desenvolvedores web podem adicionar suas próprias funções à lista de ações (ou remover as que já existem) adicionando o script de hook de ação wp_head()<\/strong> antes da tag de fechamento (<\/head><\/strong>) de qualquer página.<\/p>
Os hooks de ação são contextuais, o que significa que nem todas as páginas WordPress os chamam. A página de Referência para Ações de Plugins WordPress<\/a> traz uma lista completa dos hooks de ação e os contextos nos quais eles são chamados.<\/p>
Adicionando Funções a um Hook de Ação Usando o add_action()<\/strong><\/p>
Adicionar funções a um hook de ação num arquivo de plugin requer chamar a função add_action()<\/strong> com ao menos dois parâmetros.<\/p>
\/\/ Hook para a ação 'init', que é chamada depois que o WordPress termina de carregar o código principal\nadd_action( 'init', 'add_Cookie' );\n\/\/ Configura um cookie com o horário atual do dia\nfunction add_Cookie() {\n setcookie(\"last_visit_time\", date(\"r\"), time()+60*60*24*30, \"\/\");\n}<\/pre>O primeiro parâmetro é o nome do hook de ação<\/strong> ao qual você quer anexar o callback. Já o segundo parâmetro contém o nome da função<\/strong> que você pretende executar.<\/p>
O terceiro parâmetro, opcional, declara a prioridade<\/strong> da função. A prioridade padrão é 10, colocando a função personalizada depois de qualquer uma das nativas.<\/p>
O quarto parâmetro, também opcional, contém o número de argumentos<\/strong> ou parâmetros que a função personalizada pode receber. O valor padrão é 1.<\/p>
Exemplo: Código de Plugin para Exibir Texto Abaixo do Rodapé de Cada Página<\/strong><\/p>
Este exemplo de plugin chama o hook de ação wp_footer()<\/strong> antes da tag de fechamento <\/body><\/strong> de cada página e adiciona uma nova função, chamada mfp_Add_Text()<\/strong>. Como ela é parte de um plugin, a função continuará ativa mesmo caso você troque de tema.<\/p>
Salve o exemplo abaixo como um arquivo PHP e faça o upload dele para a pasta plugins<\/strong>.<\/p>
<?php\n\/*\nNome do Plugin: Adicionar Texto ao Rodapé\n*\/\n\/\/ Faz o gancho do hook de ação 'wp_footer', adiciona a ele a função 'mfp_Add_Text'\nadd_action(\"wp_footer\", \"mfp_Add_Text\");\n \n\/\/ Define 'mfp_Add_Text'\nfunction mfp_Add_Text()\n{\n echo \"<p style='color: black;'>Após o rodapé ser carregado, meu texto é adicionado!<\/p>\";\n}<\/pre>A captura de tela a seguir mostra o plugin em ação após ser ativado no painel de administração do WordPress:<\/p>
\n![\"plugin](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2022\/12\/plugin-text.png\/public\")
<\/figure><\/div>\n\n\n
Importante!<\/strong> Na linguagem PHP, seu script inteiro é analisado antes de ser executado. Escrever uma chamada add_action() no topo do arquivo, na ordem de execução desejada, e depois definir suas funções na mesma ordem tornará o arquivo mais fácil de ser lido.<\/p><\/div>\n\n\n\n<\/p>
Removendo Funções de um Hook de Ação Usando o remove_action()<\/strong><\/p>
Para remover uma ação de um hook de ação, escreva uma nova função chamada remove_action()<\/strong> e chame a função que você escreveu usando o add_action()<\/strong>.<\/p>
A função remove_action()<\/strong> também deve ter ao menos dois parâmetros.<\/p>
\/\/ Faz o gancho da ação 'init', que é chamada após o WordPress carregar seu código principal, adiciona a função 'remove_My_Meta_Tags'\nadd_action( 'init', 'remove_My_Meta_Tags' );\n\/\/ Remove a função 'add_My_Meta_Tags' do hook de ação wp_head \nfunction remove_My_Meta_Tags()\n{\n remove_action( 'wp_head', 'add_My_Meta_Tags');\n}<\/pre>O primeiro parâmetro é o nome do hook de ação<\/strong> ao qual a função está anexada, enquanto o segundo parâmetro contém o nome da função<\/strong> que você quer remover.<\/p>
O terceiro parâmetro, opcional, declara a prioridade<\/strong> da função original. Ela deve ser idêntica à prioridade originalmente definida quando a ação foi adicionada ao hook. Se você não definiu uma prioridade na função personalizada, não inclua este parâmetro.<\/p>
No próximo exemplo, nós vamos impedir que o texto adicional apareça no rodapé das postagens de segunda-feira.<\/p>
Uma forma de fazer isso é usar a função PHP date()<\/strong> para obter o dia atual, seguida por tags condicionais para checar se é segunda-feira. Após analisar as informações, a página executará a função remove_action()<\/strong> em cada postagem publicada nas segundas-feiras.<\/p>
<?php\n \/\/ Faz o gancho da ação 'wp_footer', executa a função 'mfp_Add_Text()'\nadd_action(\"wp_footer\", \"mfp_Add_Text\");\n\/\/ Faz o gancho da ação 'wp_head', executa a função 'mfp_Remove_Text()'\nadd_action(\"wp_head\", \"mfp_Remove_Text\");\n\/\/ Define a função 'mfp_Add_Text('), que simplesmente reproduz texto simples\nfunction mfp_Add_Text()\n{\n echo \"<p style='color: #FFF;'>After the footer is loaded, my text is added!<\/p>\";\n}\n\/\/ Define a função 'mfp_Remove_Text()' para remover a função anterior da ação 'wp_footer'\nfunction mfp_Remove_Text()\n{\n if (date(\"l\") === \"Monday\") {\n \/\/ Aponta para a ação 'wp_footer', remove dela a função 'mfp_Add_Text'\n remove_action(\"wp_footer\", \"mfp_Add_Text\");\n }\n}<\/pre>Filtros e Hooks de Filtro<\/strong><\/h3>
Um filtro é uma função PHP chamada por um hook de filtro que modifica dados gerados por funções existentes. Como os hooks de ação, os hooks de filtro também são contextuais.<\/p>
A lista completa de hooks de filtro e os contextos nos quais eles são chamados estão disponíveis na página de Referência para Filtros de Plugins WordPress<\/a>.<\/p>
Adicionar Filtros Usando o add_filter()<\/strong><\/p>
Adicionar uma função de filtro a um hook de filtro dentro de um arquivo de plugin requer o uso da função add_filter()<\/strong> com pelo menos dois parâmetros.<\/p>
\/\/ Faz o gancho do hook de ação 'the_content' (conteúdo de qualquer postagem), executa a função 'mfp_Fix_Text_Spacing'\nadd_filter(\"the_content\", \"mfp_Fix_Text_Spacing\");\n\/\/ Corrige automaticamente espaçamentos duplos em qualquer postagem\nfunction mfp_Fix_Text_Spacing($the_Post)\n{\n $the_New_Post = str_replace(\" \", \" \", $the_Post);\n return $the_New_Post;\n}<\/pre>O primeiro parâmetro é o nome do hook de filtro<\/strong> ao qual você quer adicionar o callback, enquanto o segundo parâmetro contém o nome da função<\/strong> que você quer executar quando o filtro é aplicado.<\/p>
O terceiro parâmetro, opcional, declara a prioridade<\/strong> da função. A prioridade padrão é 10, colocando a função personalizada atrás de todas as nativas.<\/p>
Há ainda um quarto parâmetro opcional, que indica o número de argumentos<\/strong> ou parâmetros que o filtro personalizado pode receber. O valor padrão é 1.<\/p>
Exemplo: Plugin para Alterar um Trecho de Post<\/strong><\/p>
O WordPress tem uma função que captura trechos de postagens, chamado get_the_excerpt()<\/strong>. Ela também é um hook de filtro. Adicionar este filtro após capturar o trecho alterará o texto em questão antes do site WordPress exibi-lo.<\/p>
O plugin de exemplo a seguir define uma função de filtro que captura o trecho como único parâmetro de entrada, adiciona algum texto antes dele e retorna o novo valor todas às vezes que o script chama a função get_the_excerpt()<\/strong>.<\/p>
Como o valor de retorno da função get_the_excerpt()<\/strong> é o trecho do texto em si, o plugin automaticamente fará a entrada do novo valor como o parâmetro $old_Excerpt<\/strong> da função quando chamado usando o add_filter()<\/strong>. A função definida pelo plugin deve retornar o novo valor<\/strong>.<\/p>
<?php\n\/*\nNome do Plugin: Adicionar Trecho \n*\/\n\/\/ Faz o gancho do hook de filtro get_the_excerpt, executa a função mfp_Add_Text_To_Excerpt\nadd_filter(\"get_the_excerpt\", \"mfp_Add_Text_To_Excerpt\");\n\/\/ Captura o trecho, adiciona algum texto antes dele e retorna o novo trecho\nfunction mfp_Add_Text_To_Excerpt($old_Excerpt)\n{\n $new_Excerpt = \"<b>Excerpt: <\/b>\" . $old_Excerpt;\n return $new_Excerpt;\n}<\/pre>Removendo Filtros Usando o remove_filter()<\/strong><\/p>
Remover um filtro é muito mais simples que remover uma ação, uma vez que o WordPress permite que você chame a função remove_filter()<\/strong> sem definir um novo filtro.<\/p>
No exemplo a seguir, nós vamos remover o trecho adicional do texto se o dia de hoje é terça-feira. Nós usaremos a função remove_filter()<\/strong> com pelo menos dois parâmetros.<\/p>
O primeiro deve conter o hook de filtro ao qual a função está anexada. O segundo parâmetro deve ser o nome do filtro que você quer remover. Adicione um parâmetro de prioridade caso você tenha definido um ao criar a função.<\/p>
\/\/ Faz o gancho do hook de filtro get_the_excerpt, executa a função mfp_Add_Text_To_Excerpt\nadd_filter(\"get_the_excerpt\", \"mfp_Add_Text_To_Excerpt\");\n\/\/ Se hoje é terça-feira, remove o filtro de the_excerpt()\nif (date(\"l\") === \"Thursday\") {\n remove_filter(\"get_the_excerpt\", \"mfp_Add_Text_To_Excerpt\");\n}\n\/\/ Captura o trecho, adiciona algum texto antes dele e retorna o novo trecho\nfunction mfp_Add_Text_To_Excerpt($old_Excerpt)\n{\n $new_Excerpt = \"<b>Excerpt: <\/b>\" . $old_Excerpt;\n return $new_Excerpt;\n}<\/pre>Agora que você tem um conhecimento básico de hooks e filtros, nós criaremos um plugin básico para WordPress que adicionará uma nova página com um link no painel de controle para administradores.<\/p>
\n\n\n\n
Importante!<\/strong> Usar um ambiente de testes WordPress para testar novos plugins é importante para evitar erros que podem causar quedas e falhas. Existem duas formas de criar um ambiente de testes: manualmente ou com um plugin como o WP Staging. Alternativamente, você pode instalar o WordPress localmente no seu computador.<\/p><\/div>\n\n\n\n<\/p>
Passo 1: Armazenando o Plugin<\/strong><\/h2>
O primeiro passo para criar um novo plugin é fazer uma pasta para armazenar seus arquivos. O nome da pasta deve ser único e descritivo. Cheque outros nomes de pastas no diretório \/wp-content\/plugins\/<\/strong> para se certificar de que o novo nome já não está em uso.<\/p>
Use um cliente FTP para se conectar à sua conta de hospedagem e facilitar o processo de upload de arquivos. Vá até a pasta wp-content -> plugins<\/strong> a partir do diretório principal do WordPress. Lá, crie uma nova pasta chamada meu-primeiro-plugin<\/strong> na pasta plugins<\/strong>.<\/p>
\n![\"criando](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2022\/12\/filezilla-plugin-1.png\/public\")
<\/figure><\/div>Passo 2: Criando o Primeiro Arquivo<\/strong><\/h2>
O arquivo principal do plugin contém as informações exigidas pelo WordPress para exibir o plugin na lista do painel de controle, onde você poderá ativá-lo.<\/p>
Crie um novo arquivo PHP, chamado meu-primeiro-plugin.php<\/strong>, na pasta criada anteriormente. Este arquivo principal conterá comentários de cabeçalho, com informações adicionais que o WordPress pode ler ou exibir.<\/p>
\n![\"criando](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2022\/12\/filezilla-plugin-2.png\/public\")
<\/figure><\/div>Após fazer o upload do arquivo, clique nele com o botão direito e selecione a opção “Ver\/Editar”<\/strong> para adicionar o código a seguir (isso pode ser feito por meio de um editor HTML):<\/p>
<?php\n\/*\nNome do Plugin: Meu Primeiro Plugin\nDescrição: Este é o meu primeiro plugin! Ele cria um novo link no menu de administração!\nAutor: Seu nome\n*\/<\/pre>
Você pode checar este manual PHP<\/a> para entender por que a tag de fechamento ?><\/strong> não é necessária aqui.<\/p>
Salve o arquivo. Em seguida, navegue à seção Plugins<\/strong> do seu painel WordPress. Se o WordPress tiver lido o arquivo corretamente, você verá o Meu Primeiro Plugin<\/strong> na lista:<\/p>
\n![\"meu](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2022\/12\/meu-primeiro-plugin.png\/public\")
<\/figure><\/div>Passo 3: Escrevendo as Funções do Plugin<\/strong><\/h2>
Antes de começar a escrever as funções para o plugin, é altamente recomendado que você dê um prefixo único a todos os arquivos, funções e variáveis a ele relacionados. Isso é importante para evitar conflitos com outros plugins. No nosso exemplo, nós usaremos o prefixo mfp<\/strong>, uma sigla para My First Plugin.<\/strong><\/p>
Crie uma nova pasta, chamada Includes<\/strong>, na pasta principal do plugin. Nós usaremos essa pasta para armazenar arquivos de suporte usados pelo arquivo principal. Nessa pasta, crie um arquivo PHP e o nomeie como mfp-functions.php<\/strong>. Abra o arquivo com a tag de início <?php<\/strong> na primeira linha.<\/p>
Este novo arquivo conterá todas as funções do seu plugin.<\/p>
Nós precisamos incluir o mfp.functions.php<\/strong> no arquivo principal do plugin para que outros arquivos do plugin usem as funções definidas por ele. Use o require_once<\/strong> para se certificar de que o plugin funcionará apenas caso o arquivo functions esteja presente.<\/p>
Edite o my-first-plugin.php<\/strong> conforme exibido abaixo. Em seguida, salve-o e faça o upload do arquivo novamente, sobrescrevendo a versão anterior quando solicitado.<\/p>
<?php\n\/*\nNome do Plugin: Meu Primeiro Plugin\nDescrição: Este é o meu primeiro plugin! Ele cria um novo link no menu de administração!\nAutor: Seu nome\n*\/\n\/\/ Inclui o mfp-functions.php, usa o require_once para interromper o script caso o mfp-functions.php não seja encontrado\nrequire_once plugin_dir_path(__FILE__) . 'includes\/mfp-functions.php';<\/pre>
A função do WordPress plugin_dir_path(__FILE__) <\/strong>permite que você inclua arquivos da pasta de plugins, dando o caminho completo ao diretório que armazena o novo plugin.<\/p>
Agora, retorne ao arquivo mfp-functions.php<\/strong> na pasta Includes. Como nosso plugin adicionará um novo link de topo ao menu de navegação do painel de controle do WordPress, nós usaremos uma função personalizada, chamada mfp_Add_My_Admin_Link()<\/strong>. Adicione o código abaixo ao arquivo mfp-functions.php<\/strong>:<\/p>
<?php\n\/*\n * Adiciona meu novo menu ao Painel de Controle do Administrador\n *\/\n\/\/ Faz o gancho do hook de ação 'admin_menu', executa a função 'mfp_Add_My_Admin_Link()'\nadd_action( 'admin_menu', 'mfp_Add_My_Admin_Link' );\n\/\/ Adiciona um novo link de topo ao menu do Painel de Controle do Administrador\nfunction mfp_Add_My_Admin_Link()\n{\n add_menu_page(\n 'Minha Primeira Página', \/\/ Título da página\n 'Meu Primeiro Plugin', \/\/ Texto para exibir no link do menu\n 'manage_options', \/\/ Requerimento de capacidade para visualizar o link\n 'includes\/mfp-first-acp-page.php' \/\/ O 'slug' - arquivo a ser exibido ao clicar no link\n );\n}<\/pre>\n\n\n\n
Importante!<\/strong> Agrupe funções similares e adicione uma descrição no topo de cada uma delas com um comentário de múltiplas linhas. Isso facilitará atualizações e correções de bugs no futuro.<\/p><\/div>\n\n\n\n<\/p>
A função mfp_Add_My_Admin_Link() <\/strong>usa a função nativa do WordPress add_menu_page()<\/strong> com ao menos quatro parâmetros, na seguinte ordem:<\/p>
- \n
- Título da página<\/strong> – o nome da página exibido na aba do navegador.<\/li>\n\n\n\n
- Título do menu<\/strong> – o texto usado para o item do menu. Em nosso exemplo, é o próprio nome do plugin.<\/li>\n\n\n\n
- Capacidade<\/strong> – requerimento de capacidade do usuário para visualizar o menu do plugin. No nosso caso, apenas usuários com a capacidade manage_options poderão acessar a página linkada.<\/li>\n\n\n\n
- Slug do menu<\/strong> – o arquivo que deve ser usado para exibir a página em si. Nós criaremos o arquivo mfp-first-acp-page.php<\/strong>, que será linkado na seção a seguir.<\/li>\n\n\n\n
- Função (opcional)<\/strong> – a função que gera o conteúdo da página.<\/li>\n<\/ul>
Anexar a função personalizada com o comando add_action() <\/strong>permite que o plugin chame o hook de ação sob determinadas circunstâncias. Adicionar o admin_menu<\/strong> como primeiro parâmetro chamará a função quando um usuário acessar o menu de administrador. Enquanto isso, o mfp_Add_My_Admin_Link<\/strong> é a função que será executada, por ser especificada como o segundo parâmetro.<\/p>
Por fim, faça o upload do arquivo mfp-functions.php<\/strong> à pasta Includes<\/strong>.<\/p>
Passo 4: Criando a Página de Administrador do Plugin<\/strong><\/h2>
Após definir as funções do plugin, é hora de construir a página que à qual o botão de menu nos levará. Crie um novo arquivo PHP chamado mfp-first-acp-page.php<\/strong> na pasta Includes<\/strong> e adicione o código a seguir:<\/p>
<div class=\"wrap\">\n <h1>Olá!<\/h1>\n <p>Essa é a primeira página do meu plugin<\/p>\n<\/div><\/pre>
Ao criar páginas de administrador, o WordPress recomenda isolar o código HTML com uma tag <div><\/strong> e dar a ela a classe “wrap”<\/strong>, para garantir que todo o seu conteúdo apareça no lugar correto. Fazer isso também ajudará a deixar o seu código mais limpo.<\/p>
Por fim, navegue até a seção Plugins<\/strong> do seu painel WordPress e ative o novo plugin. Se o processo for bem sucedido, o link para o painel de administração do seu novo plugin aparecerá na parte de baixo do menu de navegação.<\/p>
\n![\"meu](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2022\/12\/meu-primeiro-plugin-1.png\/public\")
<\/figure><\/div>Parabéns! Você criou seu primeiro plugin para WordPress.<\/p>
Se você criou o plugin num ambiente de testes, será necessário instalar o plugin no site em si. Os passos a seguir mostram como fazê-lo:<\/p>
- \n
- No FileZilla, clique com o botão direito na pasta my-first-plugin<\/strong> e selecione “Download”<\/strong>. Em seguida, comprima a pasta num arquivo ZIP.
![\"baixando](\"https:\/\/blog.hostinger.io\/br-tutoriais\/wp-content\/uploads\/sites\/53\/2022\/12\/filezilla-plugin-3.png\")
<\/li>\n\n\n\n- Navegue até o menu Plugins<\/strong> no painel do WordPress. Clique em “Adicionar novo”<\/strong>.<\/li>\n\n\n\n
- Clique em “Enviar plugin”<\/strong> e selecione o arquivo ZIP do seu plugin.
![\"tela](\"https:\/\/blog.hostinger.io\/br-tutoriais\/wp-content\/uploads\/sites\/53\/2022\/12\/adicionar-plugin.png\")
<\/li>\n\n\n\n- Selecione “Instalar agora”<\/strong> para iniciar o processo de instalação.<\/li>\n<\/ol>
\n\n\n\n
\nLeituras Sugeridas<\/h4>\n
Você quer saber em que linguagens os plugins do WordPress são escritos? Saiba mais nos guias a seguir:
\n\nO Que é HTML?<\/a>
\nO Que é CSS?<\/a>
\nO Que é JavaScript?<\/a>\n<\/p>\n <\/div>\n\n\n\n<\/p>Boas Práticas e Dicas ao Criar Plugins Personalizados<\/strong><\/h2>
Como seu site precisa evoluir continuamente, você precisará revisitar o código dos seus plugins para implementar novidades e corrigir falhas de segurança.<\/p>
Com isso em mente, é uma boa ideia seguir algumas boas práticas no desenvolvimento de plugins desde o início. Com isso, você facilitará todo o processo para você mesmo e para quaisquer desenvolvedores que venham a trabalhar no seu plugin futuramente.<\/p>
Além disso, você pode dar uma olhada nos melhores plugins WordPress<\/a> para ter um pouco de inspiração. Analise seus códigos-fonte, como eles organizam suas pastas e outras práticas que você pode aplicar ao criar os seus próprios plugins.<\/p>
Aqui estão algumas dicas de escrita de código e desenvolvimento de plugins que poderão te ajudar na criação do seu primeiro plugin WordPress:<\/p>
- \n
- Desenvolva e teste seus plugins num ambiente de teste.<\/strong> Desta forma, você não corre o risco de quebrar o seu site no caso de algum código problemático.<\/li>\n\n\n\n
- Crie uma estrutura de pastas lógica.<\/strong> Crie subpastas para cada funcionalidade e divida o código em diferentes arquivos, com base em seu propósito ou na linguagem de programação escolhida, para evitar bagunça.<\/li>\n\n\n\n
- Nomeie cada arquivo, pasta e elemento com cuidado.<\/strong> Use prefixos únicos, para que eles não entrem em conflito com os nomes de arquivos de outros plugins ou do próprio WordPress.<\/li>\n\n\n\n
- Adicione comentários para explicar cada função.<\/strong> Isso permite que outros desenvolvedores entendam seu código ao atualizá-lo ou corrigir seus bugs.<\/li>\n\n\n\n
- Crie uma documentação.<\/strong> Essa prática é particularmente vantajosa caso você crie plugins com funcionalidades complexas para muitos usuários.<\/li>\n\n\n\n
- Use um software de controle de versão para acompanhar as mudanças feitas no seu código.<\/strong> Saber quem adicionou ou modificou cada código ajuda a previnir conflitos entre atualizações e reduzir o número de bugs.<\/li>\n\n\n\n
- Use o <\/strong>Codex do WordPress<\/strong><\/a> como referência para seguir padrões de código específicos de cada linguagem.<\/strong> Certifique-se de seguir os padrões ao colaborar num projeto.<\/li>\n\n\n\n
- Ative o <\/strong>WP_DEBUG<\/strong><\/a> ou use uma ferramenta de debugging ao desenvolver plugins.<\/strong> Isso facilitará a detecção de bugs, acelerando o desenvolvimento como um todo.<\/li>\n<\/ul>
Conclusão<\/strong><\/h2>
Desenvolver um plugin personalizado é uma boa forma de adicionar uma funcionalidade ao site WordPress que não é oferecida por nenhum plugin atualmente disponível. Sua criação pode ser um plugin simples, que implementa alterações menores, ou um plugin bem complexo, que modifica o site como um todo.<\/p>
Para recapitular, eis os passos para criar o seu plugin WordPress do zero:<\/p>
- \n
- Crie uma pasta para armazenar os arquivos do plugin.<\/li>\n\n\n\n
- Crie o arquivo principal do seu plugin.<\/li>\n\n\n\n
- Adicione os códigos a múltiplos arquivos para definir as funções do plugin.<\/li>\n\n\n\n
- Construa a página de administrador do plugin.<\/li>\n<\/ol>
Como qualquer outra habilidade, desenvolver plugins para o WordPress com destreza leva tempo. Com prática suficiente, você poderá criar plugins para disponibilizá-los no diretório oficial do WordPress — ou mesmo vendê-lo em um marketplace.<\/p>
Esperamos que este artigo tenha te ensinado como fazer um plugin para WordPress. Se você tiver alguma dúvida ou comentário, não deixe de escrevê-lo logo abaixo.<\/p>
- Crie uma estrutura de pastas lógica.<\/strong> Crie subpastas para cada funcionalidade e divida o código em diferentes arquivos, com base em seu propósito ou na linguagem de programação escolhida, para evitar bagunça.<\/li>\n\n\n\n
- Navegue até o menu Plugins<\/strong> no painel do WordPress. Clique em “Adicionar novo”<\/strong>.<\/li>\n\n\n\n
- Título do menu<\/strong> – o texto usado para o item do menu. Em nosso exemplo, é o próprio nome do plugin.<\/li>\n\n\n\n
- Hooks de filtro<\/strong> – modificam dados produzidos pelas funções.<\/li>\n<\/ul>
- Uma instalação WordPress<\/a> ativa<\/li>\n<\/ul>