WordPress函数大全详解

温馨提示：本文最后更新于2026年2月21日 00:30，若内容或图片失效，请在下方留言或联系博主。

摘要

WordPress 函数手册是 WordPress 开发者在开发主题和插件时使用的重要参考资料，它详细列出了 WordPress 提供的各类函数，包括核心函数、模板标签、API 函数等。以下是 WordPress 函数手册的主要内容和结构：

一、核心函数

核心函数是 WordPress 内...

一、核心函数

核心函数是 WordPress 内置的函数，用于管理数据库连接、数据查询、用户认证、权限控制等功能。

数据库相关函数
- wpdb 类：用于执行 SQL 查询和操作数据库。
- dbDelta()：用于更新数据库结构。
- get_results()、get_row()、get_var()：用于获取数据库查询结果。
- insert()、update()、delete()：用于操作数据库表。
用户与认证函数
- wp_signon()：处理用户登录。
- wp_set_current_user()：设置当前用户。
- wp_logout()：用户退出登录。
- current_user_can()：检查用户是否具有特定权限。
- is_user_logged_in()：判断用户是否已登录。
选项与设置函数
- get_option()、update_option()、add_option()：用于读取、更新、添加选项。
- delete_option()：删除选项。
- get_site_option()、update_site_option()：用于多站点环境中的全局选项。
文件与路径函数
- ABSPATH：定义 WordPress 安装根目录。
- WP_CONTENT_DIR、WP_CONTENT_URL：定义内容目录路径和 URL。
- plugin_dir_path()、plugins_url()：用于插件目录路径和 URL 处理。
URL 和链接函数
- home_url()、site_url()：获取网站主页和站点 URL。
- bloginfo()：显示博客信息。
- the_permalink()：输出文章的永久链接。
- get_permalink()：获取文章的永久链接。
- add_query_arg()：添加或修改 URL 查询参数。
安全与过滤函数
- esc_attr()、esc_html()、esc_url()：用于转义输出内容，防止 XSS 攻击。
- sanitize_title()：清理标题以适合用作 URL 或 slug。
- wp_kses()：用于清理 HTML 内容，防止恶意代码。
国际化与本地化函数
- __()、_e()：用于翻译字符串。
- esc_html_e()、esc_attr_e()：带转义的翻译输出。
- load_textdomain()：加载语言包。
日志与调试函数
- error_log()：记录错误信息。
- wp_debug_mode()：启用调试模式。
- WP_DEBUG：定义常量以开启调试功能。

二、模板标签（Template Tags）

模板标签是 WordPress 主题中常用的函数，用于在模板文件中输出内容。

文章相关标签
- the_title()、the_content()、the_excerpt()：输出文章标题、内容、摘要。
- the_author()、the_date()、the_time()：输出作者、日期、时间。
- the_category()、the_tags()：输出文章分类、标签。
- comments_template()：包含评论模板。
- post_class()：输出文章的 CSS 类。
循环相关标签
- have_posts()、the_post()：用于文章循环。
- wp_reset_postdata()：重置文章循环。
- rewind_posts()：重新开始文章循环。
导航与菜单标签
- wp_nav_menu()：输出导航菜单。
- wp_list_pages()、wp_list_categories()：列出页面或分类。
- previous_post_link()、next_post_link()：显示上一篇或下一篇链接。
页面与网站信息标签
- bloginfo()：显示博客信息。
- get_bloginfo()：获取博客信息。
- is_home()、is_front_page()：判断是否是首页或博客页面。
- is_single()、is_page()、is_category()：判断当前页面类型。

三、API 函数

WordPress 提供了丰富的 API 用于处理数据、调用外部服务、生成 XML 或 JSON 数据等。

REST API 相关函数
- rest_url()：生成 REST API 的 URL。
- rest_get_server()：获取 REST API 服务器对象。
- register_rest_route()：注册自定义 REST API 端点。
XML-RPC 函数
- xmlrpc_call()：处理 XML-RPC 请求。
- wp_xmlrpc_server()：定义 XML-RPC 服务器类。
JSON 输出函数
- json_encode()：将 PHP 数据转换为 JSON 格式。
- json_decode()：将 JSON 字符串解析为 PHP 数据。

四、其他常用函数

时间和日期函数
- current_time()：获取当前时间。
- date_i18n()：格式化日期，支持多语言。
- get_the_date()、get_the_time()：获取文章的日期和时间。
字符串处理函数
- trim()、strip_tags()、htmlspecialchars()：基本字符串处理函数。
- str_replace()、preg_replace()：用于字符串替换。
数组与对象处理函数
- array_map()、array_filter()：数组处理函数。
- is_array()、is_object()：类型判断函数。
条件判断函数
- is_admin()：判断是否是后台页面。
- is_feed()：判断是否是 RSS 订阅页面。
- is_archive()：判断是否是归档页面。
插件与主题函数
- is_plugin_active()：检查插件是否激活。
- get_template_part()：包含模板部分文件。
- locate_template()：查找模板文件路径。

五、扩展与自定义函数

自定义函数钩子（Hooks）
- add_action()、do_action()：添加和触发动作钩子。
- add_filter()、apply_filters()：添加和应用过滤器钩子。
自定义函数示例
- my_custom_function()：开发者可定义的自定义函数。
- my_init_function()：在 init 钩子中运行的函数。