9 errores a evitar al desarrollar complementos o temas de WordPress

¿Está buscando crear un complemento o tema de WordPress? Tenga en cuenta que el desarrollo exitoso de complementos y temas incluye algo de prueba y error. Incluso los desarrolladores más experimentados ocasionalmente estropean su código, y aunque es imposible evitar los errores por completo, hay algunos errores comunes que puede evitar fácilmente. Para ayudarte, he reunido nueve errores comunes que debes evitar al desarrollar tu complemento o tema de WordPress.

Error #1: sacrificar la calidad en favor de soluciones rápidas

Algunos desarrolladores intentan encontrar un atajo cuando desarrollan un pequeño complemento o tema. Codifican de manera inconsistente e intentan encontrar las soluciones más fáciles y rápidas.

Sin embargo, la verdad es que no hay una manera fácil de desarrollar un complemento o tema avanzado y que funcione bien. Algunos complementos y temas se pueden desarrollar de forma relativamente rápida y sencilla. Por ejemplo, no llevará mucho tiempo desarrollar un complemento que oculte todos los avisos de administración o un complemento que inyecte un fragmento de JavaScript. Sin embargo, cuando se trata de complementos o temas más complejos, "hacer trampa" o copiar puede resultar en una funcionalidad deficiente, así como también causar varios errores y fallas de rendimiento.

Es crucial seguir las mejores prácticas de codificación organizada, incluso si solo está creando un prototipo de complemento/tema. Recuerde, muchos de los productos más populares comenzaron como prototipos. Si opta por un enfoque "rápido y sucio", comenzará a acumular deuda técnica desde el primer día.

El desarrollo de código limpio, bien escrito y optimizado aumentará su tiempo de desarrollo en un 10-30%, pero definitivamente vale la pena a largo plazo. Al final del día, obtendrá un plugin o tema mantenible, de buen rendimiento y funcional.

Error n.º 2: no realizar un seguimiento de los cambios de código

No realizar un seguimiento de los cambios de código es otro error común que todos los desarrolladores de WordPress deben evitar. Todos los temas y complementos deben administrarse bajo el control de versiones, independientemente de si usted es el único desarrollador del proyecto o no.

Todos los temas y complementos deben administrarse bajo el control de versiones, independientemente de si usted es el único desarrollador del proyecto o no.Tweet

Los sistemas de control de versiones lo ayudan a registrar y realizar un seguimiento de todos los cambios. Esto le permite a usted y a otros desarrolladores trabajar en el mismo proyecto a medida que se desarrolla un tema o complemento. Además, los sistemas de control de versiones, como Git, registran todos los cambios realizados por cada uno de los desarrolladores, lo que es particularmente conveniente cuando se trabaja en un proyecto grande. Si elige usar Git, le recomiendo usar GitFlow como un flujo de trabajo ramificado saludable para la administración de versiones.

Error #3: No usar espacios de nombres

Los espacios de nombres son útiles si necesita crear regiones separadas para grupos de variables, clases y funciones. Esto evita conflictos de complementos que estaban presentes antes de las versiones de PHP 5.6 y superiores que no podían controlarse mediante espacios de nombres.

Aquí hay un ejemplo de un código fuente que ilustra el espacio de nombres llamado geometría para JavaScript. Esta definición de un paquete permite diferenciar la clase Circle de otras clases que podrían ser definidas por otros programadores.

namespace Geometry;

class Circle {
    private $radius;

    public circle($r) {
        $radius = $r;
    }

    public get_radius() {
        return $radius;
    }
   
    public get_area() {
        return pi() * $radius * $radius;
    }
}

Error #4: No utilizar nonces de WordPress

Seguir las prácticas de seguridad modernas es tan importante como garantizar la funcionalidad de su complemento o tema. WordPress usa nonces para proporcionar cierto nivel de protección para validar la autenticidad de las solicitudes. Los nonces son particularmente útiles para prevenir ataques de falsificación de solicitudes entre sitios (CSRF).

Para crear un nonce, use la siguiente función.

$nonce= wp_create_nonce( 'name');

Consulte esta referencia de código de WordPress si no está familiarizado con los nonces.

Suscríbase y obtenga una copia gratuita de nuestro

Complemento de WordPress Libro de negocios

Exactamente cómo crear un próspero negocio de complementos de WordPress en la economía de suscripción.

Comparte con un amigo

Introduce la dirección de correo electrónico de tu amigo. Solo les enviaremos este libro por correo electrónico, honor del explorador.

Gracias por compartir

Impresionante: se acaba de enviar una copia de 'El libro de negocios de complementos de WordPress' a . ¿Quieres ayudarnos a correr la voz aún más? Adelante, comparte el libro con tus amigos y colegas.

