Puntos básicos de WordPress Coding Standards
09/06/2024
Los estándares de Codificación PHP para WordPress (WordPress Coding Standards) son un conjunto de pautas diseñadas para promover un código consistente, legible y mantenible en el ecosistema de WordPress. Seguir estas pautas no solo beneficia a los desarrolladores individuales, sino que también facilita la colaboración en proyectos y contribuye a la calidad general del código de WordPress.
Debajo, te dejo los 10 puntos que a mí me resultan más útiles:
- Abrir y cerrar etiquetas PHP.
Al incrustar fragmentos de PHP de varias líneas dentro de un bloque HTML, las etiquetas de apertura y cierre de PHP deben estar en una línea separada. - No usar etiquetas PHP abreviadas.
Usar<?php echo("Hola"); ?>
no<? echo("Hola"); ?> - Comillas simples y dobles.
La idea es usar comillas simples siempre que se pueda. - Nombres.
Los nombres deben ser representativos y autodocumentado, no abrevie los nombres inútilmente (ej:costo_producto
no
)cp
Usa snake_case (ej:nombre_variable
) en minúsculas para funciones y variables, y en mayúsculas para constantes (ej:define( 'THEME_VERSION', '1.5.1' );)
- Espacios en blanco.
Colocar espacio en blanco, siempre después de las comas y a ambos lados de los operadores lógicos, aritméticos, de comparación, de cadena y de asignación. Ej:$dias_habiles = array( 'lunes', 'martes', 'miércoles', 'jueves', 'viernes' );
- Sangria.
Usar siempre tabulado real - Estilo Yoda
Al realizar comparaciones lógicas que involucran variables, siempre coloque la variable en el lado derecho y las constantes, literales o llamadas a funciones en el lado izquierdo.if ( 0 >= $costo_producto ) {...
- Declaración de arreglos.
Usar declaraciones largas$dias_habiles = array( 'lunes', 'martes', 'miércoles', 'jueves', 'viernes' );
es más legible que las forma corta$dias_habiles = [ 'lunes', 'martes', 'miércoles', 'jueves', 'viernes' ];
- Operadores ternario.
Los operadores ternarios están bien, pero siempre haga que prueben si la afirmación es verdadera y no falsa. No se debe utilizar el operador ternario corto.$se_trabaja = ( in_array('lunes', $dias_habiles) ) ? "Si" : "No"
- Código inteligente.
En general el código «legible» es más importante que el código inteligente.
Si queres profundizar sobre esto, te dejo el enlace de la documentación oficial https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/