本教程详细介绍了如何在wordpress作者页面添加自定义文本字段，并使其可在用户个人资料中进行编辑。文章提供了两种实现方案：一是通过`user_contactmethods`钩子进行代码扩展，实现基础文本字段的添加；二是通过使用advanced custom fields (acf)插件，实现包含wysiwyg编辑器的更高级自定义字段，为非开发者提供了便捷的解决方案。
在WordPress中，有时我们需要在用户个人资料页面（进而影响作者页面显示）添加额外的自定义信息字段，例如用户的性别、电话号码、城市或一个包含富文本内容的简介。本文将详细介绍两种实现这一需求的方法：通过代码钩子和使用专业的插件。
一、使用代码扩展用户联系方式
WordPress提供了一个名为user_contactmethods的过滤器钩子，允许开发者向用户个人资料页面的“联系信息”部分添加自定义字段。这种方法适用于添加简单的文本输入字段。
1. 实现原理
user_contactmethods钩子接收一个包含现有联系方式字段的数组，我们可以通过修改这个数组来添加新的字段。每个字段由一个键（用于存储数据）和一个值（在后台显示的标签）组成。
2. 示例代码
将以下代码添加到您的主题的functions.php文件或一个自定义插件中：
3. 代码解释
- if (!function_exists('modify_contact_methods')): 这是一个良好的编程习惯，用于检查函数是否已经存在，以避免在多个地方定义同名函数时引发致命错误。
- function modify_contact_methods($profile_fields): 定义了一个函数，它接收一个名为$profile_fields的数组，该数组包含了WordPress默认的用户联系方式字段（如IM、Twitter等）。
- $profile_fields['user_gender'] = '性别';: 这行代码向$profile_fields数组添加了一个新元素。'user_gender'是这个自定义字段的元数据键（meta key），它将被用于在数据库中存储用户输入的值。'性别'是这个字段在用户个人资料编辑页面显示的标签。
- return $profile_fields;: 返回修改后的数组，WordPress会使用这个数组来渲染用户个人资料页面。
- add_filter('user_contactmethods', 'modify_contact_methods');: 这一行将我们定义的modify_contact_methods函数挂载到user_contactmethods过滤器钩子上。这意味着当WordPress准备显示用户联系方式字段时，会先调用我们的函数来修改字段列表。
4. 使用效果
添加并保存代码后，登录WordPress后台，进入“用户”->“个人资料”，您将会在“联系信息”部分看到新添加的“性别”、“电话号码”和“城市”字段。
5. 注意事项
- 字段类型： 这种方法默认添加的是简单的文本输入框，不具备富文本（WYSIWYG）编辑器的功能。如果需要富文本编辑器，则需要更复杂的代码实现，或者考虑使用插件。
- 代码位置： 建议将代码放置在子主题的functions.php文件中，以防止主题更新时代码丢失。更好的做法是创建一个简单的自定义插件来管理这类功能性代码。
- 前端显示： 添加了这些字段后，它们只会出现在后台的用户个人资料页面。若要在前端（例如作者页面author.php或任何需要显示这些信息的页面）显示这些信息，您需要额外编写代码来获取用户元数据并输出。例如，可以使用get_the_author_meta('user_gender', $user_id)来获取特定用户的性别信息。
二、借助Advanced Custom Fields (ACF) 插件实现高级自定义字段
对于需要更丰富字段类型（如WYSIWYG编辑器、图片、文件、关系字段等）且希望避免编写复杂代码的用户，Advanced Custom Fields (ACF) 插件是一个极其强大且受欢迎的选择。
1. 优势
- 可视化界面： 无需代码即可创建和管理各种复杂的自定义字段。
- 丰富的字段类型： 支持文本、文本域、数字、选择、复选框、单选按钮、WYSIWYG编辑器、图片、文件、日期选择器、Google地图等。
- 灵活的显示规则： 可以精确控制字段在哪些页面、文章类型、用户角色等位置显示。
- 易于前端调用： 提供简洁的函数来获取和显示自定义字段的值。
2. 实现带有WYSIWYG编辑器的字段
以下是使用ACF插件为用户个人资料添加一个带有WYSIWYG编辑器的自定义字段的步骤：
-
安装并激活ACF插件：
- 登录WordPress后台。
- 导航到“插件”->“安装插件”。
- 搜索“Advanced Custom Fields”，找到后点击“现在安装”并“激活”。
-
创建新的字段组：
- 激活插件后，左侧菜单会出现“自定义字段”。点击“自定义字段”->“添加新字段组”。
- 为您的字段组命名，例如“用户附加信息”。
-
添加WYSIWYG编辑器字段：
- 在新字段组页面，点击“+ 添加字段”。
- 字段标签 (Field Label): 输入字段的显示名称，例如“作者简介”。
- 字段名称 (Field Name): 自动生成，这是在代码中获取字段值时使用的键，例如author_bio。
- 字段类型 (Field Type): 从下拉菜单中选择“WYSIWYG 编辑器”。
- 您可以根据需要配置WYSIWYG编辑器的工具栏（全功能或基本）。
-
设置位置规则：
- 在“位置”部分，设置规则以确保该字段组出现在用户个人资料编辑页面。
- 选择“显示此字段组，如果”->“用户表单”->“等于”->“用户”。
- 您也可以选择“用户角色”等于某个特定角色（如“作者”或“管理员”），使字段仅对特定角色可见。
-
保存字段组：
- 完成配置后，点击右上角的“发布”或“更新”按钮保存字段组。
3. 使用效果
保存字段组后，导航到“用户”->“个人资料”，您将看到一个名为“作者简介”的WYSIWYG编辑器字段，您可以在其中输入和格式化文本。
4. 前端显示
要在前端（例如author.php模板文件）显示这个WYSIWYG字段的内容，您可以使用ACF提供的get_field()函数。
';
echo $author_bio; // WYSIWYG字段会输出HTML，所以直接echo即可
echo '
