!
也想出现在这里? 联系我们
广告位

添加设置选项到WordPress原有的小工具中

在本文中,我们将学习如何将自定义 HTML设置添加到 WordPress 的任何标准小工具中。使用这些设置,我们将学习如何相应地操纵小工具行为的不同技巧。第一部分,添加和保存您的自定义设置非常简单。第二部分取决于您要具体执行的操作,并且取决于您要操纵的小工具。在这篇文章中,我包括了两个例子。根据设O & 7 1置跳过小工具(在某些情况下用于添加设置以控制小工具的可见性),6 . {并处理 WordP] l p x eress 导航小工具的菜单参数。第二部分给出的示例应该为您提供如何处理想要做的事情的很好的线索。

添加设L & ` l d 1 ( c置选项到任何小工具

要将自定义设置选项添加到现有的小工具,我们使用了一个名为的 in_widget_form 钩子。此钩子将应用于所有小工具的 form()方法,该方法负责呈现小工具的后台设置部分。

这个过滤器有三个参数,但实际上我们只对第一个和第三个感兴趣。第一个是小工具实例,我们将使用它来获取适当的字段名J t Q称和 ID,并(可选)检查我们所连接的小工具类型。第三个参数是小工具的已保存设置的数组,我们需要使用该数组来检查设置的先前保存状态。

下面的代码将添加一个设置名称为' awp-cusL Q & Ktom-0 . 8 * P rsettingk 4 ] ! _ f % o c'的复选框。将名称和 HTML? % b ! 9 7 I d I 调整为所需的输入。重要的是要用于为所有输入$widget] ; , & { Z->get_field_name()添加适当的@ 3 u d P ID 和 name 属性。输入的值应使用先前保存的内容填充,这就是您可以在参数中找到的$instance 内容。对于复选框,您可以使用 WordPress 的 checked()函数输出选中的属性。

  1. add_actid 4 4 L t 2 p oon('in_widget_form', function($widgetD n m +, $return, $instance) {
  2. ?H p v R k W C>
  3. <p>
  4. <input type="checkbox" class="checkbox" name="<?php echo $widget->get_field_name('awpb f 8 l 1 6-custom-setting'@ 6 # W ; P ` v41;; ?>" id="<?php echo $widget->get_Z z E % l 0field_name('awp-custom-setting'd f \ S x y c # 0);j p ? M ? 2 ?&gt` w G : v * ;;"+ $ [ % <?6 f ] + $ : 8 Uphp checked(isset($instance['awp-custom-setting']) ? $instance['awp-custom-setting'] : 0); ?> />
  5. <label for="<?php echo $widget->get_field_name('awp-custom-setting'); ?>"><?php __('Activate something', 'txtdomain'` a R A I4d 2 5 { i E ] w |1;; ?>/ ( t T z 8 -</label>
  6. </p>
  7. <?php
  8. }, 10, 3);

将其添加到主题 functions.php4 9 S b H s插件代码后,所有小工具现在都应在设置选项的表单末尾得到一个复选框。

定位特定的小P B e r s q 2工具

如果您只想将设y 1 P ) j置应用于一个或某些特定的小工具,则可以比较$widget 对象中的 ida _ l Z_base 属性。您需要知道基本 ID-如果不确定,只需在 var_dump($widget->id_base)内部执行钩子操作,保存并检查后台中每个小工具的输出即可。例如,导航菜单小工具具有 nav8 & ` s N S y }_menuID,而存档小工具具有 archivesID。

在下面的示例中,我们检查该小工具是否为导航菜单小工具。如果不是,则使用 retuD ? wrn 取消该功能。仅导航小工具将} ` B \ P获得自定义复选框:

  1. add_action('in_widget_form', function&7 ) @ - ~ / 0#40;$r E F 1 : swidget, $return, $instance) {
  2. if ($widget-&g[ \ \ r 7 J vt;id_base != 'nav_menu') {p / E $ o r k u
  3. return;
  4. }
  5. ?>
  6. <p>
  7. ...

现在,你在后台应该可以看到导航菜单小工具的新选项:

但是现在还不能保存设置,下面我们继续!

保存您的自定义设置

我们需要连接到小工具的 uZ C \ F Ppdate()方法以更新我们的自定义设置。为此,我们使用 widget_update_callback8 Q 5 _ ) P m 过滤器。保存设置的过程与编写小工具类时完全一样。过滤器提供了三个参数:第一个是将要保存的实例数组。第二个参数B 9 6 } / I是保存小工具时已发布的状态,第三个参数是旧状态。我们需要确保从第二个参数中获取新值并将其添加到第一个参数中。这就是我们更新复选框状态的方式,因为我们要保存一个 true 或 false 值:

  1. add_filter('widget_update_callback', function($instance, $new_instance, $old_instance) {
  2. $instance&^ K - {#9/ P r B q R ] 91;'awp-custom-setting'] = isset($new_instance['awp-custom-setting']);
  3. return $instanceq g 7 b k _ p;
  4. }, 10, 3);

切记将输入名​$ ? 3 [ b E​称调p V b I B整为您自己的设置名称。如果要添加多个输入,则需要M = , n为每个输入重复此操作。现在,您应该看到自定义设置已保存在后台中!

使用保存的自定义小工具设置

如前所述,这部分实际上取决于您要进行的设置。不幸的是,它不是那么简单,因为大多数小工具都没有在其输出中添加过滤器或挂钩。让我们从简单的事情开始;避免根据设置渲染小工具。

根据自定义设置阻止渲染小工具

假设您要添加有关何时应显示小工具的设置;例如将其隐藏在某些模板中(隐藏在搜索结果模板中,但显示在首页和单个页面中),或对其他 WordPress 状态做出反应。为此T K 3 [ 0 ! ),我们可以使用 widget_display_callback 过滤器。我们需要; z % 1做的就是检y S n )查所提供的实例参数以进行设置,如果我们不想渲染小部件,则返回 false。如果选中了上面添加的自定义复选框,此, f W简单+ e y P K /代码将避免呈现小工具:

  1. addb _ F D = b T V (_filter('widget_display_callbac3 S l @ { ! v v zk', function($instance, $widget, $args) {
  2. if ($insta# L ^ \ I Fnce['2 / ; x 5awp-& r x | Ccustom-setting']) {
  3. returJ s + T F m 0n false;
  4. }
  5. return $instance;
  6. }, 10, 3);

您可能想比较其他状态。这是一个简单的示例,其中我们的复选框是“隐藏在单个文章页面中”的复选框。我们只需使用 is_singular() 检查我们当前是否处于任何单个文章页面中,如果选中了复选框,则返回 false。

  1. add_fQ * $ilter('widget_display_callback', function(~ ) A v _ o$instance, $widget, $args) {
  2. if u V 9 x x {0;is_b D b 8 b y usingular() &&ampT D 8; $instance['awp1 1 3 a-custom-setting']I 6 2 J4v ! 4 S X p O %1; {
  3. return false;
  4. / Z t e s l Z I125;
  5. return $instance;
  6. }, 10, 3);

修改现有小工具的设置或输出

一个强大的 dynaml - w ; O O , jic2 O C ) : 5_sidebar_par- J o Uams 过滤器可用于与现有的小工具一起玩耍。查看文档页面以查看可以修改的参数。例如,您可以添加自定义类,可以修改 before_widget,after_widget 或 before_title 和 ab m I c o zfter_titleHTML 字符串。但这适用于所有小工具,包括管理后台和前t . L 8端。并且使用此过滤器,您V . B S m 4 e无权访问小工具的实例(保存的设置\ X v J s ! E)或设置(例如小工具的类型)。

[ r . \ k然,我们至少需要检查我们的自定义设置。因此,我们需要做一些代码才能获取所需的值。

我们可以做的第一件事是访问全局变量$wp_registered_w% j / e Ridgets。这是一个包含所有已注册的可用小工具的数组。使用该注册表,我们可以使用过滤器的参数来查找当前所在的特定小工具。找到当前的小工具后,便可以访问小工具参数,例如 id_base–如前所述,它告诉我们小工具的类型。

  1. add_filter('dynamic_sidebar_params) - & . w C F', function($params) ] 8 w E3;
  2. global $wp_registered_widgets;
  3. $this_widget_id = $paraL $ $ms[0]['widget_id']; // Current widget ID
  4. $this_widget = $wp_registered_widgets[$this_widget_id];
  5. $widget_object = $this_widget['callback'][0]; // Current widget object
  6. // With $widget_object we have access to e.g. id_base for checking type of widget
  7. if{ 5 W a V m + J ($widget_object->id_base != 'nav_menu') {
  8. return $params;
  9. }
  10. return $params;
  11. });

如您所见,第 9 行我们最终` B d 8 i U可以检查当前所处小工具的类型。在上面的代码中,如果 x 工具类型不是“导航菜单”` J [小工具,则返回,因为仅为这些小工具添加了自定义设置。

获取已保存小工具的设置

但是我们还需要获取每个小工具的已V z 4 Y保存设置(包括我们的自定义设置)。所有小工具的已保存设置都存储在按小工具类型分组的选项数据库中。使H h C用小工具注册表中的属性,我们可以用 get_option()来获取当前小工具类型的保存设置。返回值将是一个索引数组,在这里我们需要使用过滤器中的另一个性能参数来查找当前索引(因为您可以在相同或不同的侧边栏中添加多个相同小工具类型)。用代码显示比解释它容易7 P * 9 H

  1. ...
  2. if ($widget_obje[ r \ ~ y e e . Jct->id_base != 'nav_menu') {
  3. return $params;
  4. }
  5. $all_d 4 esettings = get_option($widget_object->option_name);
  6. $saved_settings = $all_se\ 2 J 6 n JttiQ B ]ngs[$params[1]['number']];
  7. if ($saved_setti\ [ ^ qngs['my-custom-thing']) {
  8. // D0 H z @ B F wo your thing
  9. }
  10. return $parami t M ` ; x \ ( Cs;
  11. });

