La Guía Completa de la API de Configuración de WordPress, Parte 1: Qué Es, Porqué Es Importante

Como hemos mencionado numerosas veces aquí en WP Tusts (y como sin duda habrás notado), nunca ha habido un mejor momento para ser Desarrollador de WordPress. Ya se trate del trabajo con el cliente o de desarrollo de productos (ya sea con temas o plugins), para empezar en el ecosistema de WordPress es casi más una pregunta de 'dónde' en lugar de 'cómo'.

WordPress tiene una documentación de la API estelar para desarrolladores independientemente de su nivel de experiencia. Pero una comunidad de desarrollo activa y una API bien documentada no hacen que sea una plataforma inmune a prácticas de desarrollo pobres.

Al igual que con la mayoría de aspectos del desarrollo web, sólo porque algo funciona no significa que esté hecho de la forma correcta. Pero como desarrolladores y artesanos, nos encargamos de asegurarnos de que el trabajo que liberamos funcione y esté construido apropiadamente. El torrente de código fuente de una variedad de temas o plugins muestra que los desarrolladores están lanzando productos que funcionan pero que no están construidos de la mejor manera posible. Esto es especialmente verdad en las áreas de opciones de temas, páginas de menú, validación, etc...

Y queremos parar 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 aprovecharlo in nuestro trabajo.

Nuestro objetivo final para esta serie es que sea una referencia sólida para la API de Configuración sin importar tu nivel de experiencia. Al final, debes tener un claro conocimiento del API y ejemplos sólidos de como hacer cosas de la forma correcta.

Con el fin de que la completes, necesitamos empezar desde cero. Por lo tanto, antes de escribir código o trabajar con algún ejemplo, necesitamos introducirte en la API de Configuración, qué es y por qué es importante.

Definición del API de Configuración

A nivel más básico, el API de Configuración es un conjunto de funciones facilitadas por WordPress que simplifica el proceso de introducción de menus, páginas de opción, y el guardado, validación y recuperación de lo que introduzca el usuario.

Bastante fácil, ¿verdad?

A lo largo de esta serie, profundizaremos en cada aspecto pero nos proveerá de una definición simple que nos permitirá trabajar con el restos de los artículos.

¿Por qué debemos utilizar el API de Configuración?

Ahora que ya entendemos qué es el API de Configuración, necesitamos ver el porqué querríamos utilizar esta en lugar de manejar por nuestra cuenta la entrada del usuario, serialización y validación.

Se Comunica con el Core de WordPress

El API de Configuración es suministrada por los desarrolladores de la Plataforma WordPress para hacer fácil extender la aplicación. ¿Como tal, no tiene sentido utilizar las funciones proporcionadas por los autores de la plataforma en sí mismas?

Seguro, es completamente posible evitar estas funciones y la "fuerza bruta" en nuestra propia funcionalidad y nada más podrá pararlo, pero esto requiere trabajo innecesario, ignora las recomendaciones de el Equipo del Núcleo de WordPress y en última instancia romper la experiencia cohesiva del Escritorio.

Optan por aprovechar la funcionalidad que se proporciona para los desarrolladores por los desarrolladores asegurando que nos comunicarán con la aplicación principal de la manera adecuada.

Cosas Gratis Out-Of-The-Box

Usando el API de configuración no es todo sobre de asegurarse de que nos estamos acercando a desarrollo a través de los canales recomendados. También es asegurar que nuestras interfaces de usuario siguen las mejores prácticas de la plataforma y que nuestros datos están desinfectados utilizando los mismos mecanismos que utiliza el resto de WordPress. No duele, y puede ahorrar mucho tiempo.

Cuando comienzas a construir tus interfaces de manera que aprovechen los estilos existentes de WordPress y usando la API de configuración, tu trabajo se va a ver mucho más estrechamente integrado con el resto del sistema.

Esto significa que cuando los usuarios comienzan a utilizar tu trabajo, no sienten como si estuvieran usando una utilidad de terceros cuando se trabaja con su blog. En cambio, están trabajando con una mejora (en oposición a, digamos, un añadido) a la plataforma del núcleo.

Es cierto que utilizar estilos nativos de WordPress no es una verdadera parte de la API de configuración y lo anterior es una perspectiva subjetiva, y aspectos de la API de configuración, como la introducción de páginas de menú - aprovechan estilos nativos de WordPress. ¿No tiene sentido, entonces, que el resto de tu trabajo deba seguir el ejemplo?

Más Seguro, Más Resiliente

Tomando ventaja de las funciones que son nativas de WordPress en lugar de aprovechar las tuyas, puedes estar seguro que salvar, recuperar y validar que configuración está correctamente gestionada. Después de todo, la API de configuración proporciona gran parte de la misma funcionalidad en la que se basa la aplicación del núcleo.

Además de eso, la API de configuración está sujeta a las mismas reglas que el resto de las API de WordPress. Como tal, cuando la aplicación se actualiza o se introducen cambios, las funciones tendrán que pasar por el proceso de degradación habituales. Esto le da tiempo suficiente para trabajar sobre la actualización de tu proyecto antes de que falle la compatibilidad. Esto no es necesariamente el caso si echas a rodar tu propia funcionalidad.

Próxima Hoja de Ruta

En este punto, debes tener una comprensión clara de lo que es la API de configuración y por qué debes usarla en temas y plugins.

Por supuesto, es todo un poco argumentativo - tenemos que realmente echar un vistazo a algunos ejemplos prácticos. En el resto de esta serie, vamos a echar un vistazo a los siguientes:

• Navegación con Pestañas, Menús y Secciones
• Registrar ajustes de las secciones
• Elementos primitivos (entradas, áreas de texto, selects, botones de opción y casillas de verificación)
• Un sencillo, ejemplo de trabajo

Al final de la serie, debes tener todo que lo necesario para empezar a crear productos basados en WordPress.