WordPress作者页面自定义文本字段扩展教程：代码与插件实现

本教程详细介绍了如何在wordpress作者页面添加自定义文本字段，并使其可在用户个人资料中进行编辑。文章提供了两种实现方案：一是通过`user_contactmethods`钩子进行代码扩展，实现基础文本字段的添加；二是通过使用advanced custom fields (acf)插件，实现包含wysiwyg编辑器的更高级自定义字段，为非开发者提供了便捷的解决方案。

在WordPress中，有时我们需要在用户个人资料页面（进而影响作者页面显示）添加额外的自定义信息字段，例如用户的性别、电话号码、城市或一个包含富文本内容的简介。本文将详细介绍两种实现这一需求的方法：通过代码钩子和使用专业的插件。

一、使用代码扩展用户联系方式

WordPress提供了一个名为user_contactmethods的过滤器钩子，允许开发者向用户个人资料页面的“联系信息”部分添加自定义字段。这种方法适用于添加简单的文本输入字段。

1. 实现原理

user_contactmethods钩子接收一个包含现有联系方式字段的数组，我们可以通过修改这个数组来添加新的字段。每个字段由一个键（用于存储数据）和一个值（在后台显示的标签）组成。

2. 示例代码

将以下代码添加到您的主题的functions.php文件或一个自定义插件中：

<?php
if (!function_exists('modify_contact_methods')) {
    /**
     * 向WordPress用户个人资料添加自定义联系方式字段。
     *
     * @param array $profile_fields 现有的联系方式字段数组。
     * @return array 修改后的联系方式字段数组。
     */
    function modify_contact_methods($profile_fields) {

        // 添加新的自定义字段
        // 数组的键是字段的元数据键（meta key），用于数据库存储和获取。
        // 数组的值是字段在用户个人资料页面显示的标签。
        $profile_fields['user_gender'] = '性别';
        $profile_fields['user_phone'] = '电话号码';
        $profile_fields['user_city'] = '城市';
        // 您可以根据需要添加更多字段，例如：
        // $profile_fields['user_wechat'] = '微信';

        return $profile_fields;
    }
    // 将自定义函数挂载到user_contactmethods过滤器钩子上
    add_filter('user_contactmethods', 'modify_contact_methods');
}
?>

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编辑器的自定义字段的步骤：

1. 安装并激活ACF插件：

   

   火龙果写作

   用火龙果，轻松写作，通过校对、改写、扩展等功能实现高质量内容生产。

   106

   查看详情
   • 登录WordPress后台。
   • 导航到“插件”->“安装插件”。
   • 搜索“Advanced Custom Fields”，找到后点击“现在安装”并“激活”。

2. 创建新的字段组：

   • 激活插件后，左侧菜单会出现“自定义字段”。点击“自定义字段”->“添加新字段组”。
   • 为您的字段组命名，例如“用户附加信息”。

3. 添加WYSIWYG编辑器字段：

   • 在新字段组页面，点击“+ 添加字段”。
   • 字段标签 (Field Label): 输入字段的显示名称，例如“作者简介”。
   • 字段名称 (Field Name): 自动生成，这是在代码中获取字段值时使用的键，例如author_bio。
   • 字段类型 (Field Type): 从下拉菜单中选择“WYSIWYG 编辑器”。
   • 您可以根据需要配置WYSIWYG编辑器的工具栏（全功能或基本）。

4. 设置位置规则：

   • 在“位置”部分，设置规则以确保该字段组出现在用户个人资料编辑页面。
   • 选择“显示此字段组，如果”->“用户表单”->“等于”->“用户”。
   • 您也可以选择“用户角色”等于某个特定角色（如“作者”或“管理员”），使字段仅对特定角色可见。

5. 保存字段组：

   • 完成配置后，点击右上角的“发布”或“更新”按钮保存字段组。

3. 使用效果

保存字段组后，导航到“用户”->“个人资料”，您将看到一个名为“作者简介”的WYSIWYG编辑器字段，您可以在其中输入和格式化文本。

4. 前端显示

要在前端（例如author.php模板文件）显示这个WYSIWYG字段的内容，您可以使用ACF提供的get_field()函数。

<?php
// 在author.php或其他需要显示作者信息的模板文件中
$author_id = get_the_author_meta('ID'); // 获取当前作者的ID

if (function_exists('get_field')) {
    $author_bio = get_field('author_bio', 'user_' . $author_id); // 'author_bio' 是您在ACF中设置的字段名称

    if ($author_bio) {
        echo '<div class="author-bio-custom">';
        echo $author_bio; // WYSIWYG字段会输出HTML，所以直接echo即可
        echo '</div>';
    }
}
?>

三、注意事项与总结

• 选择合适的方法：
  • 如果您只需要添加几个简单的文本输入框，并且对代码有一定了解，使用user_contactmethods钩子是轻量且高效的选择。
  • 如果您需要WYSIWYG编辑器、图片上传、或其他复杂的字段类型，或者希望完全通过图形界面管理自定义字段，那么Advanced Custom Fields (ACF) 插件是更优且推荐的解决方案。
• 代码放置的最佳实践： 无论是使用钩子还是其他自定义代码，都强烈建议将代码放置在子主题的functions.php文件或一个独立的自定义插件中。这样做可以确保在主题更新时您的自定义功能不会丢失。
• 安全性与性能： 确保您使用的代码或插件是可靠的。对于ACF，它是经过良好维护的，可以放心使用。
• 前端显示： 无论您选择哪种方法来添加自定义字段，都不要忘记在主题的相应模板文件中编写代码来获取并显示这些字段的值，否则用户将无法在网站前端看到这些信息。

通过上述两种方法，您可以灵活地为WordPress作者页面或其他用户资料添加自定义文本字段，满足多样化的网站内容展示需求。

以上就是WordPress作者页面自定义文本字段扩展教程：代码与插件实现的详细内容，更多请关注php中文网其它相关文章！