add_filter('widget_update_callback', function($instance, $new_instance, $old_instance) {\n $instance['awp-custom-setting'] = isset($new_instance['awp-custom-setting']);\n return $instance;\n}, 10, 3);<\/code><\/pre>\nRecuerde ajustar los nombres de entrada a sus propios nombres de configuraci\u00f3n. Si est\u00e1 agregando varias entradas, debe repetir esto para cada una.<\/p>\n
\u00a1Ahora deber\u00eda ver que su configuraci\u00f3n personalizada se est\u00e1 guardando en el administrador!<\/p>\n
Uso de configuraciones de widgets personalizadas guardadas<\/h2>\n
Como se mencion\u00f3 anteriormente, esta parte realmente depende de lo que desea que haga su configuraci\u00f3n. Desafortunadamente, no es tan sencillo porque la mayor\u00eda de los widgets no agregan filtros o ganchos en sus salidas. Comencemos con algo simple; evite renderizar el widget dependiendo de la configuraci\u00f3n.<\/p>\n
Impedir el widget de renderizado seg\u00fan la configuraci\u00f3n personalizada<\/h3>\n
Digamos que est\u00e1 agregando configuraciones para cuando el widget deber\u00eda estar visible; por ejemplo, ocultarlo en ciertas plantillas (ocultar en la plantilla de resultados de b\u00fasqueda, pero mostrarlo en la p\u00e1gina principal y \u00fanico), o reaccionar a otros estados de WordPress.<\/p>\n
Para ello podemos utilizar el filtro [widget_display_callback](https:\/\/developer.wordpress.org\/reference\/hooks\/widget_display_callback\/)<\/code>. Todo lo que tenemos que hacer es verificar el par\u00e1metro de instancia provisto para nuestra configuraci\u00f3n y regresar false<\/code>si no queremos renderizar el widget.<\/p>\nEste c\u00f3digo simple evitar\u00e1 renderizar el widget si la casilla de verificaci\u00f3n personalizada que agregamos arriba est\u00e1 marcada:<\/p>\n
add_filter('widget_display_callback', function($instance, $widget, $args) {\n if ($instance['awp-custom-setting']) {\n return false;\n }\n return $instance;\n}, 10, 3);<\/code><\/pre>\nProbablemente quieras comparar otros estados. Este es un ejemplo simple en el que nuestra casilla de verificaci\u00f3n es una casilla de verificaci\u00f3n para "Ocultar en vistas de publicaciones individuales". Simplemente verificamos si actualmente estamos en una vista de publicaci\u00f3n \u00fanica [is_singular](https:\/\/developer.wordpress.org\/reference\/functions\/is_singular\/)()<\/code>y, si la casilla de verificaci\u00f3n est\u00e1 marcada, devolvemos false<\/code>.<\/p>\nadd_filter('widget_display_callback', function($instance, $widget, $args) {\n if (is_singular() && $instance['awp-custom-setting']) {\n return false;\n }\n return $instance;\n}, 10, 3);<\/code><\/pre>\nModificar la configuraci\u00f3n o la salida del widget existente<\/h3>\n
Un filtro poderoso para utilizar para jugar con los widgets existentes es [dynamic_sidebar_params](https:\/\/developer.wordpress.org\/reference\/hooks\/dynamic_sidebar_params\/)<\/code>. Eche un vistazo a la p\u00e1gina de documentaci\u00f3n para ver qu\u00e9 par\u00e1metros puede modificar. Por ejemplo, puede agregar clases personalizadas, puede modificar las cadenas before_widget<\/code>, after_widget<\/code>o before_title<\/code>y after_title<\/code>HTML. Sin embargo, esto se aplica a todos los widgets, tambi\u00e9n al administrador y al frontend. Y con este filtro no tiene acceso a la instancia del widget (configuraci\u00f3n guardada) ni a la configuraci\u00f3n del widget (por ejemplo, tipo de widget).<\/p>\nObviamente, necesitamos al menos verificar nuestra configuraci\u00f3n personalizada. Entonces, necesitamos hacer bastante c\u00f3digo para obtener los valores que necesitamos.<\/p>\n
Lo primero que podemos hacer es acceder a una variable global $wp_registered_widgets<\/code>. Esta es una matriz que contiene todos los widgets disponibles registrados. Usando ese registro, podemos usar el par\u00e1metro del filtro para encontrar el widget espec\u00edfico en el que nos encontramos actualmente. Una vez que hemos encontrado el widget actual, tenemos acceso a los par\u00e1metros del widget, como id_base<\/code>\u2013 que, como vimos anteriormente, nos dice el tipo de widget.<\/p>\nadd_filter('dynamic_sidebar_params', function($params) {\n global $wp_registered_widgets;\n\u00a0\n $this_widget_id = $params[0]['widget_id']; \/\/ Current widget ID\n $this_widget = $wp_registered_widgets[$this_widget_id];\n $widget_object = $this_widget['callback'][0]; \/\/ Current widget object\n\u00a0\n \/\/ With $widget_object we have access to e.g. id_base for checking type of widget\n if ($widget_object->id_base != 'nav_menu') {\n return $params;\n }\n\u00a0\n return $params;\n});<\/code><\/pre>\nComo puede ver en l\u00ednea #9<\/code>, finalmente podemos verificar en qu\u00e9 tipo de widget nos encontramos actualmente. En el c\u00f3digo anterior, devuelvo si el tipo de widget no es un widget de navegaci\u00f3n, ya que nuestra configuraci\u00f3n personalizada solo se agreg\u00f3 para esos widgets.<\/p>\nObtener la configuraci\u00f3n guardada del widget<\/h3>\n
Pero tambi\u00e9n necesitamos obtener la configuraci\u00f3n guardada por widget (incluida nuestra configuraci\u00f3n personalizada). Las configuraciones guardadas de todos los widgets se almacenan en la base de datos de opciones agrupadas por tipo de widget. Usando una propiedad en el registro de widgets, podemos usar [get_option](https:\/\/developer.wordpress.org\/reference\/functions\/get_option\/)()<\/code>para obtener la configuraci\u00f3n guardada para el tipo de widget actual. El retorno ser\u00e1 una matriz indexada donde necesitamos usar otro par\u00e1metro m\u00e1s del filtro para encontrar el \u00edndice actual (porque puede agregar m\u00faltiples del mismo tipo de widget en las mismas barras laterales o en diferentes). Es m\u00e1s f\u00e1cil mostrar con c\u00f3digo que explicarlo:<\/p>\n ...\n if ($widget_object->id_base != 'nav_menu') {\n return $params;\n }\n\u00a0\n $all_settings = get_option($widget_object->option_name);\n $saved_settings = $all_settings[$params[1]['number']];\n if ($saved_settings['my-custom-thing']) {\n \/\/ Do your thing\n }\n\u00a0\n return $params;\n});<\/code><\/pre>\n\u00a1Finalmente obtenemos las configuraciones guardadas del widget! En el c\u00f3digo de ejemplo anterior, en la l\u00ednea #9<\/code>, verificamos si nuestra casilla de verificaci\u00f3n personalizada est\u00e1 marcada o no.<\/p>\nEjemplos<\/h3>\n
En este punto, depende de ti lo que quieras hacer. Por ejemplo, puede generar una salida despu\u00e9s del t\u00edtulo del widget, pero antes del contenido del widget:<\/p>\n
...\n if ($saved_settings['my-custom-thing']) {\n $params[0]['after_title'] .= '<div>This appears before widget content<\/div>';\n }\n ...<\/code><\/pre>\nPara casos de uso m\u00e1s reales, normalmente resolver\u00eda la mayor\u00eda agregando ciertos filtros en este punto, llamando add_filter()<\/code>en este punto.<\/p>\nA continuaci\u00f3n se muestra un ejemplo de modificaci\u00f3n de los argumentos del men\u00fa de navegaci\u00f3n mediante la adici\u00f3n de un filtro si se marc\u00f3 nuestra configuraci\u00f3n. Si no estaba marcado, nos aseguramos de que se elimine el filtro. El filtro para modificar los argumentos para representar un men\u00fa de navegaci\u00f3n es widget_nav_menu_args<\/code>. En el c\u00f3digo a continuaci\u00f3n, defin\u00ed una funci\u00f3n para aplicar a este filtro que agrega un nuevo argumento a los argumentos del men\u00fa; un caminante:<\/p>\n ...\n if ($saved_settings['my-custom-thing']) {\n add_filter('widget_nav_menu_args', 'awp_add_menu_walker', 10, 3);\n } else {\n remove_filter('widget_nav_menu_args', 'awp_add_menu_walker', 10);\n }\n return $params;\n});\nfunction awp_add_menu_walker($nav_menu_args, $nav_menu, $args) {\n $nav_menu_args['walker'] = new AWP_Custom_Walker();\n return $nav_menu_args;\n}<\/code><\/pre>\nEl c\u00f3digo anterior es un ejemplo de un caso de uso en el que la casilla de verificaci\u00f3n personalizada controla si se aplica o no un caminante de men\u00fa al men\u00fa. Excelente si desea que todos los men\u00fas se muestren con normalidad, pero desea que la opci\u00f3n de widgets de men\u00fa espec\u00edficos se muestre de manera diferente. Lo que haga el andador con la salida del men\u00fa depende de usted.<\/p>\n
Consulte a continuaci\u00f3n el c\u00f3digo completo para agregar una configuraci\u00f3n personalizada a todos los men\u00fas de navegaci\u00f3n, actualizarla y aplicar un men\u00fa de navegaci\u00f3n.<\/p>\n
Esperemos que esto sea suficiente para que descubras c\u00f3mo codificar lo que quieres hacer. Realmente depende de lo que quieras hacer y con qu\u00e9 tipo de widget est\u00e9s trabajando. Como se mencion\u00f3 anteriormente, por lo general, la mayor\u00eda de las modificaciones se pueden resolver agregando filtros para hacer lo suyo en formato dynamic_sidebar_params<\/code>.<\/p>\nEjemplo completo: configuraci\u00f3n de casilla de verificaci\u00f3n personalizada en los widgets de navegaci\u00f3n para aplicar un caminante de men\u00fas<\/h2>\n
Aqu\u00ed est\u00e1 el c\u00f3digo completo para agregar una casilla de verificaci\u00f3n personalizada a todos los widgets del men\u00fa de navegaci\u00f3n de WordPress para usar un caminante de men\u00fa registrado. (C\u00f3digo de andador no incluido)<\/p>\n
\/\/ Add custom setting to menu widgets\nadd_action('in_widget_form', function($widget, $return, $instance) {\n \/\/ Add setting only to menu widgets\n if ($widget->id_base != 'nav_menu') {\n return;\n }\n\u00a0\n ?>\n <p>\n <input type=\"checkbox\" class=\"checkbox\" name=\"<?php echo $widget->get_field_name('activate-walker'); ?>\" id=\"<?php echo $widget->get_field_name('activate-walker'); ?>\" <?php checked(isset($instance['activate-walker'])? $instance['activate-walker']: 0); ?> \/>\n <label for=\"<?php echo $widget->get_field_name('activate-walker'); ?>\"><?php __('Activate walker', 'txtdomain'); ?><\/label>\n <\/p>\n <?php\n}, 10, 3);\n\u00a0\n\u00a0\n\/\/ Update custom setting\nadd_filter('widget_update_callback', function($instance, $new_instance, $old_instance) {\n $instance['activate-walker'] = isset($new_instance['activate-walker']);\n return $instance;\n}, 10, 3);\n\u00a0\n\u00a0\n\/\/ Filter sidebar params to add filter if custom setting was activated\nadd_filter('dynamic_sidebar_params', function($params) {\n global $wp_registered_widgets;\n\u00a0\n $this_widget_id = $params[0]['widget_id'];\n $this_widget = $wp_registered_widgets[$this_widget_id];\n $widget_object = $this_widget['callback'][0];\n\u00a0\n \/\/ Bail if not a menu widget\n if ($widget_object->id_base != 'nav_menu') {\n return $params;\n }\n\u00a0\n $all_settings = get_option($widget_object->option_name);\n $saved_settings = $all_settings[$params[1]['number']];\n\u00a0\n if ($saved_settings['activate-walker']) {\n add_filter('widget_nav_menu_args', 'awp_add_menu_walker', 10, 3);\n } else {\n remove_filter('widget_nav_menu_args', 'awp_add_menu_walker', 10);\n }\n\u00a0\n return $params;\n});\n\u00a0\n\u00a0\n\/\/ Filter nav menu arguments to add walker\nfunction awp_add_menu_walker($nav_menu_args, $nav_menu, $args) {\n $nav_menu_args['walker'] = new AWP_Custom_Walker();\n return $nav_menu_args;\n}<\/code><\/pre>\nConclusi\u00f3n<\/h2>\n
\u00a1Espero que esta publicaci\u00f3n haya sido \u00fatil para resolver sus necesidades o darle algunos consejos sobre c\u00f3mo puede hacer lo que necesita hacer!<\/p>\n
Fuente de grabaci\u00f3n:
awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"C\u00f3mo agregar configuraciones personalizadas a cualquiera de los widgets est\u00e1ndar de WordPress. Con esta configuraci\u00f3n, aprenderemos c\u00f3mo manipular el comportamiento de los widgets en consecuencia.<\/p>\n","protected":false},"author":1,"featured_media":223663,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[924,892,892,716,716,831,1110,800,800,831,924,840,840,861,861],"tags":[1172],"class_list":["post-233473","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-asignaturas","category-codigo","category-desarrollador","category-guia-para-principiantes","category-n-a","category-php-2","category-tutoriales","category-wordpress-2","tag-affiai-es"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts\/233473","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/comments?post=233473"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts\/233473\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/media\/223663"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/media?parent=233473"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/categories?post=233473"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/tags?post=233473"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"C\u00f3mo](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153158-61e509045fded.png\")
<\/a><\/p>\n