Las cookies nos permiten ofrecer nuestros servicios. Al utilizar nuestros servicios, aceptas el uso que hacemos de las cookies. Más Información. Aceptar

Buenas prácticas para Desarrollar tema WordPress

Esaú A.
  • Escrito por Esaú A. el 15 de Febrero de 2016
  • 2 min de lectura | Programación
Buenas prácticas para Desarrollar tema WordPress

Tanto si es vuestro caso como si sois amplios conocedores de algún lenguaje de programación, seguramente tendréis vuestros hábitos adquiridos tanto por la metodología con la que habéis conocido los diferentes lenguajes con los que hayáis trabajado como por la experiencia que habéis adquirido a lo largo de vuestros meses como desarrolladores.

Si vuestra meta es la de crear temas para WordPress con idea de posteriormente ponerlos a disposición del público a cambio de un módico precio (vamos… que vais a venderlos), deberíais ser conscientes de que ya no estaréis programando para vosotros mismos , si no para otras personas que serán vuestros clientes, por lo que deberías dejar vuestras costumbres o “manías” (que no tienen porque ser malas…) de desarrolladores a un lado para seguir ciertos estándares que quizás os interesaría adoptar.

Plataformas de venta de temas como pueden ser Wordpress.org o ThemeForest insisten en que quieren códigos estándar que todos sus clientes puedan revisar cómodamente . En Wordpress existen cuatro lenguajes de programación principales para el desarrollo de temas: PHP, HTML, CSS y JavaScript, y para cada uno existe un convenio para formatear el código.

HTML

Sus normas son bastante simples para hacer nuestro código compatible con los estándares:

  • Deberemos siempre validar nuestro código con W3C.

  • Prestaremos especial atención con los elementos de cierre automático, dejando siempre al final de dicho elemento un espacio seguido de />.

  • Los valores de atributos irán todos en minúsculas (excepto para referirnos a personas) y entre comillas (simples o dobles, ambas son aceptadas).

  • La sangría debe ser lógica y fácilmente legible. En caso de contener código PHP dentro del código PHP, también se aplica esta norma.


CSS

  • Las propiedades deberán estar correctamente tabuladas.

  • Admite selectores de grupo pero cada uno deberá ir en una línea independiente para facilitar su lectura.

  • Los selectores de clase e ID’s deberán ir en minúscula siempre, separando las palabras si se diese el caso, con guiones.

  • Las propiedades y valores deberán ir en minúsculas, a excepción de los nombres de fuentes y propiedades específicas de algún desarrollador.

  • El orden correcto para las propiedades será: Pantalla, posicionamiento, tipo de caja, colores, tipografía, otros…

  • También se deben ordenar los prefijos de más largos a más cortos.

  • Mantener las solicitudes de medios al final de la hoja de estilos.

  • Comentar el código del mismo modo que se comenta PHP (un poco más abajo lo veremos).

JavaScript

  • Los paréntesis no podrán abrirse y cerrarse en la misma línea.

  • Preferencia de uso en las comillas simples sobre las comillas dobles, a menos que la cadena contenga comillas simples.

  • No utilizar espacios en blanco en las líneas en blanco.

  • Nombrar las funciones y variables utilizando camelCase (uniendo dos palabras pero la segunda llevará su primera letra en mayúsculas) en lugar de guiones bajos.

  • Los constructores deberán usar TitleCase (igual que camelCase, pero las dos palabras tendrán su primera letra en mayúsculas).

  • Se pueden declarar múltiples variables en una sola línea siempre y cuando no se les asignen valores, caso en el que se deberán declarar en líneas independientes.

  • Utilizar {} en lugar de newArray() y [] en lugar de newObject().

  • Trata las condicionales y los bucles con mucho cuidado, son las partes más “complejas” de leer. Los espacios y los paréntesis serán claves.

PHP

Llegamos a la parte difícil. Sobre PHP hay multitud de normas a seguir (no es de extrañar al ser el lenguaje principal que usa Wordpress), por lo que en este apartado mencionaré sólo algunos de los puntos más relevantes a tener en cuenta, y os dejo el enlace de los estándar decodificación PHP de la web de Wordpress .

  • Convenciones de nomenclatura.

  • Comillas simples y dobles.

  • Espacios en blanco y su uso.

  • Expresiones regulares.

  • Condicionales “Yoda”.

  • SQL y consultas a la base de datos.

Comentar el Código Correctamente

Para facilitar que otros desarrolladores o clientes con ciertas nociones consulte qué es lo que hace cada parte del producto que han comprado, deberíamos establecer un mínimo de orden dentro del código , comentando qué es lo que realiza cada bloque que consideremos identificar.

Lo más propio es utilizar PHPDoc , herramienta muy extendida entre aquellos desarrolladores de PHP más centrados en el mundo Wordpress, que nos ayudará sobremanera a generar la documentación y comentarios necesarios para nuestro código.

Validar y probar el tema

Lo ideal en este caso sería instalar el tema en una instalación de Wordpress, que por lo general será una instalación limpia, donde el riesgo de fallos es mínimo, obteniendo un falso positivo en el testeo.

Para ayudarnos con esta tarea contamos con varias opciones.

  • Validar el código HTML y CSS con W3C . Deberemos ir página a página de nuestro tema para confirmar que todo está correctamente formateado y funcionando.

  • Utilizar un plugin de desarrollo para corregir el tema “desde dentro” (de la instalación de Wordpress, se entiende…). Por ejemplo, uno de los más usados en este menester es “ Developer ” que como su propio nombre indica nos ayudará con un entorno de desarrollo donde poder editar nuestro código en Wordpress.

  • Hacer uso de las pruebas que nos ofrecen sitios como WPTest , con los que quedaremos más que tranquilos de que si nuestro código supera estas pruebas, será algo de lo que estar orgullosos.

El único inconveniente de estas pruebas es que casi ninguna tendrá en cuenta los shortcodes que hayamos usado, por lo que recomendamos hacer estas pruebas con contenido básico, como el contenido de ejemplo que facilita Wordpress en su instalación

Estas son algunas de las empresas que ya confían en OpenWebinars

Profesores y profesionales

Nuestros docentes son profesionales que trabajan día a día en la materia que imparten

Conviértete en profesor de OpenWebinars