Advanced Custom Fields 是一款非常强大的自定义字段插件，允许你自己添加多种形式的自定义字段类型，比如 Image、Checkbox、File、Text、Select、True / False、Link、Textarea 等等，可以集成为一个或多个面板，支持导出字段为 xml 或php代码，还可以集成到主题或插件里。你可以使用这个WORDPRESS插件为页面、文章、分类、用户建立自定义字段。可以用这个插件创建一个网站设置的页面字段，可以用来自由编辑网站的标题、LOGO、banner，版权文字等等只要你想得到的都可以。

你可以通过 the_field() 方法显示 Advanced Custom Fields 插件自定义的字段，具体如下：

描述

显示指定字段的值。该方法可用于从任意位置输出任意字段的值。

参数

the_field($selector, [$post_id], [$format_value]);
  • $selector （字符串） （必需） 字段名称或字段键。
  • $post_id （混合） （可选） 保存值的帖子 ID。默认为当前帖子。
  • $format_value (bool) (可选) 是否应用格式化逻辑。默认为真。

示例

显示当前帖子中的值

此示例显示如何显示当前帖子中字段“text_field”的值。

<h2><?php the_field('text_field'); ?></h2>

显示来自特定帖子的值

此示例显示如何显示 ID = 123 的帖子中字段“text_field”的值。

<h2><?php the_field('text_field', 123); ?></h2>

检查值是否存在

此示例显示如何在显示值之前检查值是否存在。

<?php if( get_field('text_field') ): ?>
    <h2><?php the_field('text_field'); ?></h2>
<?php endif; ?>

从不同的对象中获取一个值

此示例显示了各种有效的$post_id值，这些值指定了值的保存位置。

$post_id = false;           // current post
$post_id = 123;             // post ID = 123
$post_id = "user_123";      // user ID = 123
$post_id = "term_123";      // term ID = 123
$post_id = "category_123";  // same as above
$post_id = "option";        // options page
$post_id = "options";       // same as above

the_field( 'my_field', $post_id );