Como criar um plugin sem ser desenvolvedor

COMO CRIAR UM PLUGIN SEM
SER DESENVOLVEDOR
É possível utilizar códigos simples, que muitas vezes existem
prontos na internet, para resolver algumas necessidades
de alterações em um site WordPress. Para facilitar a
manutenção, o correto é transformar essas
personalizações em um plugin. Nesta palestra veremos
como isso é mais simples do que parece.
Marcos Alexandre

Formado em Web Design pela Faculdade Opet e desenvolvedor
freelancer, trabalhando com WordPress desde 2012. É membro da
comunidade WordPress Brasil desde 2015, contribuindo com
traduções e com a organização dos eventos de WordPress em
Curitiba.
Marcos Alexandre
https://profiles.wordpress.org/marcosalexandre/
https://twitter.com/marcos_alex82
https://www.facebook.com/marcos.alexandre.33821
https://www.instagram.com/marcos_alexandre82/

INSERINDO OU REMOVENDO
UMA FUNCIONALIDADE
Em nossos projetos, muitas vezes precisamos de um
comportamento específico. Esse comportamento muitas
vezes pode ser obtidos através de um filtro no PHP, o qual
retira ou acrescenta uma funcionalidade ao nosso tema
WordPress.
Ao buscarmos uma solução na web, geralmente
nos deparamos com algumas soluções prontas.
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

QUAIS CÓDIGOS PODEM SE
TORNAR UM PLUGIN
Basicamente, quase todos o códigos que encontramos na
internet e que utilizamos no arquivo functions.php do tema
podem se tornar um plugin.

VANTAGENS EM SE UTILIZAR
ESTE CÓDIGO COMO PLUGIN
O tema deve ser responsável pela parte visual do projeto.
Funcionalidades devem ser mantidas em plugins, pois
dessa forma, a manutenção futura fica muito mais fácil.
Além disso, se o tema for um tema comprado e não
estiver utilizando um tema descendente, qualquer
edição no código dele será sobrescrita em uma
atualização.

EXEMPLO DE UM CÓDIGO
QUE PODE SER UM PLUGIN
Recentemente precisei remover os produtos relacionados
em um projeto que utilizava WooCommerce. Pesquisando
sobre os filtros que poderiam me ajudar, me deparei com
o seguinte código:
add_filter('woocommerce_product_related_posts_query',
'__return_empty_array', 100);
O código acima verifica quando o filtro responsável pela
exibição dos produtos relacionados é chamado e retorna
um array vazio.

UM PLUGIN PRECISA TER
SEGURANÇA
O código anterior sozinho já funcionaria, mas para
melhorá-lo, quando transformamos em um plugin,
podemos fazer algumas verificações. A primeira delas é
garantir que o arquivos não possa ser acessado
diretamente, inserindo logo no começo do arquivo, o
seguinte código:
if ( ! defined( 'ABSPATH' ) ) {
exit; // Interrompe a chamada se acessado diretamente
}

UM PLUGIN NÃO PRECISA SER
COMPLEXO
Além disso, como o filtro era para uma funcionalidade específica
do WooCommerce, ele deve funcionar apenas se o
WooCommerce estiver ativado. Para isso, inseri o código do filtro
dentro de uma verificação da utilização ou não do
WooCommerce:
/** Verificando se o WooCommerce está ativado **/
if ( in_array( 'woocommerce/woocommerce.php', apply_filters(
'active_plugins', get_option( 'active_plugins' ) ) ) ) {
/** Aqui vai o código do filtro **/
}

COMPLEXO
O código PHP completo do plugin ficou assim:
if ( ! defined( 'ABSPATH' ) ) {
exit; // Interrompe a chamada se acessado diretamente
}
/** Verificando se o WooCommerce está ativado **/
if ( in_array( 'woocommerce/woocommerce.php', apply_filters(
'active_plugins', get_option( 'active_plugins' ) ) ) ) {
add_filter('woocommerce_product_related_posts_query',
'__return_empty_array', 100);
}

