WordPress 的 add_action() 函数用法详解

add_action() 是 WordPress 中一个非常常用的函数，它用于在 WordPress 执行特定动作时运行自定义函数。

例如，如果你想在 WordPress 加载单个页面时执行某些操作，你可以使用 add_action() 函数将自定义函数与 wp_head 动作钩子关联。当加载单个页面时，WordPress 会在 wp_head 钩子出发时调用你的函数。

语法:

下面是 add_action() 函数的语法：

add_action( $hook, $function_to_add, $priority, $accepted_args );

参数:

• $hook：钩子名称。这是 WordPress 在执行特定动作时触发的名称。
• $function_to_add：要添加到钩子上的函数名称。
• $priority：函数调用的优先级。数字越小，优先级越高。
• $accepted_args：函数接受的参数数量。

示例

下面是一个示例，该示例显示如何使用 add_action() 函数在 WordPress 加载单个页面时执行自定义函数：

function custom_function() {
    // 自定义代码
}
add_action( 'wp_head', 'custom_function' );

在上面的示例中，当 WordPress 加载单个页面时，它会在 wp_head 钩子触发时调用 custom_function 函数。

add_action() 函数应用示例

1. 在 WordPress 后台管理页面底部添加自定义文本：

function custom_admin_footer() {
    echo '<p>感谢使用我们的主题。如果您有任何问题，请联系我们：<a href="mailto:support@example.com">support@example.com</a></p>';
}
add_action( 'admin_footer', 'custom_admin_footer' );

在上面的示例中，当 WordPress 加载后台管理页面时，它会在 admin_footer 钩子触发时调用 custom_admin_footer 函数，并在页面底部显示自定义文本。

2. 在 WordPress 发布文章时发送电子邮件通知：

function send_notification_email( $post_id ) {
    $post = get_post( $post_id );
    $author = get_userdata( $post->post_author );
    $subject = '您的文章已发布：' . $post->post_title;
    $message = '您的文章 ' . $post->post_title . ' 已发布。查看文章：' . get_permalink( $post_id );
    wp_mail( $author->user_email, $subject, $message );
}
add_action( 'publish_post', 'send_notification_email' );

在上面的示例中，当 WordPress 发布文章时，它会在 publish_post 钩子触发时调用 send_notification_email 函数，并向文章作者发送电子邮件通知。

3. 在 WordPress 加载单个页面时注册脚本：

function register_custom_scripts() {
    wp_register_script( 'custom-script', get_template_directory_uri() . '/js/custom-script.js', array( 'jquery' ), '1.0', true );
    wp_enqueue_script( 'custom-script' );
}
add_action( 'wp_enqueue_scripts', 'register_custom_scripts' );

在上面的示例中，当 WordPress 加载单个页面时，它会在 wp_enqueue_scripts 钩子触发时调用 register_custom_scripts 函数，并注册脚本文件 custom-script.js。

其他一些常见的应用示例包括：

• 在 WordPress 发布评论时保存自定义字段：

function save_comment_meta_data( $comment_id ) {
    if ( ( isset( $_POST['email'] ) ) && ( $_POST['email'] != '') ) {
        $email = wp_filter_nohtml_kses($_POST['email']);
        add_comment_meta( $comment_id, 'email', $email );
    }
}
add_action( 'comment_post', 'save_comment_meta_data' );

• 在 WordPress 后台管理页面上添加自定义设置选项：

function custom_settings_init() {
    // 注册设置
    register_setting( 'general', 'custom_setting_name' );
 
    // 添加设置字段
    add_settings_field( 'custom_setting_name', '自定义设置标题', 'custom_setting_callback', 'general' );
}
add_action( 'admin_init', 'custom_settings_init' );

• 在 WordPress 发布文章时自动添加标签：

function auto_add_tags( $post_id ) {
    $tags = array( 'WordPress', '开源' );
    wp_set_post_tags( $post_id, $tags, true );
}
add_action( 'publish_post', 'auto_add_tags' );

总之，add_action() 函数是 WordPress 开发中经常使用的函数，它允许你在 WordPress 执行特定动作时运行自定义函数。