El dominio de WordPress Opciones API

Nota: Revisamos y ampliamos este artículo sobre las opciones de WordPress como parte de la ejecución, nuestra Guía multimedia para los principios de desarrollo de WordPress. Si desea el texto exacto del libro electrónico que incluye el capítulo, incluida la tecla Takeays, un resumen de Limerick (!) Y una prueba para probar su conocimiento, hay una descarga de PDF: dominar las opciones de WordPress (PDF). Y si le gusta el capítulo (aquí o en formato PDF), le gustará en funcionamiento, que tiene más de 300 páginas y más de 100 videos tutoriales sobre educación de WordPress al mismo nivel de calidad.
¡Aprende agradablemente la API de opciones de WordPress!
Los desarrolladores de WordPress generalmente tienen que grabar y modificar pequeños datos a nivel de sitio. Estos datos se conocen como opciones de sitio (o, a veces, “configuración del sitio”). Los ejemplos podrían incluir:
Tome la URL de la URL de exhibición del sitio personalizado
Establezca un color de fondo personalizado en el sitio
Actualizar programáticamente la dirección de correo electrónico del principal administrador del sitio
Más allá de estos pocos ejemplos, probablemente encontrará fascinante la tabla WP_options. (Como nota, el prefijo WP_ puede cambiar de acuerdo con la configuración del sitio, pero las opciones no cambiarán).
Tantas cosas se registran como opciones de sitio:

Haga clic para aumentar
Esta página captura muchas de las opciones que establece en un nuevo sitio de WordPress (y se puede cambiar en Configuración> General desde el menú de administración de WordPress). Por ejemplo, Blogname | WPShout Blogname | WPShout ofrece el título general para el sitio en sí y Start_of_week | 1 Start_of_week | 1 significa que la semana del sitio comienza el lunes. En este capítulo, explicaremos cómo acceder, agregar, cambiar y eliminar las opciones del sitio. Cómo trabajar con las opciones del sitio: las opciones de API de opciones de WordPress son muy simples. Las opciones son muy similares a los campos personalizados de WordPress. Los campos personalizados le permiten almacenar datos discretos posteriores al nivel, mientras que las opciones de API le permiten almacenar pequeños fragmentos de datos a nivel de sitio. ¡Aparte de eso, funciona bastante similar! Todas las opciones del sitio son esencialmente nombre/valor: el nombre de la opción y el valor que debe atribuirse a la opción. Puede acceder, agregar o modificar y eliminar estas opciones con tres funciones fáciles de usar:
get_option ()
update_option ()
Delete_option ()
Examinaremos cada una de estas funciones e ingresaremos algunos ejemplos.
Las opciones de API get_option () son muy simples y más que get_option (). Así es como puede acceder a la opción de nombres de Blogname: el título oficial que establecí para el sitio: ¡Eso es todo! Solo unas pocas notas al pie para agregar a esta imagen muy simple. Si la opción no existe de forma predeterminada, si solicita una opción que no se ha establecido, get_option () devolverá falso. Si desea algo más que falso, puede pasar un segundo valor a get_option () especificando lo que desea si la opción no existe. No usamos esta opción la mayor parte del tiempo, por lo que no nos detenemos. Cuando la opción es un datos complejos si nuestra opción era un objeto o una matriz de PHP cuando se establece, esto es lo que recibimos de get_option (): el: el objeto o matriz PHP con plenos derechos. Por lo tanto, get_option () no se limita a las cadenas y no tiene que preocuparse por ningún trabajo manual sinerializar () que pueda considerar si proviene de un entorno de PHP general.
update_option () tanto la creación como la actualización de una opción usa update_option (), como sigue: Update_option () actualiza el valor de una opción. Si la opción aún no existe, se crea la opción con el valor especificado. Devuelve verdadero si la opción se ha cambiado y falsa si la opción no se ha cambiado en comparación con el valor anterior o si la opción de actualizar la opción falló.
Update_option () argumentos de update_option () dos argumentos:

El nombre de la opción
El valor que la opción es tomar
Al igual que con los campos personalizados, hay una función add_, add_option (), que le recomendamos que ignore.Update_option () se comporta más previsiblemente tanto para agregar como actualizar opciones.De la versión de WordPress 4.2.0, la función también tiene un tercer argumento, $ Self.Le recomendamos que ignore esta opción, si no tiene una buena razón para usarla.Delete_option () Eliminar una opción es la siguiente: El único argumento de esta opción es el nombre de la opción eliminada.Devuelve verdadero si la opción se ha eliminado o falso si la eliminación de la opción falló (o la opción no existía primero).
Ejemplo: Cambie el título del sitio en April Fool’s Este complemento cambia el título del sitio a “wpsnort”, solo cuando es April Fool’s (1 de abril). Aquí está el código: < $ sitio_title = get_option ('Blogname'); // Ahorre "Título normal" si no actualmente es Título de broma if ($ Site_title! == $ BROK_ITLE) {update_option ('Site_normal_title', $ Site_title); } // El 1 de abril, el título del sitio para bromear el título $ day = data ('f j'); if ($ day === '' 1 de abril) {update_option ('blogname', $ broky_itle); devolver; } // Si existe normal_title y el título del sitio es el título de broma, cámbielo de nuevo $ normal_title = get_option ('SITE_NORMAL_TITLE'); if ($ site_title === $ check_itle && $ normal_title) {update_option ('blogname', $ normal_title); }} add_action ('init', 'wpshout_april_fools_itle'); Elegí esto como un ejemplo tanto para get_option () como para update_option (). Lo principal que debe ver es que registramos una nueva opción, 'Site_normal_title', que almacena el título "ordinario" del sitio, para que no pierda cuando el título de April Fool lo anula. Este "título ordinario" se guarda en el título del sitio cada vez que no es el 1 de abril.
Por cierto, si desea implementar efectivamente esta funcionalidad, simplemente filtrar el título el 1 de abril sería un poco más elegante. La complejidad de la función anterior probablemente debería ser un obsequido: las funciones que tienen muchas instrucciones y las variables "sustituyentes" a menudo pueden ser (aunque no siempre) de una manera más simple. Nota secundaria: Ver todas las opciones del sitio en /wp-admin/options.php Antes de ir más allá, solo queremos compartir un gran truco que atrapamos hace algún tiempo. Si desea ver todas las opciones de su sitio en una sola página, sin tener que navegar por su base de datos-go a http://yoursite.com/wp-admin/options.php. ¡Todo está ahí! Estos son los elementos básicos de las opciones de API, ya que esperamos haber aclarado, las opciones de WordPress son bastante simples. Y una vez que los comprenda, tendrá mucha potencia en la configuración global de sus sitios de WordPress. Imagen de crédito: Wideneng