WordPress Settings API 是一个强大的工具，它允许开发者创建自定义的 WordPress 设置页面，这些设置页面可以用来控制各种 WordPress 功能，包括主题设置、插件设置、用户设置等等，在本文中，我们将详细介绍如何使用 WordPress Settings API 来创建一个菜单页面。
1. 创建一个新的设置页面
我们需要创建一个新的设置页面，这可以通过使用 add_options_page() 函数来实现，这个函数需要两个参数：一个是页面的标题，另一个是回调函数，这个函数将在用户访问这个页面时被调用。
我们可以创建一个名为 "Menu Settings" 的设置页面，当用户访问这个页面时，将调用 menu_settings_page() 函数：
function menu_settings_page() {
// 在这里编写你的代码
}
add_options_page(
'Menu Settings', // 页面标题
'Menu Settings', // 菜单标题
'manage_options', // 用户角色
'menu-settings', // 选项页别名
menu_settings_page // 回调函数
);
2. 在回调函数中添加表单元素
在 menu_settings_page() 函数中，我们需要添加一些表单元素，以便用户可以输入他们的设置，这可以通过使用 add_settings_field() 函数来实现，这个函数需要三个参数：一个是字段的 ID，一个是字段的标签，另一个是回调函数，这个函数将在渲染这个字段时被调用。
我们可以添加一个名为 "Menu Name" 的文本字段，当用户访问这个页面时，将调用 menu_name_field() 函数：
function menu_name_field() {
echo '<input type="text" id="menu-name" name="menu-name">';
}
add_settings_field(
'menu-name', // 字段 ID
'Menu Name', // 字段标签
menu_name_field, // 回调函数
'menu-settings', // 选项页别名
[
'label-for' => 'menu-name', // 关联到哪个字段 ID
]
);
3. 处理表单提交
我们需要处理用户的表单提交，这可以通过使用 register_setting() 函数来实现，这个函数需要两个参数：一个是选项页的别名，另一个是数组，这个数组包含了所有需要保存的字段 ID。
我们可以注册 "menu-settings" 选项页中的 "menu-name" 字段：
function register_menu_settings() {
register_setting(
'menu-settings', // 选项页别名
'menu-name' // 字段 ID
);
}
add_action('admin_init', register_menu_settings);
在 menu_settings_page() 函数中，我们需要检查是否有表单提交，如果有，我们需要获取用户的设置，并将它们保存到数据库中：
function menu_settings_page() {
if (isset($_POST['submit'])) { // 检查是否有表单提交
$menu_name = esc_attr($_POST['menu-name']); // 获取用户的设置
update_option('menu-name', $menu_name); // 将设置保存到数据库中
} else { // 如果没有任何表单提交，显示表单元素
echo '<form method="post">';
add_settings_field(
'menu-name', // 字段 ID
'Menu Name', // 字段标签
menu_name_field, // 回调函数
'menu-settings', // 选项页别名
[
'label-for' => 'menu-name', // 关联到哪个字段 ID
]
);
echo '<input type="hidden" name="submit">'; // 隐藏提交按钮，因为我们将使用 JavaScript 来提交表单
echo '</form>';
}
}
相关问题与解答：
1、问题：我可以在 WordPress Settings API 中使用哪些表单元素？答案：WordPress Settings API 支持多种表单元素，包括文本框、复选框、单选按钮、下拉列表、密码框等，你可以使用 add_settings_field() 函数来添加这些元素，这个函数的第一个参数是字段的 ID，第二个参数是字段的标签，第三个参数是回调函数，这个函数将在渲染这个字段时被调用，在这个回调函数中，你可以输出任何你想要的 HTML，你可以输出一个文本框和一个按钮：echo '<html><body><input type="text" id="my-textbox"><button type="button">Submit</button></body></html>';，你可以在 register_setting() 函数中使用这个字段的 ID，以便将用户的设置保存到数据库中。register_setting('my-options', 'my-textbox');，你可以在 sanitize_callback 参数中指定一个回调函数，这个函数将在保存用户的设置之前被调用，在这个回调函数中，你可以对用户的输入进行清理和验证。register_setting('my-options', 'my-textbox', 'sanitize_callback');，在这个例子中，你需要定义一个名为 sanitize_callback 的函数，并在其中对用户的输入进行清理和验证。function sanitize_callback($input) { return stripslashes($input); }。
原创文章，作者：K-seo，如若转载，请注明出处：https://www.kdun.cn/ask/246976.html
微信扫一扫 