Cómo crear una página de configuración en WordPress

Si crea un complemento de WordPress, es posible que se pregunte cómo crear una página de configuración. ¿WordPress ofrece un tipo de mecanismo “estándar” para esto? ¿Hay nuevas herramientas o marcos para crear páginas de configuración modernas? ¿Es una buena idea crear un conjunto de configuraciones? Bueno, hoy hablaremos de todo esto y responderé a sus preguntas. Las decisiones, no las opciones de WordPress, es una plataforma que tiene como objetivo democratizar la web. Esta declaración, que suena muy hermosa, pero al mismo tiempo es muy abstracta, es una forma de decir “Queremos que cualquiera use WordPress”. Y usted cree o no, las páginas de los entornos pueden ser y, de hecho, en muchos casos son una barrera para ello. ¿No me crees? Bueno, el propio WordPress dice que:
Cuando tomamos decisiones, estos son los usuarios que consideramos primero. Un excelente ejemplo de esta consideración son las opciones de software. Cada vez que le da a un usuario una opción, les pide que tomen una decisión. Cuando a un usuario no le importa o no entiende la opción, eventualmente conduce a la frustración. Como desarrolladores, a veces creemos que ofrecer opciones para cualquier cosa es algo bueno, nunca puedes tener demasiadas opciones, ¿verdad? Finalmente, estas opciones se convierten en las técnicas, opciones en las que el usuario final habitual no tiene interés. Es nuestro deber para los desarrolladores tomar decisiones de diseño inteligentes y evitar poner el peso de las opciones técnicas en nuestros usuarios finales.
Por lo tanto, la filosofía de WordPress, por lo que antes de crear una página de configuración, piense cuidadosamente en las opciones que desea dar a sus usuarios, ¿por qué desea tener acceso a esas opciones y si es necesario o útil para hacer esto? Filtros como una alternativa, incluso si sé que no debería ofrecer demasiadas opciones a mis usuarios, debo confesar que, como desarrollador, no siempre es fácil para mí tomar una decisión en lugar de proporcionar una opción. Hay momentos en que quiero que mis usuarios tengan la oportunidad de elegir, aunque soy consciente de que las opciones que exponen son complejas. Entonces, ¿qué hago en estos casos? La siguiente es la recomendación de WordPress y limito a mis usuarios avanzados. Afortunadamente, WordPress ofrece una solución perfecta para este dilema: los filtros. Al diseñar un complemento y desea que sus usuarios (avance) ajusten su comportamiento, no cree una página de configuración o algo así. En su lugar, haga su complemento personalizable a través del mecanismo de filtro de WordPress. Si usa filtros, la mayoría de sus usuarios disfrutarán de un comportamiento predeterminado (“¿decisiones”, ¿recuerdas?), Debido a que usarán el complemento con los valores implícitos establecidos en sus filtros, mientras que los usuarios avanzados tendrán la oportunidad de modificarlos. decisiones de ganchos (y entonces tiene “opciones”). ¡Lo mejor de ambos mundos!
Configuración de WordPress OK, ahora que somos conscientes de la importancia de tomar decisiones para nuestros usuarios y hemos visto cómo omitir esta limitación (si es necesario) a través de filtros, es hora de ver cómo podemos crear una página de configuración de WordPress.Porque sí: hay momentos en que realmente tenemos que ofrecer a nuestros usuarios la opción de tomar decisiones de acuerdo con sus preferencias.La configuración de la API en la configuración de la API de WordPress se han agregado en WordPress 2.7.Este es un conjunto de funciones que estandarizan la creación de páginas de configuración, lo que le permite definir qué opciones están disponibles, que será la interfaz de usuario para editar cada opción (esencialmente, los campos en una forma) y cómo validar, guardar y y y y recuperar sus valores.
Creo que la mejor manera de aprender es por ejemplos, así que creemos nuestra primera página de configuración utilizando la configuración paso a paso. Creación de un nuevo conjunto de configuraciones Lo primero que debe hacer para crear una página de configuración es (¡sorpresa, sorpresa!) Para crear una página para mostrar la configuración. To do this, simply use the add_options_page function during the action of admin_men and register the page: Function Neli_add_Settings_Page () {add_options_Page (‘Neli Plugin Settings’, ‘Nelio’, ‘Manage_OPTIONS’, ‘Nolio-Ex-Plugin’, ‘, ‘Neli_render_settings_page’); } add_action (‘admin_men’, ‘neli_add_settings_page’); Como puede ver, lo único que hacemos con esta función es grabar una nueva página que aparecerá en el menú Configuración de WordPress, con su título, el nombre del menú, los permisos que el usuario debe tener para acceder y Bone en. El último argumento, neli_render_settings_page, es el nombre de la función que manejará la página respectiva:
;do_settings_sections (‘neli_example_plogin’);? La configuración en sí es relativamente fácil de crear.Solo tenemos que agregar un formulario cuyo contenido será semiautomático por WordPress.Por un lado, invocamos la función Settings_fields, que prácticamente agrega una forma no en forma para que sea “segura”.Luego le pedimos a WordPress que recupere todas las configuraciones que hemos creado para nuestro complemento utilizando las do_settings_sections.Y finalmente, simplemente agregamos el botón para enviar el formulario.
Configuración real En nuestra próxima página de configuración, debemos registrar cada una de las opciones que formarán parte de nuestra página de configuración. Para hacer esto, utilizaremos dos funciones: registrar_setting, que nos permite indicar los nombres con los que guardaremos la configuración en la base de datos y add_settings_field, que agrega cada opción individual: función neli_register ‘,’ neli_validate_example_plugin_settings ‘); add_settings_section (‘section_one’, ‘Sección uno’, ‘neli_section_one_text’, ‘neli_example_plogin’); add_settings_field (‘some_text_field’, ‘algún campo de texto’, ‘neli_render add_settings_field (‘otro_number_field’, ‘otro campo de número’, ‘neli_render_number_field’, ‘neli_example_plin’, ‘section_one’); } add_action (‘admin_init’, ‘neli_register_setings’); El fragmento de código anterior tiene algunas cosas que merecen atención especial. Por un lado, tenga en cuenta que la función Registro_Setting tiene el tercer argumento: NELI_VALIDATE_EXAMPLE_PLIN_SETTINGS. Este es el nombre de la función de llamada inversa que se llamará para validar los valores que el usuario ha seleccionado (tenga en cuenta que siempre debe validar y desinfectar sus campos de formulario). Esta función es así:

