Deploy de Plugin do WordPress Com GIT: Como Exportar os Arquivos de Maneira Segura

Se você esta desenvolvendo um plugin para WordPress e esta usando o GIT para versionamento de código, é importante exportar e zipar os arquivos corretamente, evitando de enviar pastas criticas para o servidor do site, como a pasta .git ou arquivos de credenciais.

Para isso, siga o passo a passo abaixo:

1 – Iniciando: Instalando o GIT

Em seu repositório inicie o git:

git init

2 – Criando o arquivo .gitignore

Crie o arquivo .gitignore com tudo que não deseja que seja versionado, como arquivos do sistema (no caso do Mac arquivos .DS_Store) ou credenciais como arquivos .env ou credentials.php, ou até mesmo a própria pasta zipada depois de exportada. Exemplo simples abaixo:

.DS_Store
.env
reference/
seu-plugin-aqui.zip

3 – Criando o arquivo .gitattributes

Aqui é onde tudo começa a fazer a diferença para você que vai criar um plugin em WordPress e precisa zipar os arquivos e enviar via painel admin. O arquivo .gitattributes é usado pelo Git para ignorar alguns arquivos de pastas que você não quer na hora da exportação.

.gitignore export-ignore
.gitattributes export-ignore
README.md export-ignore
deploy.sh export-ignore

Basicamente, você adiciona o nome da sua pasta ou arquivo e a adiciona na frente: export-ignore

Você vai ignorar arquivos que geralmente você vai versionar com o Git, mas que você não quer na exportação. Isso é o que difere do arquivo Git Ignore, porque o arquivo Git Ignore vai ignorar no versionamento.

4 – Criando arquivo deploy.sh

Agora vamos criar o nosso script de deploy para que possamos rodar facilmente esse comando em nosso terminal e gerar nosso arquivo zipado ignorando os arquivos e passas que não queremos subir no WordPress.

Crie um arquivo chamado deploy.sh e salve o código abaixo:

git archive --format=zip --prefix=seu-plugin-aqui/ HEAD -o seu-plugin-aqui.zip

Explicação: O comando acima fala para o Git compactar os arquivos da pasta em um arquivo Zip com o prefixo do nome da sua pasta, pois o WordPress precisa que os arquivos do plugin estejam em uma pasta principal.

Mudando permissões do arquivo deploy.sh

Depois de criar o seu arquivo deploy.sh, você precisa rodar um comando no seu terminal para dar permissão de execução para o seu arquivo. Rode comando abaixo:

chmod +x deploy.sh

Exportando na pratica:

Agora que você já tem os arquivos do Git configurados e o seu arquivo de deploy, você pode começar a criar arquivos do seu plugin ou editar. Faça as edições normalmente, verassione os seus arquivos de passas com o Git, se você quiser pode enviar para um repositório remoto como o GitHub também.

Depois que o seu código estiver versionado e seu git estiver limpo, você pode executar o comando abaixo para gerar arquivos zip com os arquivos necessários para subir no seu painel administrativo do WordPress:

./deploy.sh

Você vai perceber que vai ser criado um arquivo Zip na pasta do seu projeto. Pronto!