在WordPress作者页面添加自定义文本字段及WYSIWYG编辑器的方法
霞舞
发布时间：2025-10-24 09:41:00
|
860人浏览过
|
来源于php中文网
原创
本教程详细介绍了如何在WordPress作者页面和用户资料中添加自定义文本字段，并支持WYSIWYG编辑器。文章提供了两种实现方案：通过`user_contactmethods`钩子进行代码定制，以及利用Advanced Custom Fields (ACF)插件实现无代码配置，帮助用户灵活扩展WordPress功能。
在WordPress中，有时我们需要在用户的个人资料页面（即后台的用户编辑页面）添加额外的信息字段，并将其展示在前端的作者页面上。这对于丰富用户简介、展示特定联系方式或个人描述等场景非常有用。本文将详细介绍两种实现此功能的方法：一种是使用WordPress的内置钩子进行代码定制，另一种是利用功能强大的Advanced Custom Fields (ACF)插件实现。
方法一：通过代码实现自定义用户联系方式字段
WordPress提供了一个名为user_contactmethods的过滤器钩子，允许开发者向用户的联系方式字段中添加自定义选项。这种方法适用于添加简单的文本字段，例如电话号码、城市或自定义描述等。
1. 添加自定义字段到用户资料页
您可以通过将以下代码添加到当前主题的functions.php文件或自定义插件中，来扩展用户的联系方式字段。
代码解释：
- my_custom_user_contact_methods 函数接收一个包含现有联系方式字段的数组 $profile_fields。
- 通过 $profile_fields['字段名'] = '字段显示名称'; 的形式，您可以添加任意数量的自定义字段。
- add_filter('user_contactmethods', 'my_custom_user_contact_methods'); 将您的函数挂载到 user_contactmethods 钩子上，使其在WordPress加载用户资料页面时生效。
添加此代码后，当您登录WordPress后台并编辑任一用户资料时，会在“联系信息”部分看到您添加的自定义字段，如“自定义描述”、“联系电话”等。
2. 在作者页面显示自定义字段
要在前端的作者页面（通常是author.php模板文件）显示这些自定义字段，您需要使用get_the_author_meta()函数来获取存储的值。
';
echo '作者描述
';
echo '' . esc_html($custom_description) . '
'; // 使用 esc_html 进行安全输出
echo ' ';
}
// 获取联系电话
$user_phone = get_the_author_meta('user_phone_number', $author_id);
if (!empty($user_phone)) {
echo '
';
echo '电话: ' . esc_html($user_phone) . '';
echo '
';
}
// 获取个人网站
$user_website = get_the_author_meta('user_website_url', $author_id);
if (!empty($user_website)) {
echo '
';
}
?>
注意事项：
文心快码
文心快码（Comate）是百度推出的一款AI辅助编程工具
下载
- 这种方法添加的字段默认是普通的文本输入框，不具备WYSIWYG（所见即所得）编辑器的功能。
- 对于需要复杂格式编辑的字段，代码实现会比较复杂，需要自行集成TinyMCE或其他编辑器。
方法二：使用Advanced Custom Fields (ACF) 插件实现高级自定义字段
对于需要WYSIWYG编辑器或其他更复杂字段类型（如图片、文件、选择框等）的需求，使用Advanced Custom Fields (ACF) 插件是更高效、更灵活的选择。ACF提供了一个直观的用户界面来创建和管理自定义字段，无需编写任何PHP代码即可在后台配置。
1. 安装并激活ACF插件
- 登录WordPress后台。
- 导航到“插件” -> “安装插件”。
- 搜索“Advanced Custom Fields”，找到后点击“立即安装”，然后“启用”。
2. 创建自定义字段组
安装并激活ACF后，您可以开始创建自定义字段：
- 在WordPress后台左侧菜单中，您会看到一个新的“自定义字段”选项。
- 点击“自定义字段” -> “字段组” -> “添加新字段组”。
- 给字段组一个名称，例如“作者附加信息”。
- 点击“添加字段”按钮，为您的自定义信息创建字段：
-
字段标签 (Field Label): 例如“作者简介”。
-
字段名称 (Field Name): 例如author_bio_wysiwyg（系统会自动生成，您也可以修改）。
-
字段类型 (Field Type): 选择“WYSIWYG 编辑器”。
- 您可以根据需要添加其他字段，例如“社交媒体链接”（类型可选“URL”）、“座右铭”（类型可选“文本”或“文本区域”）。
-
设置显示规则 (Location Rules): 这是关键一步。在“位置”部分，将规则设置为“用户表单 == 所有”。这将确保这些字段显示在所有用户的个人资料编辑页面。
- 点击“发布”保存字段组。
现在，当您编辑任何用户资料时，会看到一个名为“作者附加信息”的新区域，其中包含您创建的自定义字段，包括带有WYSIWYG编辑器的“作者简介”。
3. 在作者页面显示ACF自定义字段
要在前端的作者页面显示ACF字段，您需要使用ACF提供的the_field()或get_field()函数。
';
echo '作者简介
';
the_field('author_bio_wysiwyg', 'user_' . $author_id); // 'user_' . $author_id 是ACF获取用户字段的特定格式
echo ' ';
}
// 获取其他文本字段，例如“座右铭”
if (function_exists('get_field')) {
$motto = get_field('author_motto_text', 'user_' . $author_id);
if (!empty($motto)) {
echo '
