Usando padrões de codificação com o WordPress

Escrevo bastante sobre padrões de codificação com o WordPress e a importância que acredito que eles têm para indivíduos, equipes e trabalhar com o aplicativo principal, que é o próprio WordPress.

No último ano, deixei de trabalhar principalmente com os Padrões de Codificação do WordPress e comecei a usar as Recomendações Padrão do PHP para codificação.

Observe que eu não disse que abandonei os Padrões de Codificação do WordPress nem que elevei as recomendações do PSR acima deles, mas tenho motivos para quando uso cada um. E para quem trabalha com projetos baseados em WordPress, acho importante reconhecer quando é apropriado usar cada um.

E esse é o propósito deste post.

Padrões de codificação com WordPress

Antes de discutir cada uma das variantes nos padrões de codificação, quero deixar claro que nada do que estou dizendo deve ser considerado uma regra rígida e rápida. Na melhor das hipóteses, talvez uma regra de ouro. Na pior das hipóteses, completamente ignorado, certo? 🙃

Sério, apesar dos esforços usuais e pontos de discussão de defender um padrão em detrimento do outro, tenho a opinião de que há um tempo e um lugar para quando cada um deve ser usado.

No momento da redação deste artigo, estou trabalhando em dois projetos e um usando os Padrões de Codificação do WordPress; os outros estão usando o PSR.

Aqui está a coisa:

A decisão não é sobre qual conjunto de padrões de codificação é o melhor. As pessoas gostam de discutir esse ponto, e isso é bom para elas. Eu não. Em vez disso, tento assumir a postura de ser o mais pragmático possível.

E para fazer isso, tento usar um conjunto de perguntas para tomar as decisões sobre quais padrões de codificação usar

Um filtro para tomada de decisão

Antes mesmo de começar a falar sobre os dois tipos de padrões, é importante reconhecer que existe um processo de pensamento – filtro através do qual – você pode executar todas as suas ideias para tomar a decisão mais informada possível em relação ao seu projeto.

Fiz o melhor que pude para capturar a ordem em que considero qual conjunto de padrões usar e estou compartilhando-os aqui. Em nenhuma ordem particular.

• WordPress. Você está escrevendo algo que precisará ser compatível com tantas instalações do WordPress (não obstante as versões do PHP)?
• WordPress Você está trabalhando na manutenção de um projeto que foi escrito para uma versão mais antiga do PHP ou o que foi escrito usando os Padrões de Codificação do WordPress?
• WordPress. Você herdou um projeto ou está mantendo um projeto que não tem orçamento para refatorar a base de código?
• WordPress ou PSR. Você está trabalhando com uma equipe que usa isso como seu principal conjunto de padrões de codificação?
• PSR. Você consegue convencer seu cliente a usar o PHP7+?
• PSR. Você tem controle total sobre o ambiente em que o projeto é implantado?
• PSR. Você tem um projeto que foi escrito anteriormente em uma versão mais antiga do PHP que tem orçamento para um servidor mais novo e refatoração?
• PSR. Você deseja escrever em uma base de código que ajudará a trazer suas habilidades de PHP para uma era mais moderna, além de trazer o WordPress junto com ela?

E, finalmente, uma outra pergunta que eu faria é esta:

Quais padrões de codificação você tem em seu sistema, quão fácil é configurar seu IDE? Deixe que o tempo para configurá-lo e as respostas para a pergunta acima guiem qual conjunto de padrões você usa.

Em última análise, o objetivo é tornar o mais fácil possível determinar qual padrão usar.

Uma postagem final?

Antes de encerrar esta série, quero fornecer uma lista de recursos adicionais que acredito serem úteis para aqueles que trabalham com o WordPress de alguma forma.

Talvez você seja um desenvolvedor experiente, talvez esteja apenas ficando padrão, ou talvez esteja em algum lugar no meio.

Independentemente disso, há algo para todos nós, e se eu puder compartilhar o máximo de informações possível para ajudá-lo a se tornar um melhor desenvolvimento independente do WordPress, estarei alcançando uma parte do objetivo que estabeleci com esta série em particular .

Por enquanto, porém, pense um pouco no esboço dos padrões de codificação acima e veja se isso não ajuda no gerenciamento de alguns de seus projetos existentes.

Uma Nota Sobre Programação Orientada a Objetos

Observe também que, no início desta semana, comecei – ou retomei, dependendo de quanto tempo você estiver lendo este material – na programação orientada a objetos no WordPress. Portanto, se você também estiver interessado em entrar nisso, pode começar com este post (já que também faz referência a alguns dos outros).