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>\nN’oubliez pas d’ajuster les noms d’entr\u00e9e \u00e0 vos propres noms de param\u00e8tres. Si vous ajoutez plusieurs entr\u00e9es, vous devez r\u00e9p\u00e9ter cette op\u00e9ration pour chacune.<\/p>\n
Vous devriez maintenant voir que vos param\u00e8tres personnalis\u00e9s sont enregistr\u00e9s dans l’administrateur\u00a0!<\/p>\n
Utilisation des param\u00e8tres de widget personnalis\u00e9s enregistr\u00e9s<\/h2>\n
Comme mentionn\u00e9 pr\u00e9c\u00e9demment, cette partie d\u00e9pend vraiment de ce que vous voulez que vos param\u00e8tres fassent. Ce n’est malheureusement pas aussi simple car la plupart des widgets n’ajoutent pas de filtres ou de crochets dans leurs sorties. Commen\u00e7ons par quelque chose de simple\u00a0; \u00e9vitez de rendre le widget en fonction des param\u00e8tres.<\/p>\n
Emp\u00eacher le rendu du widget en fonction du param\u00e8tre personnalis\u00e9<\/h3>\n
Supposons que vous ajoutez des param\u00e8tres pour d\u00e9terminer quand le widget doit \u00eatre visible\u00a0; par exemple en le cachant dans certains mod\u00e8les (masquer dans le mod\u00e8le de r\u00e9sultats de recherche, mais afficher en page d’accueil et unique), ou r\u00e9agir \u00e0 d’autres \u00e9tats de WordPress.<\/p>\n
Pour cela, nous pouvons utiliser le filtre [widget_display_callback](https:\/\/developer.wordpress.org\/reference\/hooks\/widget_display_callback\/)<\/code>. Tout ce que nous avons \u00e0 faire est de v\u00e9rifier le param\u00e8tre d’instance fourni pour notre param\u00e8tre et de revenir false<\/code>si nous ne voulons pas afficher le widget.<\/p>\nCe code simple \u00e9vitera de rendre le widget si la case \u00e0 cocher personnalis\u00e9e que nous avons ajout\u00e9e ci-dessus est coch\u00e9e\u00a0:<\/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>\nVous voulez probablement comparer d’autres \u00c9tats. Ceci est un exemple simple o\u00f9 notre case \u00e0 cocher est une case \u00e0 cocher pour "Masquer dans les vues de publication unique". Nous v\u00e9rifions simplement si nous sommes actuellement \u00e0 une vue de publication unique avec [is_singular](https:\/\/developer.wordpress.org\/reference\/functions\/is_singular\/)()<\/code>et si la case est coch\u00e9e, nous retournons 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>\nModification des param\u00e8tres ou de la sortie du widget existant<\/h3>\n
Un filtre puissant \u00e0 utiliser pour jouer avec les widgets existants est [dynamic_sidebar_params](https:\/\/developer.wordpress.org\/reference\/hooks\/dynamic_sidebar_params\/)<\/code>. Jetez un \u0153il \u00e0 la page de documentation pour voir quels param\u00e8tres vous pouvez modifier. Par exemple, vous pouvez ajouter des classes personnalis\u00e9es, vous pouvez modifier les cha\u00eenes before_widget<\/code>, after_widget<\/code>ou before_title<\/code>et after_title<\/code>HTML. Cependant, cela s’applique \u00e0 tous les widgets, \u00e9galement admin et frontend. Et avec ce filtre, vous n’avez pas acc\u00e8s \u00e0 l’instance du widget (param\u00e8tres enregistr\u00e9s) ou aux param\u00e8tres du widget (par exemple, le type de widget).<\/p>\n\u00c9videmment, nous devons au moins v\u00e9rifier nos param\u00e8tres personnalis\u00e9s. Nous devons donc faire pas mal de code pour r\u00e9cup\u00e9rer les valeurs dont nous avons besoin.<\/p>\n
La premi\u00e8re chose que nous pouvons faire est d’acc\u00e9der \u00e0 une variable globale $wp_registered_widgets<\/code>. Il s’agit d’un tableau qui contient tous les widgets enregistr\u00e9s et disponibles. En utilisant ce registre, nous pouvons utiliser le param\u00e8tre du filtre pour trouver le widget sp\u00e9cifique auquel nous nous trouvons actuellement. Une fois que nous avons trouv\u00e9 le widget actuel, nous avons acc\u00e8s aux param\u00e8tres du widget, tels que id_base<\/code>– qui, comme nous l’avons vu pr\u00e9c\u00e9demment, nous indique le type 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>\nComme vous pouvez le voir en ligne, #9<\/code>nous pouvons enfin v\u00e9rifier \u00e0 quel type de widget nous sommes actuellement. Dans le code ci-dessus, je reviens si le type de widget n’est pas un widget de navigation, car notre param\u00e8tre personnalis\u00e9 n’a \u00e9t\u00e9 ajout\u00e9 que pour ces widgets.<\/p>\nR\u00e9cup\u00e9ration des param\u00e8tres de widget enregistr\u00e9s<\/h3>\n
Mais nous devons \u00e9galement r\u00e9cup\u00e9rer les param\u00e8tres enregistr\u00e9s par widget (y compris notre param\u00e8tre personnalis\u00e9). Tous les param\u00e8tres enregistr\u00e9s des widgets sont stock\u00e9s dans la base de donn\u00e9es d’options regroup\u00e9s par type de widget. En utilisant une propri\u00e9t\u00e9 dans le registre des widgets, nous pouvons utiliser [get_option](https:\/\/developer.wordpress.org\/reference\/functions\/get_option\/)()<\/code>pour r\u00e9cup\u00e9rer les param\u00e8tres enregistr\u00e9s pour le type de widget actuel. Le retour sera un tableau index\u00e9 o\u00f9 nous devons utiliser encore un autre param\u00e8tre du filtre pour trouver l’index actuel (car vous pouvez ajouter plusieurs du m\u00eame type de widget dans la m\u00eame barre lat\u00e9rale ou dans des barres lat\u00e9rales diff\u00e9rentes). Il est plus facile de montrer avec du code que de l’expliquer :<\/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>\nEnfin, nous mettons la main sur les param\u00e8tres enregistr\u00e9s du widget\u00a0! Dans l’exemple de code ci-dessus, \u00e0 la ligne #9<\/code>, nous v\u00e9rifions si notre case \u00e0 cocher personnalis\u00e9e est coch\u00e9e ou non.<\/p>\nExemples<\/h3>\n
\u00c0 ce stade, c’est \u00e0 vous de d\u00e9cider ce que vous voulez faire. Vous pouvez par exemple afficher une sortie apr\u00e8s le titre du widget, mais avant le contenu du widget\u00a0:<\/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>\nPour des cas d’utilisation plus r\u00e9els, vous r\u00e9soudrez normalement la plupart en ajoutant certains filtres \u00e0 ce stade, en appelant add_filter()<\/code>\u00e0 ce stade.<\/p>\nVous trouverez ci-dessous un exemple de modification des arguments du menu Navigation en ajoutant un filtre si notre param\u00e8tre a \u00e9t\u00e9 coch\u00e9. S’il n’\u00e9tait pas coch\u00e9, nous nous assurons que le filtre est supprim\u00e9. Le filtre de modification des arguments de rendu d’un menu de navigation est widget_nav_menu_args<\/code>. Dans le code ci-dessous, j’ai d\u00e9fini une fonction \u00e0 appliquer \u00e0 ce filtre qui ajoute un nouvel argument aux arguments du menu\u00a0; un promeneur :<\/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>\nLe code ci-dessus est un exemple de cas d’utilisation o\u00f9 la case \u00e0 cocher personnalis\u00e9e contr\u00f4le s’il faut ou non appliquer un menu walker au menu. Excellent si vous souhaitez que tous les menus s’affichent normalement, mais souhaitez que l’option pour que des widgets de menu sp\u00e9cifiques s’affichent diff\u00e9remment. Ce que le marcheur fait avec la sortie du menu d\u00e9pend de vous.<\/p>\n
Voir ci-dessous le code complet permettant d’ajouter un param\u00e8tre personnalis\u00e9 \u00e0 tous les menus de navigation, de le mettre \u00e0 jour et d’appliquer un explorateur de menu.<\/p>\n
J’esp\u00e8re que cela vous suffira pour comprendre comment coder ce que vous voulez faire. Cela d\u00e9pend vraiment de ce que vous voulez faire et du type de widget avec lequel vous travaillez. Comme mentionn\u00e9 ci-dessus, la plupart des modifications peuvent g\u00e9n\u00e9ralement \u00eatre r\u00e9solues en ajoutant des filtres pour faire votre travail dans dynamic_sidebar_params<\/code>.<\/p>\nExemple complet\u00a0: param\u00e8tre de case \u00e0 cocher personnalis\u00e9 sur les widgets de navigation pour l’application d’un explorateur de menu<\/h2>\n
Voici le code complet pour ajouter une case \u00e0 cocher personnalis\u00e9e \u00e0 tous les widgets de menu de navigation de WordPress pour utiliser un menu walker enregistr\u00e9. (Code marcheur non inclus)<\/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>\nConclusion<\/h2>\n
J’esp\u00e8re que ce message a \u00e9t\u00e9 utile pour r\u00e9soudre vos besoins ou vous donner des indications sur la fa\u00e7on dont vous pouvez faire ce que vous devez faire\u00a0!<\/p>\n
Source d’enregistrement:
awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"Comment ajouter des param\u00e8tres personnalis\u00e9s \u00e0 l’un des widgets standard de WordPress. Avec ces param\u00e8tres, nous apprendrons \u00e0 manipuler le comportement des widgets en cons\u00e9quence.<\/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":[893,893,717,717,832,1110,801,801,832,925,925,841,841,862,862],"tags":[1167],"class_list":["post-234220","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-code-2","category-developpeur","category-guide-pour-les-debutants","category-n-a","category-php-3","category-sujets","category-tutoriels","category-wordpress-3","tag-affiai-fr"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/234220","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/comments?post=234220"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/234220\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media\/223663"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media?parent=234220"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=234220"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=234220"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"Comment](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153158-61e509045fded.png\")
<\/a><\/p>\n