Como hemos mencionado muchas veces aquí en WP Tuts (y como sin duda habrás notado), nunca ha habido un mejor momento para ser un desarrollador de WordPress. Ya sea en el trabajo del cliente o en el desarrollo de productos (con temas o complementos), comenzar en el ecosistema de WordPress es casi una cuestión de "dónde" en lugar de "cómo".
WordPress tiene documentación de API estelar para desarrolladores sin importar el nivel de experiencia. Pero una comunidad de desarrollo activa y una API bien documentada no hacen que una plataforma sea inmune a las malas prácticas de desarrollo.
Al igual que con la mayoría de los aspectos del desarrollo web, solo porque algo funcione no significa que se haya creado de la manera correcta. Pero como desarrolladores y artesanos, tenemos la tarea de asegurarnos de que el trabajo que liberamos funcione y esté construido correctamente. Verter el código fuente para una variedad de temas o complementos muestra que los desarrolladores están lanzando productos que funcionan pero que no están diseñados de la mejor manera posible. Esto es especialmente cierto en las áreas de opciones de tema, páginas de menú, validación, etc..
Y queremos detener eso..
En esta serie, vamos a profundizar en la API de configuración de WordPress. Vamos a ver qué es, por qué es importante y cómo aprovecharla en nuestro trabajo..
Nuestro objetivo final es que esta serie sea una referencia sólida para la API de configuración. sin importar de tu nivel de experiencia. Al final, debe tener una comprensión clara de la API y ejemplos sólidos de cómo hacer las cosas de la manera correcta.
Para estar completos, necesitamos comenzar desde cero. Así que antes de escribir cualquier código o trabajar con cualquier ejemplo, necesitamos introducir la API de configuración, qué es y por qué es importante..
En el nivel más básico, la API de configuración es un conjunto de funciones proporcionadas por WordPress que simplifica el proceso de introducción de menús, páginas de opciones y el guardado, validación y recuperación de la entrada del usuario..
Bastante fácil, cierto?
A lo largo de esta serie, analizaremos cada aspecto, pero esto debería proporcionar una definición simple a partir de la cual podemos trabajar durante el resto de los artículos..
Ahora que entendemos lo que la API de configuración en realidad es, Necesitamos ver por qué querríamos usar esto en lugar de manejar la entrada de usuario, la serialización y la validación por nuestra cuenta..
La API de configuración es proporcionada por los desarrolladores de la plataforma de WordPress para facilitar la extensión de la aplicación. Como tal, ¿no tendría sentido utilizar las funciones proporcionadas por los propios autores de la plataforma??
Claro, es completamente posible eludir estas funciones y "forzar la fuerza bruta" con nuestra propia funcionalidad y nadie más puede detenerla, pero esto requiere un trabajo innecesario en nuestro nombre, ignora las recomendaciones del equipo de WordPress Core y, finalmente, puede romper la experiencia de cohesión. del tablero de instrumentos.
Opción para aprovechar la funcionalidad que se proporciona para desarrolladores por los desarrolladores se aseguran de que nos comunicaremos con la aplicación central de la manera adecuada.
El uso de la API de configuración no consiste solo en asegurarse de que nos estamos acercando al desarrollo a través de los canales recomendados. También se trata de garantizar que nuestras interfaces de usuario sigan las mejores prácticas de la plataforma y que nuestros datos se desinfecten utilizando los mismos mecanismos que utiliza el resto de WordPress. No duele que nos pueda ahorrar mucho tiempo, tampoco.
Cuando comience a desarrollar sus interfaces de tal manera que aprovechen los estilos de WordPress existentes y use la API de configuración, su trabajo se verá mucho más integrado con el resto del sistema.
Esto significa que cuando los usuarios comienzan a utilizar su trabajo, no se sentirán como si estuvieran usando una utilidad de terceros al trabajar con su blog. En su lugar, están trabajando con una mejora (a diferencia de, digamos, una adición) a la plataforma central.
Es cierto que el uso de los estilos nativos de WordPress no es una parte verdadera de la API de configuración y lo anterior es algo así como una perspectiva subjetiva, pero algunos aspectos de la API de configuración, como la introducción de páginas de menú, aprovechan los estilos nativos de WordPress. ¿No tiene sentido, entonces, que el resto de su trabajo siga su ejemplo??
Al aprovechar las funciones que son nativas de WordPress en lugar de aprovechar las suyas, puede estar seguro de que la configuración de guardar, recuperar y validar se administra correctamente. Después de todo, la API de configuración proporciona gran parte de la misma funcionalidad en la que se basa la aplicación central.
Además, la API de configuración está sujeta a las mismas reglas que el resto de la API de WordPress. Como tal, cuando la aplicación se actualiza y / o se introducen cambios, las funciones deberán pasar por el proceso habitual de desaprobación. Esto le da el tiempo adecuado para trabajar en la actualización de su proyecto antes de que se rompa la compatibilidad. Esto no es necesariamente el caso si va a rodar su propia funcionalidad.
En este punto, debe tener una comprensión clara de qué es la API de configuración y por qué debería usarla en el trabajo de temas y complementos.
Por supuesto, todo esto es un poco argumentativo: aún no hemos visto ejemplos prácticos. A lo largo del resto de esta serie, veremos lo siguiente:
Al final de la serie, debe tener todo lo que necesita para comenzar a crear productos sólidos basados en WordPress..