WordPress 常用函数中文翻译

WordPress为我们提供了丰富的函数,方便我们对WordPress进行定制,开发WordPress主题或插件,我们会在这里把经常使用的函数文档翻译成中文,加上使用总结和代码示例,方便后续查阅。

get_userdata 获取用户数据

函数描述 获取某个用户的用户数据,数据形式为一个 WP_User 对象,我们可以通过 "->" 操作符直接获取 wp_users 和 wp_usermeta 数据表里面的信息。 如果用户不存在,返回 false,该函数的一个别名是: get_use…

get_post_type_archive_link 获取文章类型存档的固定链接

 函数描述 获取自定义文章类型存档页面的自定义链接。  使用方法 get_post_type_archive_link( $post_type ); 参数 参数数据类型是否必需描述默认值$post_type字符串是自定义文章类型名称无 返回值 (m…

get_author_posts_url 通过指定ID获取作者页面的URL

函数描述 通过指定 ID 获取作者存档页面的 URL。我们可以通过此函数获取作者发表的所有文章的存档页面URL。 使用方法 get_author_posts_url( $author_id, $author_nicename ); 参数 参数数据类型是否必需描述默认值$aut…

wp_list_authors 列出网站所有作者及他们发布的文章数量

函数描述 显示网站所有的作者(用户)列表,如果某作者发表了文章,作者的名称会加上链接到他们发表的文章的存档页的链接,该函数还可以显示作者所发表的文章数量和该作者所发表文章的RSS链接。 使用方法 <?php wp_list_au…

wp_dropdown_users 创建用户下拉选择表单

函数描述 创建用户下拉选择菜单 HTML 元素。 使用方法 <?php wp_dropdown_users( $args ); ?> 默认使用 $args = [ 'show_option_all' => null, // string 'show_option_none' => null, // st…

wp_trash_post 删除文章到回收站

描述描述 移动一个文章或页面到回收站,如果禁用了回收站,文章或页面将被永久删除。 使用方法 <?php wp_trash_post( $post_id  ); ?> 参数 参数数据类型是否必需描述默认值$post_id整数否文章ID0 返回值 (mix…

wp_update_post 更新数据库中的文章、页面或自定义文章类型

函数描述 此函数的作用是更新数据库中的文章(或页面或其他自定义文章类型),该函数需要传入一个数据库中存在的文章 ID 才能正常工作。 需要注意的是,文章更新时,现有文件将被复制一个文章版本,文章内容将会被新值替代,文章…

wp_insert_post 插入文章到数据库-做投稿或者前端表单时使用

函数描述 此函数的作用是插入文章(或页面、自定义文章类型)到数据库,插入之前,会净化一些变量,做一些检查,补全一些缺失的必需数据(如日期/时间)。此函数需要一个数组作为参数,插入成功后,返回插入文章的 ID(插入失败返回…

wp_delete_post 删除文章或页面

函数描述 永久删除回收站中的文章、附件或页面。当一篇文章被删除时,关联到这篇文章的所有内容将同时被删除,包括评论、自定义字段和文章到分类项目之前的关联。 使用方法 <?php wp_delete_post( $postid, $force_delete …