WordPress中文开发手册

WordPress插件开发 — 使用用户元数据

WordPress用户表包含一个非常少量的有关用户的信息,并且不能容纳更多。 因为这个原因有一个usermeta表。 默认情况下,它包含名字,姓氏,昵称等等。任何东西都可以放在那里,它只是通过user_id相关。

管理用户元数据有两种不同的主要场景。 一个是通过用户个人资料页面上的自定义表单字段,另一个是以编程方式具有正确的功能。

##创建表单

如果您只想为站点用户提供一个UI来更新特定的元选项,则可以使用下面的代码。

add_action( 'show_user_profile', 'my_show_extra_profile_fields' );
add_action( 'edit_user_profile', 'my_show_extra_profile_fields' );
 
function my_show_extra_profile_fields( $user ) { ?>
 
    <h3>Extra profile information</h3>
 
    <table class="form-table">
 
        <tr>
            <th><label for="twitter">Twitter</label></th>
 
            <td>
                <input type="text" name="twitter" id="twitter" value="<?php echo esc_attr( get_the_author_meta( 'twitter', $user->ID ) ); ?>" class="regular-text" /><br />
                <span class="description">Please enter your Twitter username.</span>
            </td>
        </tr>
 
    </table>
<?php }

注意有两个动作标签。 show_user_profile用于显示您自己的个人资料中的表单,edit_user_profile用于显示其他人的表单。

上述代码将在配置文件页面上渲染一个html块,如下所示:

  • 显示其他字段的HTML块。
  • 其他配置文件字段

##保存数据

只需使表单不会使数据保存。 为此,您应该使用以下代码:

add_action( 'personal_options_update', 'my_save_extra_profile_fields' );
add_action( 'edit_user_profile_update', 'my_save_extra_profile_fields' );
 
function my_save_extra_profile_fields( $user_id ) {
 
    if ( !current_user_can( 'edit_user', $user_id ) )
        return false;
 
    /* Copy and paste this line for additional fields. Make sure to change 'twitter' to the field ID. */
    update_usermeta( absint( $user_id ), 'twitter', wp_kses_post( $_POST['twitter'] ) );
}

请注意,即使有可能以前不存在该值,也会使用update_usermeta。 没关系,如果不存在就会创建。

还要注意两个add_action函数。 与上述类似,其中一个适用于您自己的个人资料页面,另一个适用于所有人。

上面的大部分文字都是由贾斯汀·塔德洛克(Justin Tadlock)发表的。

##以编程方式添加用户元

以编程方式添加用户元数据有两种方法。 add_user_meta()update_user_meta()

add_user_meta

<?php add_user_meta( $user_id, $meta_key, $meta_value, $unique ); ?>

获取和渲染用户元

获取用户元数据可以一次完成,并且可以返回所有值的数组,也可以一次获得单个值。 这是功能:

<?php get_user_meta($user_id, $key, $single);  ?>

如果你只是传递一个user_id,你会得到一个数组中的所有选项。

如果你传递一个user_id和key,那么你将得到一个数组中该键的值。

如果你传递全部,并且单个是真的,那么你将获得字符串或int的值,除非存储的值本身是一个数组或对象。

在这一点上,您可以根据需要打印。

Tags ,