Los estándares de codificación de WordPress una introducción

Cuando se trata de crear productos basados en WordPress, estamos un poco malditos (o bendecidos, dependiendo de cómo lo veas), con un arma de doble filo: como WordPress está escrito en PHP, es relativamente fácil obtener WordPress o el proyecto en sí mismo: para hacer lo que sea, queremos hacer todo el tiempo evitando las mejores prácticas.

Pero esto plantea la pregunta: ¿para qué sirve una API o estándares de codificación formales si simplemente los ignoramos??

Hemos escrito bastante sobre las API de WordPress en artículos anteriores, y hemos tocado las Normas de codificación de WordPress, pero nunca hemos profundizado mucho en las normas de codificación, entendiendo cada aspecto de ellas y por qué importar.

Así que en esta serie, vamos a estar haciendo exactamente eso..

¿Por qué molestarse con los estándares de codificación??

Antes de echar un vistazo a todo lo que vamos a cubrir, creo que es importante entender por qué los estándares de codificación son importantes..

WordPress es ampliamente utilizado por mucho de personas que usan mucho de sitios. Se está empleando una gran cantidad de código que se basa en la aplicación principal. Esto significa que hay desarrolladores y diseñadores que están trabajando para mantener esas bases de código.

El desafío se presenta cuando la persona que originalmente no escribió el código se atasca con mejorar, administrar y corregir errores para el proyecto. Digamos que la primera persona no siguió los estándares de codificación, pero la persona que ahora mantiene el código está acostumbrada a seguir las mejores prácticas.

Ahora tienen que lidiar con el código que no se parece en nada al aspecto que debería tener el código de WordPress.

Y ese es realmente el quid de la cuestión: el código que conforma nuestros temas, nuestros complementos y nuestras aplicaciones debería idealmente parecer que un solo desarrollador escribió el código..

Eso es lo que las normas de codificación hacen cumplir.

Desafortunadamente, las normas son ignoradas o no están lo suficientemente evangelizadas a pesar del hecho de que están bien documentadas. Ahí es donde entra en juego esta serie de artículos: Vamos a analizar cada uno de los estándares para evangelizar, comprender y alentar a los demás a comenzar a hacer un mejor trabajo..

Una mirada a los estándares de codificación

Esta serie incluirá siete artículos además de esta introducción..

Aquí es donde nos dirigimos con esta serie en particular:

Convenciones de nomenclatura y argumentos de función - Veremos cómo debemos nombrar nuestras variables, métodos y clases de modo que sean claros, fáciles de entender y seguirnos por nosotros mismos y por otros desarrolladores..
El uso de comillas simples y dobles - Las comillas simples y las comillas dobles dan como resultado un comportamiento diferente en PHP y hay un momento y un lugar para cuándo usarlos en WordPress. En este artículo, veremos ejemplos de cada uno y la razón detrás de lo que estamos haciendo..
Sangría, uso del espacio y espacios finales - El espacio en blanco coloca una gran parte en la escritura de código basado en WordPress. Este artículo explorará las razones por las que la sangría y el espacio son importantes, así como cuándo usar las pestañas y cuándo usar los espacios..
Estilo de refuerzo, expresiones regulares y etiquetas PHP - Diferentes lenguajes de estilo C usan diferentes sintaxis. Este artículo examinará la forma correcta de colocar llaves en su código basado en WordPress. También vamos a examinar la forma correcta de incluir expresiones regulares, así como algunas de las situaciones y prácticas recomendadas relacionadas con el uso de etiquetas PHP..
El operador ternario y las condiciones de Yoda. - Las declaraciones condicionales son una piedra angular de la programación y se utilizan generosamente en WordPress. PHP ofrece un acceso directo para las sentencias if / else, y WordPress opta por evaluar condicionales de manera diferente a lo que otros lenguajes admiten a menudo. Aquí, echaremos un vistazo a todo lo anterior..
Consultas de base de datos y consultas de formato SQL - Hay una API completa para ejecutar consultas en la base de datos de WordPress, pero también hay formas de ejecutar SQL sin formato. Si alguna vez necesitas ir por esa ruta, hay una manera correcta de hacerlo. Este artículo echará un vistazo a exactamente eso.
Juntándolo todo - Finalmente, vamos a resumir todo lo que hemos discutido a lo largo de la serie para asegurarnos de que todos estemos en la misma página, y nos instarán a seguir adelante para hacer un mejor trabajo de adherirnos a los estándares..

Conclusión

Cuando se trata de bloguear, a menudo se asume que el autor es un experto en el tema en cuestión, pero la verdad es que creo firmemente que debemos seguir los estándares de codificación y que trato de adherirme a ellos lo mejor que pueda. , Estoy aprendiendo cosas cada semana.

He violado los estándares de codificación muchas veces, y estoy seguro de que algunos de ustedes también lo han hecho..

El objetivo de esta serie es repasar los estándares para que todos podamos salir como mejores desarrolladores una vez que hayamos terminado.

Código