Función neli_validate_example_plugin_settings ($ input) {$ output [‘some_text_field’] = sanitize_text_field ($ input [‘some_text_field’]);$ Output [‘otro_number_field’] = ABSINT ($ input [‘otro_number_field’]);// … devolver $ salida;} Donde tomamos cada campo enviado desde $ entrada y lo desinfectamos en $ salida, de modo que sepamos con certeza que lo que ahorremos en la base de datos, es válido y correcto.La segunda cosa en la que quería centrarme es en que cada uno de los campos que definimos también incluye una referencia de función que dice WordPress ya que cada campo debe jugarse.Por ejemplo, la parte posterior de los campos en nuestro ejemplo podría ser así:
Función neli_section_one_text () {echo ‘
Esta es la primera (y única) sección en mi configuración.
‘; } Function neli_render_some_text_field () {$ options = get_option (‘neli_example_plogin_settings’); printf (”, esc_attr (‘neli_example_plugin_settings [some_text_field]’), esc_attr ($ options [some_text_field ‘)); } Function neli_render_another_number_field () {$ options = get_option (‘neli_example_plugin_settings’); printf (”, esc_attr (‘neli_example_plugin_settings [otro_number_field]’), esc_attr ($ opciones [‘annumber_field’)); } Esencialmente, todas estas llamadas inversas son para recuperar el valor actual del campo que debe jugar (con get_option) y reproducir el HTML que permitirá al usuario establecer un valor u otro (en este ejemplo, un texto de tipo de campo de entrada o texto o Número). ¿Cuál es el resultado final? ¿Te preguntas? Este:
Ejemplo de página de configuración simple.
Pensamientos finales Como puede ver, crear un conjunto de configuraciones es relativamente simple. Personalmente, no me gusta mucho todo el proceso, porque es bastante repetitivo y tenemos que escribir una y otra vez el mismo código estándar … pero es fácil.

El generador de código API de configuración de WP le permite crear fácilmente su esqueleto de su configuración.
Sin embargo, para simplificar este proceso aún más, hay algunos generadores de código en línea con los que, a través de una interfaz de usuario simple, puede definir los diferentes campos que desea en la página de configuración.Algunos ejemplos son: API de configuración de WP

Generador de página de WordPressOption
Y, por supuesto, siempre existe la oportunidad de crear una página de configuración utilizando tecnologías como React … pero esta es una historia para otro período, ¿no crees?Imagen presentada por la rima kruciana en Unsplash.