¡Gracias por suscribirte!

- Acabamos de enviar su copia de 'El libro de negocios del complemento de WordPress' a .

Compartir con un amigo Reenviar correo electrónico

¿Tienes un error tipográfico en tu correo electrónico? haga clic aquí para editar la dirección de correo electrónico y enviar de nuevo.

Descargar

Error #5: No utilizar la funcionalidad principal de WordPress

Muchos desarrolladores no aprovechan todo el potencial de la funcionalidad principal existente de WordPress. Algunos temas y complementos tienen archivos correspondientes a los archivos principales de WordPress, como Color Pickers y jQuery.

La creación de archivos adicionales aumentará el tamaño final del paquete y el tiempo de carga. Deberá mantener y actualizar estos archivos regularmente, lo que también requiere tiempo y esfuerzo.

Al utilizar lo que WordPress tiene para ofrecer, puede crear temas o complementos más ligeros y funcionales.

Error n.º 6: poner en cola archivos JavaScript y CSS

Poner en cola archivos JavaScript y CSS cuando no se necesitan es otro error común. Esto puede conducir a un tiempo de carga más lento y una clasificación de motor de búsqueda declinada, ya que cada archivo en cola agrega una solicitud HTTP adicional.

Error #7: Colocar código JavaScript en un solo archivo principal para temas avanzados

Si está desarrollando un tema avanzado con mucho JavaScript, es mejor abstenerse de colocar el código JavaScript en un único archivo principal. Muchos desarrolladores eligen colocar el código JavaScript del tema de WordPress en un archivo principal llamado main.js, theme.js o custom.js. Hay varias razones por las que no quieres hacer eso. En primer lugar, a medida que su tema crezca, el tamaño del archivo también aumentará. Como este archivo se cargará en todo el sitio, cada página tardará más en cargarse.

En segundo lugar, crear un solo archivo hará que sea más difícil administrar el código. Por ejemplo, no podrá colocar funciones, como wp_dequeue_script() para descargar código en algunas páginas para mejorar la velocidad.

Aquí hay un video que explica un poco más sobre ese tema:

Tenga en cuenta que este error solo es relevante para temas avanzados con una estructura de JavaScript compleja. Si su tema es más simple y liviano en JavaScript, colocar el código JavaScript en el archivo principal no dañará la funcionalidad de su tema.

Error n.º 8: no crear opciones adicionales para modificar el código

Cuando se realiza una actualización automática en el código directamente, todos los cambios de código manuales se perderán a menos que se modifiquen mediante acciones y filtros. Por eso es tan importante habilitar acciones y filtros para alteraciones.

De esta manera, usted y otros desarrolladores podrán modificar funciones sin editar el complemento en sí o el tema principal. Además, podrá usar los filtros y las acciones para agregar funciones adicionales, como extensiones o complementos, al complemento o tema principal.

Error n.º 9: no utilizar prácticas modernas de diseño de código

No utilizar las prácticas correctas de diseño de código es el último error que cierra nuestra lista. Se debe elegir la organización de código correcta según el tamaño y la naturaleza de su complemento.

Si está planeando construir un complemento pequeño de un solo propósito que no requiera una extensión adicional, más adelante, no hay necesidad de usar una arquitectura complicada con varias clases.

Si está creando una extensión de complemento que funciona con otros complementos o un complemento que requiere mucho código, es mejor usar el enfoque de programación orientada a objetos (OOP). La idea principal detrás de OOP es organizar el código en fragmentos, como clases para una mejor organización.

Además, no recomiendo mezclar código PHP y código HTML. Es mejor mantenerlos separados usando el patrón Modelo-Vista-Controlador (MVC), especialmente si varios desarrolladores mantienen su complemento.

comida para llevar

Como ha aprendido anteriormente, los errores más comunes suelen ser involuntarios, pero pueden tener consecuencias bastante decepcionantes.

En resumen, los errores más comunes son:

1. Sacrificar la calidad en favor de soluciones rápidas
2. No rastrear los cambios de código
3. No usar espacios de nombres
4. No utilizar nonces de WordPress
5. No utilizar la funcionalidad principal de WordPress
6. Encolar archivos JavaScript y CSS
7. Colocar código JavaScript en un solo archivo principal para temas avanzados
8. No se pueden crear opciones adicionales para modificar el código
9. No utilizar prácticas modernas de diseño de código

Aunque cometer errores es inevitable, ahora que sabes cuáles son, será más fácil evitarlos.

¿Ha cometido otros errores al crear su tema o complemento? Por favor, comparte tu experiencia en los comentarios a continuación y no te pierdas estos otros 5 errores que debes evitar.

Con contribuciones de Alyse Falk.