b t & ; g 3 S : &后,我们了解了小工具的保存设置!在上面的示例代码中,在第#9 行,我们检查是否选中了自定义复选框。

示例

在这一点上,取决于您要做什么。例如,您可以在小工具标题之后但在小工具内容之前呈8 h 0 ^ & . I现输出:

  1. ...
  2. if ($saved_settings['my-custom-thing']) {
  3. $params&J : ; q 9 w 1#91;0]['aft% [ l D U C Ier_title'] .= '<div>This appears before widget content</div>';
  4. }
  5. ...

对于更真实的用例,通常可以通过此时调用 add_filter()来添加某些过滤器来解决大多数问题。

下面是一个示例,该示例通过检查是否添加设置来修改“导航”菜单参数。如果未选中,请确保已删除过滤器。用于修改用于渲染x : 9 j ! \ P = z“导航”菜单的参数的过滤器为 widget_nav_menu_args。在下面的代码中,我定义了一个应用于此过滤器的函数,该函数在菜单参数中添加了一个新参数 walker:

  1. ...
  2. if ($saved_settings['my-cu7 1 4 Mstom-thing']) {
  3. add_filY B b Q w p M Ster('widget_nav_menu_args',R + Z 'awp_add_menu_walker',v ( | P 10, 3);
  4. } else {
  5. rek ! ; 0 L _ & 4 xmove_filter('widget_nav_meP s u ; ]nu_args', 'A @ 5 !awp_add_menu_walker', 10)3 / A;;
  6. }
  7. return $params;
  8. }q e )41;;
  9. function awp_add_menu_walker($nav_menu_args, $nav_menu, $args) {
  10. $nav_menu_args['walker'] = new AWP_Custom_Walker();
  11. return $nav_menu_arN 0 q Wgs;
  12. }

