wordpress常用api

K-seo • 2024-01-23 01:45 • 技术教程 • 阅读 180

WordPress Settings API 是一个强大的工具，它允许开发者在 WordPress 中创建和管理自定义设置，在上一篇文章《WordPress Settings API 指南：验证、过滤和输入（一）》中，我们介绍了如何使用 Settings API 创建自定义设置页面，以及如何将设置保存到数据库，本文将继续深入探讨 Settings API，重点关注验证、过滤和输入的处理。

1. 验证设置

验证是确保用户输入的数据符合预期格式和范围的过程，在 WordPress Settings API 中，我们可以使用 sanitize_callback 参数为每个设置指定一个验证回调函数，这个回调函数应该接受一个参数（用户输入的值），并返回一个经过验证的值，如果回调函数返回 false，则表示验证失败，WordPress 将显示一个错误消息。

以下是一个使用 sanitize_callback 参数的示例：

register_setting( 'my-settings-group', 'my_setting' );
$args = array(
    'type'              => 'string',
    'capability'        => 'manage_options',
    'sanitize_callback' => 'my_sanitize_callback',
);
register_setting( 'my-settings-group', 'my_setting', $args );

在这个示例中，我们为名为 my_setting 的设置指定了一个名为 my_sanitize_callback 的验证回调函数，当用户尝试保存设置时，WordPress 将调用此回调函数来验证用户输入的值。

2. 过滤设置

过滤是修改用户输入数据的过程，以便在保存到数据库之前对其进行处理，在 WordPress Settings API 中，我们可以使用 sanitize_callback 参数为每个设置指定一个过滤回调函数，这个回调函数应该接受两个参数（用户输入的值和默认值），并返回一个经过过滤的值，如果回调函数返回 false，则表示过滤失败，WordPress 将显示一个错误消息。

以下是一个使用 sanitize_callback 参数的示例：

register_setting( 'my-settings-group', 'my_setting' );
$args = array(
    'type'              => 'string',
    'capability'        => 'manage_options',
    'sanitize_callback' => 'my_sanitize_callback',
);
register_setting( 'my-settings-group', 'my_setting', $args );

在这个示例中，我们为名为 my_setting 的设置指定了一个名为 my_sanitize_callback 的过滤回调函数，当用户尝试保存设置时，WordPress 将调用此回调函数来过滤用户输入的值。

3. 输入处理

在 WordPress Settings API 中，我们可以使用 input_callback 参数为每个设置指定一个输入回调函数，这个回调函数应该接受一个参数（用户输入的值），并返回一个经过处理的值，如果回调函数返回 false，则表示输入处理失败，WordPress 将显示一个错误消息。

以下是一个使用 input_callback 参数的示例：

register_setting( 'my-settings-group', 'my_setting' );
$args = array(
    'type'              => 'string',
    'capability'        => 'manage_options',
    'sanitize_callback' => 'my_sanitize_callback',
    'input_callback'    => 'my_input_callback',
);
register_setting( 'my-settings-group', 'my_setting', $args );

在这个示例中，我们为名为 my_setting 的设置指定了一个名为 my_input_callback 的输入回调函数，当用户尝试保存设置时，WordPress 将调用此回调函数来处理用户输入的值。