COMPLEXO
Agora o plugin está praticamente pronto, mas ainda é
necessário inserir os requisitos de cabeçalho (no topo do
arquivo), que são responsáveis pela exibição do nome, url
do site do plugin, descrição, autor, url do site do autor do
plugin, versão do plugin, tipo de licença, url da licença,
domínio do texto, etc. Temos mais detalhes em:
https://developer.wordpress.org/plugins/plugin-
basics/header-requirements/

COMPLEXO
O requisito mínimo é o nome do plugin, mas é interessante
incluir o maior número de dados possíveis, como no
exemplo a seguir, que utilizei na criação do meu plugin:

COMPLEXO
<?php
/**
* Plugin Name: Remove WooCommerce Product Related
* Plugin URI: https://github.com/marcos-alexandre82/remove-woocommerce-product-related
* Description: Removes, globally, related products in WooCommerce.
* Author: Marcos Alexandre
* Author URI: https://marcosalexandre.dev/
* Version: 1.0.0
* License: GNU General Public License v3.0
* License URI: http://www.gnu.org/licenses/gpl-3.0.html
* Text Domain: remove-woocommerce-product-related
* Domain Path: /languages
* WC tested up to: 5.2.2
*/

COMPLEXO
A seguir temos o código PHP completo do plugin. Como a
intenção é enviá-lo para o repositório oficial de plugin do
WordPress, utilizar termos em inglês é a melhor prática, pois
assim ele fica acessível à mais usuários:

COMPLEXO

COMPLEXO
Agora precisamos salvar o arquivo PHP em uma pasta.
Ambos precisam ter o mesmo nome que utilizamos em
domínio de texto (Text Domain), no nosso caso:
remove-woocommerce-product-related

CRIANDO UM ARQUIVO
README PARA SEU PLUGIN
Por último, precisamos criar um arquivo readme.txt. Este
arquivo é o responsável por exibir informações como
descrição, dúvidas frequentes, etc. na página do plugin
no repositório. Para isso exitem duas ferramentas que
auxiliam:
https://generatewp.com/plugin-readme/
https://wordpress.org/plugins/developers/readme-
validator/

ENVIANDO O PLUGIN PARA O
REPOSITÓRIO OFICIAL
Para enviar o plugin para o repositório oficial do WordPress
é necessário ter uma conta no wordpress.org:
https://br.wordpress.org/
Ao fazer o login, basta acessar o link abaixo e
utilizar o campo de envio no final da página,
enviando um arquivo .zip da pasta contendo os
arquivos do plugin:
https://br.wordpress.org/plugins/developers/add/

Após o envio, será exibida uma mensagem contendo informações
quanto ao prazo de análise do código pela equipe de plugins e a
quantidade de plugins que estão na fila. Depois desta análise, se ele
for aceito, você receberá um e-mail com o link do repositório SVN do
plugin.
É através deste repositório que você irá enviar o código do
seu plugin, o ícone e o banner que vão ser exibidos na
página do repositório, além de fazer edições no código,
para futuras atualizações, se necessário.

O acesso será algo como este exemplo:

GERENCIANDO OS ARQUIVOS
ATRAVÉS DO SVN
Existem algumas formas de gerenciar os arquivos, porém
irei abordar apenas uma.
Se estiver utilizando Windows, podemos utilizar uma
ferramenta chamada Tortoise SVN:
https://tortoisesvn.net/downloads.html

GERENCIANDO OS ARQUIVOS
ATRAVÉS DO SVN
Basta fazer o download, instalar, acessar a pasta do plugin no seu computador, clicar
com o botão direito e escolher a opção “SVN Checkout”, inserir a URL do repositório
SVN, escolher uma pasta no seu computador onde os arquivos serão salvos, clicar em
Ok, inserir o nome de usuário e senha (o mesmo do WordPress.org):

