当前浏览:首页 / WordPress函数 / do_settings_fields()

do_settings_fields( string $page, string $section )

打印特定设置栏的设置字段

field 字段more...

settings 设置more...


描述

这是设置API的一部分。在设置页面中使用此函数可输出特定设置栏。通常应由do_settings_sections()调用,而不是直接调用。


参数

$page

(string)(必填) 要显示其设置字段的管理页面的slug标题。

$section

(string)(必填) 要显示其字段的设置栏的slug标题。



源码

查看源码 官方文档


更新日志

版本描述
2.7.0开始引入

使用示例

  • 示例1

    要在自定义页面设置中加载多个选项卡,您需要使用此函数。

    例如,如果我希望有这些设置页面:

    • /options-general.php?page=stripe-payment – 默认页面
    • /options-general.php?page=stripe-payment&action=test – 测试页面

    因此,您必须有两个不同的设置栏,并将其命名为:

    if ($_GET['action'] !== 'test') {
      settings_fields('stripe_payment_settings');
      echo '<table class="form-table">'; // Must to add this wrapper to keep it like WordPress default UI
      do_settings_fields('stripe-payment, 'stripe_payment_settings_section');
      echo '</table>';
    } else {
      settings_fields('stripe_payment_test');
      echo '<table class="form-table">';
      do_settings_fields('stripe-payment, 'stripe_payment_test_section');
      echo '</table>';
    }