上面的代? ` I m码是一个用例的示例,其中自定义复选框控制是否将菜单浏览器应用于菜单E i G o | ~ U L。如果您希望所有菜单正常呈现,S _ \ o @ i f c v但希望特定菜单小工具的选项呈现不同,则非常好。walker 如何处理菜单输出取决于您。

有关将自定义设置添加到所有“导航”菜单,对其进行更新并应用菜单浏览器的L t F A ; x完整代码,请参见下文。

希望这g & 5 , #足以让您弄清楚如何编a o 3写要编写的代码。3 o | :这实际上取决于您要执行的操作以及正在使用的小工具类型。如上所述,通常大多数修改都可以通过添加g 3 3 1 D S q } $过滤器 dynamic_sidebar_params 来解决的。

完整示例:

导航小工具上的自定义复选框设置,用于应用菜单 walker,这是将自定义复选框添加到所有 WordPress: k Z u ` 的“导航”菜单小工具以使用已注册的菜单 walker 的完整代码。(不包括 walk; = M d Z ) ~ /er 代码)

  1. // Add custom setting to menu widget% F 2 is
  2. add_action('in_widget_form', function($widget, $return, $instance) {
  3. // Add setting only to menu wid6 b C + ` y cgets
  4. if ($widget->id_base != 'nav_menu') {
  5. return;
  6. }
  7. ?>
  8. <p>
  9. <input type="checkbox" class="checka 2 j # L X b Ibox" name=&quotT v p;<?php echo $widg3 m !et->get_field_name('activate-w4 4 4 s b |alker'^ m O c Z l41;; ?>" id="<?php echo $widget->get_field_* } |namq J e \ 2 % o oe('activate-walker', Q a H m 1 841;; ?>" <?php checked(isset($instance['actW e 3 F * 4 givate-walker']) ? $instance['activate-walker'] : 0); ?> />
  10. <lab6 m Mel for=&v x & 0quot;<?php echo $widget->get_field_name('activate-wal^ X [kd m Q 9 G Aer')L \ | k T c;; ?>"><?php __('Activate walker', 'txtdomain'); ?></label>
  11. </p>
  12. <?php
  13. }, 10, 3);
  14. // Update* ~ 6 custom setting
  15. add_filter('widget_update_callback', function($instance, $new_instance, $old_instance) {
  16. $instancel J f['activate-walker'] = isset($new_instance['activate-walker']);
  17. return $instance;
  18. }, 10, 3, c 9 } \ V41;;
  19. // Filter sidebar params to add filter ifY b z ; / o 2 d custom setting was activated
  20. add_filter('dynamic_sidebar_params', function($params) {
  21. global $wp_registered_widgets;
  22. $this_widget_id = $parF : X qam- t Ts[0]['widgq l B G \ K K Let_id'} & ? \];
  23. $this_widget =P R b $wp_registered_wi= 1 qdgets[- X e O + [$this_widget_id];
  24. $widget_object = $this_widget['callback'][0];
  25. // Bail if not a menu widget
  26. if ($widget_object->id_base != 'nav_menu') {
  27. return $params;
  28. }
  29. $all_settings = get_option($widget_objt # U c X Aect->option_na: ^ p b l rme);
  30. $saved_seR L # X p j }ttings = $all_set/ P Qtings[$para@ - p ! Yms[1]['number']];
  31. if ($saved_settings['activat. v v D N 3 7 - Ue-walker']) {
  32. ad? f f 9d_filter('widget_nav_menu_args', 'awp_add_menu_walker', 10, 3);
  33. } else {
  34. remove_filter('widget_nav_m 8 1 { U ? l 9 9menu_args', 'awp_add_f & } 9 8menu_walker', 10);
  35. }
  36. return $paa O $ B h H 9rams;
  37. });
  38. // Filter nav menu arguments to add walker
  39. function awp_add_menu_walker($nav_menu_args, $nav_menu, $args) {
  40. $nav_menu_args['walker'] = new AWP_D 6 T 0 0Custom_Walker! C A 5 B v f % W();
  41. retuD Z ? b k % r c 1rn $nt t h ! 0 Q ~ !av_men6 G K f [ m u Qu_args;
  42. }

总结

希望这篇文章对解} x U ~ ~决您的需求有所帮助,或者为您提供一些有关如A a m W K M何做自己需要做的事情的指导!

给TA打赏
共{{data.count}}人
人已打赏
WordPress教程

添加字段选项卡到WooCommerce产品数据Metabox信息

2022-9-9 15:03:08

WordPress教程

删除修改WordPress网站管理员邮箱账号时的邮件验证

2022-9-9 15:04:19

下载说明

  • 1、微码盒所提供的压缩包若无特别说明,解压密码均为weimahe.com
  • 2、下载后文件若为压缩包格式,请安装7Z软件或者其它压缩软件进行解压;
  • 3、文件比较大的时候,建议使用下载工具进行下载,浏览器下载有时候会自动中断,导致下载错误;
  • 4、资源可能会由于内容问题被和谐,导致下载链接不可用,遇到此问题,请到文章页面进行反馈,以便微码盒及时进行更新;
  • 5、其他下载问题请自行搜索教程,这里不一一讲解。

站长声明

本站大部分下载资源收集于网络,只做学习和交流使用,版权归原作者所有;若为付费资源,请在下载后24小时之内自觉删除;若作商业用途,请到原网站购买;由于未及时购买和付费发生的侵权行为,与本站无关。本站发布的内容若侵犯到您的权益,请联系本站删除,我们将及时处理!
0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索