WordPress 高级自定义字段（ACF）完全指南：构建灵活的内容管理

Advanced Custom Fields（ACF）是 WordPress 最流行的自定义字段插件，让你可以为文章、页面和自定义内容类型添加任意类型的内容字段。本文介绍 ACF 的使用方法、字段类型和实战技巧。

安装与基础使用

在 WordPress 后台安装 ACF 插件后，创建字段组（Field Group），定义字段名称、类型和显示位置（文章类型、条件规则）。然后在模板文件中使用 ACF 函数调用字段值。

常用字段类型

文本（Text）——单行文本，适合标题、副标题。文本域（Textarea）——多行文本，支持自动段落格式化。数字（Number）——数值类型，可设置范围和步进值。邮箱、URL、电话——带验证的文本字段。日期选择器——日期和时间选择，可指定格式和存储格式。

内容编辑器字段

Wysiwyg 编辑器——完整的富文本编辑器。图片——单图选择，支持指定图片大小和返回格式。文件——上传或选择任意文件（PDF、文档等）。画廊——多图选择器。oEmbed——嵌入 YouTube、Vimeo 等视频和社交媒体内容。

关系和布局字段

关系（Relationship）——选择其他文章、页面或自定义内容类型，形成关联数据。Post Object——下拉或搜索选择单篇文章。Repeater——重复字段组，可添加多条记录（适合产品参数列表）。Flexible Content——灵活内容，按需组合不同字段布局模块。Clone——复用其他字段组的字段。

ACF PRO 高级功能

Repeater Field——重复字段组（见上）。Flexible Content——灵活内容模块（见上）。Gallery——原生图片画廊。Options Page——全站通用设置页面（如网站 Logo、联系方式）。ACF Blocks——注册 Gutenberg 块，用 PHP 定义块字段。

模板中调用字段

the_field('field_name') 输出字段值；get_field('field_name') 获取字段值（可进一步处理）；have_rows('repeater_field') : while(have_rows('repeater_field')) : the_row(); 遍历 Repeater 字段。

总结

ACF 将 WordPress 从简单的 CMS 提升为灵活的内容管理平台。掌握 ACF，你可以构建任何复杂的内容结构。