O documento apresenta um guia sobre como criar um plugin para WordPress sem ser desenvolvedor. Explica que códigos encontrados na internet podem ser transformados em plugins para facilitar a manutenção de sites. Detalha os passos para criar um plugin simples, como adicionar segurança, cabeçalho e imagens. Apresenta também como enviar o plugin para o repositório oficial do WordPress.

1. 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

2. 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/

3. 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

4. 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.
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

5. 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.
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

6. 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.
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

7. 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
}
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

8. 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 **/
}
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

9. UM PLUGIN NÃO PRECISA SER
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);
}
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

10. UM PLUGIN NÃO PRECISA SER
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/
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

11. UM PLUGIN NÃO PRECISA SER
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:
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

12. UM PLUGIN NÃO PRECISA SER
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
*/
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

13. UM PLUGIN NÃO PRECISA SER
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:
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

14. UM PLUGIN NÃO PRECISA SER
COMPLEXO
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

15. UM PLUGIN NÃO PRECISA SER
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
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

16. 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/
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

17. 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/
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

18. ENVIANDO O PLUGIN PARA O
REPOSITÓRIO OFICIAL
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.
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

19. ENVIANDO O PLUGIN PARA O
REPOSITÓRIO OFICIAL
O acesso será algo como este exemplo:
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

20. 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
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

21. 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):
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

22. INSERINDO ÍCONE E CAPA NO
PLUGIN
Na sequência, copie e cole os arquivos PHP e readme do
seu plugin para a pasta “trunk”:
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

23. INSERINDO ÍCONE E CAPA NO
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)
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

24. INSERINDO ÍCONE E CAPA NO
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)
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

25. INSERINDO ÍCONE E CAPA NO
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
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

26. INSERINDO ÍCONE E CAPA NO
PLUGIN
Depois de criadas as imagens, basta copiá-las para a
pasta “assets”, que vai estar dentro da pasta do seu
plugin:
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

27. INSERINDO ÍCONE E CAPA NO
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:
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

28. SEU PLUGIN ESTÁ PRONTO E
PUBLICADO
Feito isso, seu plugin já estará publicado e com as imagens na
página oficial:
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

29. 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/
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

30. 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
Como criar um plugin sem ser desenvolvedor - Marcos Alexandre

31. 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 - Marcos Alexandre

32. 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/