Normas de codificación de WordPress: una introducción

A menudo hablamos de lo importante que es escribir un código de calidad cuando se trata de crear productos de WordPress. Sin embargo, no se trata solo de profesionalismo y orgullo. Básicamente, cualquier sitio puede romperse debido al código de baja calidad, lo que podría afectar seriamente su situación profesional. Afortunadamente, lo que significa que la “calidad” se ha destilado en los estándares de codificación de WordPress. Esto lo ayudará a asegurarse de que su código esté en un sorteo y le dará una especie de hoja de ruta a seguir cuando trabaje en proyectos importantes. En esta publicación, veremos los estándares de WordPress Codpress más detallados. También presentaremos la versión GitHub de los estándares y explicaremos por qué podría usarlos como un recurso básico. Sin embargo, antes de eso, ¡hablemos un poco sobre la calidad del código!
Una conferencia rápida (y amigable) sobre tratar de obtener un código de alta calidad, estamos dispuestos a apostar a que usted es una persona que está orgullosa de lo que hace. Al menos, si te llamas desarrollador, es una idea inteligente comportarse como uno. Es posible que tenga la chaqueta que mejora los místicos, un cambio de Newton y una multitud de otros clichés, pero ¿puede decir que su calidad de codificación está en un nivel que se adapta a su ambición? La realidad es que no importa dónde se encuentre, siempre habrá mejoras que pueda hacer. En resumen, sus intentos de entregar el mejor trabajo posible generalmente lo llevarán durante el siguiente ciclo:
Identificar (o identificar) un aspecto de su código que no coincida con sus estándares.
Por un período de aprendizaje e implementación, mejora sus habilidades. Identifique otra zona de mejora que pueda hacer.
Imagine una curva de campana, con sus peores habilidades representadas a la izquierda y la mejor a la derecha. Debe mirar constantemente a la izquierda y elegir los mejores elementos de su código para trabajar. Esto moverá toda la curva de campana hacia la derecha y hará que otros aspectos se conviertan en el nuevo “peor”. Esta práctica se llama técnica de “gusto de pulgada” y sirve como una forma disciplinada para desarrollar constantemente sus habilidades. La mejor noticia es que los desarrolladores de WordPress tienen una ventaja cuando se trata de implementar esta técnica.
Las medidas que toma WordPress para guiarlo en poderosas prácticas de codificación se esfuerza por desarrollar sus áreas más pobres es un objetivo noble, y una mano amiga siempre será bienvenida. Por supuesto, los desarrolladores básicos de WordPress tienen un interés personal para garantizar que la comunidad tenga una curva de aprendizaje superficial al crear para la plataforma. Si WordPress fuera difícil de codificar, no serían adoptados por tantos desarrolladores. Para empezar, considere cómo se codifica el propio WordPress. Está prácticamente cosido de ganchos, lo que significa que puede implementar la funcionalidad básica en cada proyecto, sin introducir problemas esotéricos. También puede ver esta posición amigable para los desarrolladores en la forma en que las plantillas se utilizan para armar los modelos e incluso en los comentarios completos contenidos en cada archivo PHP.
De hecho, WordPress tiene una reputación tan sólida en esta área que los usuarios ordinarios a menudo abren un editor de código y cambian en sus tendencias de espalda. También está el códice oficial, que está lleno de materiales de referencia sobre cómo hacer prácticamente cualquier cosa en WordPress. Con respecto a los desarrolladores, quizás el único documento que necesitará para asegurarse de que el código sea de alta calidad (y para mantener problemas potenciales como mínimo), sean estándares de codificación oficiales. Para los contribuyentes básicos, ofrece mucho para digerir en términos de desarrollo básico de WordPress. Sin embargo, también contiene estándares de codificación oficiales, que nos enfocaremos aquí.
Como habrá reunido, estos estándares contienen las pautas para el código básico que compromete a WordPress ‘. Aunque hablamos sobre por qué no necesariamente deberían aplicar a los temas y el desarrollo de complementos, seguirán siendo útiles en esas situaciones. En resumen, utilizará estándares oficiales para escribir código que valida y no introduce errores básicos. Vamos a superar cada conjunto rápido de cada conjunto:

Php. Esta gran colección de estándares, con respecto a la sangría, estilo de correas, formateo de instrucciones SQL y muchas más, es sin duda el conjunto más importante para los usuarios de WordPress.
Html. Dada la reducción relativa de la complejidad, HTML tiene algunas entradas menos que los otros idiomas. Aun así, se representan elementos importantes, como las etiquetas de sangría y autoproducción.
CSS. Junto con PHP, CSS es el lenguaje más importante para la estilización. Hay mucho que buscar en este conjunto, aunque hay más instrucciones generales que elementos específicos. JavaScript es comprensible el más denso de todos los estándares de codificación aquí, debido a su implementación en desarrollo en WordPress. De hecho, puede considerar que este es un espejo de los estándares de codificación de PHP, especialmente porque crece en prominencia en la línea.
Una vez que haya pasado un poco de tiempo con ellos, notará que incluso los más completos de estos estándares aún son fácilmente digeribles. Esta es una buena noticia, porque significa que puede implementarlas sin pasar por toneladas de instrucciones.
Encontrar una versión actualizada de los estándares de codificación (y garantizar que los respete) antes de terminar, nos gustaría informarle a GitHub, especialmente los estándares de codificación de WordPress. Esto es similar a hacer estándares de WordPress, pero hay algunas adiciones que son cambios más actuales, que no se presentan en el sitio web oficial. En nuestra opinión, esto hace que la versión de GitHub sea los estándares oficiales de codificación de Facto. La versión 1.0 se lanzó en julio de 2018 y tiene una diferencia clave: es esencialmente una colección de reglas php_codesniffer (o “sniffs”). Si no está familiarizado con esta herramienta, es toke su PHP, CSS y JavaScript y detecte cualquier diferencia o violación entre su código y estándares.
Si sigue los estándares para la contribución básica (como debe ser), capitalizar estos olores es prácticamente esencial. Le recomendamos que lea la documentación de GitHub y elija su método de instalación favorito. Luego, puede aprovechar algunos de los SNIF adicionales disponibles, como los de documentación en línea, y tendrá acceso a algunas buenas prácticas que no están incluidas en los estándares básicos. Conclusión Podemos usar un viejo paradigma de programador para describir cómo debe abordar cada aspecto de su código: “basura, basura fuera”. Finalmente, si la calidad de su código es más baja que la parte superior, usted hace un servicio a sus usuarios. Fortun. WordPress tiene un conjunto documentado de estándares que cualquier desarrollador puede seguir para garantizar que el código sea digno de incluir. Siguiendo estos estándares, casi se garantiza que los equipos de revisión dedicados aprobarán sus compromisos. Esto le da un avance al comienzo del próximo proyecto. ¿Tiene alguna pregunta sobre cómo usar los estándares de codificación de WordPress? ¡Háganos saber en la sección de comentarios!