INSERINDO ÍCONE E CAPA NO
PLUGIN
Na sequência, copie e cole os arquivos PHP e readme do
seu plugin para a pasta “trunk”:

PLUGIN
Para inserir uma imagem para a capa do plugin, basta
criar uma imagem no tamanho 772x250, no formato JPG
ou PNG, com o nome:
banner-772x250.(jpg|png)

PLUGIN
Podemos melhorar ainda mais a exibição da capa, enviando um
arquivo com o dobro do tamanho, para exibição em telas com
alta DPI (retina). Ainda, como o plugin poderá ser acessado por
pessoas que utilizam idiomas com a leitura da direita para a
esquerda (RTL), é possível enviar a capa (tanto no tamanho
normal quanto para tela retina), com suporte à estes idiomas,
ficando da seguinte forma:
Banner normal: banner-772x250.(jpg|png)
Banner normal (RTL): banner-772x250-rtl.(jpg|png)
Alta DPI (Retina): banner-1544x500.(jpg|png)
Alta DPI (Retina RTL): banner-1544x500-rtl.(jpg|png)

PLUGIN
Seguindo o mesmo formato, para inserir um ícone para o
plugin, basta criar uma imagem no formato JPG ou PNG,
no tamanho 128x128, para telas normais, e 256x256 para
telas retina. Ainda é possível enviar um ícone SVG:
Normal: icon-128x128.(png|jpg)
Alta DPI (Retina): icon-256x256.(png|jpg)
SVG: icon.svg

PLUGIN
Depois de criadas as imagens, basta copiá-las para a
pasta “assets”, que vai estar dentro da pasta do seu
plugin:

PLUGIN
Após inserir as imagens na pasta “assets”, clique novamente com o
botão direito na pasta raiz do seu plugin e selecione a opção “SVN
Commit”. Insira uma mensagem descrevendo a alteração e clique
em OK:

SEU PLUGIN ESTÁ PRONTO E
PUBLICADO
Feito isso, seu plugin já estará publicado e com as imagens na
página oficial:

LINKS
Introdução sobre como criar plugin para WooCommerce:
https://docs.woocommerce.com/document/create-a-plugin/
Introdução sobre Markdown
https://blog.da2k.com.br/2015/02/08/aprenda-markdown/
Introdução sobre como enviar seu plugin:
https://wordpress.org/plugins/developers/
Planejar, enviar e manter o plugin:
https://developer.wordpress.org/plugins/wordpress-org/planning-your-plugin/
Validar Readme.txt
https://wordpress.org/plugins/developers/readme-validator/
Enviar plugin:
https://wordpress.org/plugins/developers/add/

LINKS
Como usar o Subversion:
https://developer.wordpress.org/plugins/wordpress-org/how-to-use-subversion/
Como funciona o Readme.txt
https://developer.wordpress.org/plugins/wordpress-org/how-your-readme-txt-works/
Gerador de readme:
https://generatewp.com/plugin-readme/
Como enviar ícones e capas para o plugin:
https://developer.wordpress.org/plugins/wordpress-org/plugin-assets/
Vídeos YouTube sobre criação de plugin e utilização do Tortoise:
https://www.youtube.com/playlist?list=PLtaXuX0nEZk_MdFQAlp7v6N3TwEJUeuHq
https://www.youtube.com/watch?v=5WDTz6pPh4Y
https://www.youtube.com/watch?v=IP-Ejh11RXw

LINKS
Repositório de Snippets :
https://github.com/taniarascia/wp-functions
Snippets WordPress:
https://wp-snippet.com/snippets/
Snippets WooCommerce:
https://docs.woocommerce.com/documentation/plugins/woocom
merce/woocommerce-codex/snippets/

Como criar um plugin sem ser desenvolvedor

Mais conteúdo relacionado

Mais procurados (20)

Semelhante a Como criar um plugin sem ser desenvolvedor (20)

Último (20)

Como criar um plugin sem ser desenvolvedor