WordPress同时保存多个设置部分

Question

我已经为 WordPress 插件创建了一个设置页面。

然后我为同一页面创建了两个设置部分:

add_plugins_page(
    __('API Settings', 'api'),
    __('API Settings', 'api'),
    'administrator',
    'api',
    array('API', 'settings_display')
);

// add general settings section
add_settings_section(
    'api_general',
    __('General Settings', 'api'),
    array('API', 'section_callback'),
    'api'
);

// add page section
add_settings_section(
    'api_pages',
    __('Set API pages', 'api'),
    array('API', 'section_callback'),
    'apis'
);

然后使用 add_settings_field() 将各种字段添加到不同的部分。

处理页面渲染的函数如下所示:

<!-- Create a header in the default WordPress 'wrap' container -->
<div class="wrap">
    <!-- Add the icon to the page -->
    <?php screen_icon(); ?>
    <h2><?php _e('API Settings', 'api'); ?></h2>
    <!-- Make a call to the WordPress function for rendering errors when settings are saved. -->
    <?php settings_errors(); ?>
    <!-- Create the form that will be used to render our options -->
    <form method="post" action="options.php">
        <?php settings_fields('api_pages'); ?>
        <?php settings_fields('api_general'); ?>
        <?php do_settings_sections('api'); ?>
        <?php submit_button(); ?>
    </form>
</div><!-- /.wrap -->

当我尝试保存页面设置时，它只会保存 api_general 设置。

我发现 settings_fields() 实际上仅用于输出特定部分的 nonce、action 和 option_page 字段。因此，当我为两个不同的部分调用它时，一个部分的输出基本上会忽略前一部分。

我做了一些研究并查看了教程，但我还没有找到一个显示必须同时保存多个部分的教程。但由于 do_settings_sections() 输出页面的所有部分，因此必须有一种方法可以同时保存所有部分。

我唯一的其他办法是将所有字段合并到同一部分或创建单独的页面，如果可能的话，我希望避免这样做。

Answer 1

也许这会有所帮助......根据此法典:settings_fields

settings_fields 函数的第一个参数应该是在 register_setting 中声明的设置组。

但看起来您正在使用设置部分的名称，所以我什至不确定它是如何工作的。

页面上可以有两个或多个部分，但所有设置(即选项)，无论它们位于哪个部分，都必须属于表单中同一设置组的一部分。组(单数)的隐藏字段通过神奇的“settings_field”函数插入到表单的顶部。

但是，您也可以在一页上有多个表单，每个表单都有自己的提交按钮和settings_fields('optiongroup')，但我个人认为一页上的多个提交按钮会让用户感到非常困惑。

据我了解，限制因素是以下之间存在 1 对 1 对 1 的对应关系:

• 页面上的表单
• 该表单中的提交按钮
• 该表单中的设置字段

settings_fields() 确定将在幕后保存的内容。使用一系列选项比使用单个选项更有效。我还没有尝试过这一点，但为了从逻辑上分解表单上的各个部分，将一组选项与每个设置部分相关联是有意义的。然后每个部分 (n) 将有自己的 get_options('section-(n)') 来获取其所有字段的值数组。但是(存在过度重复的风险)，当为每一页上的一个表单按下一个提交按钮时，包含每个部分中所有字段值的每个选项数组都会立即保存。

哇! :-)