Menu
  • 注册
  • 函数 函数 关注:0 内容:41

    [基础] get_fields()

  • 查看作者
  • 打赏作者
  • 拉黑名单
    • 3举人
      超级会员
      博主

      [基础] get_fields()

      描述

      返回指定文章的字段值数组( name => value)

      参数

      get_fields([$post_id], [$format_value]);
      • $post_id (mixed) (可选) 保存了值的文章 ID,默认为当前文章

      • $format_value (bool) (可选) 是否进行格式化,默认为 true

      返回值

      (array | false) 一个值的数组或如果没有字段则返回 false

      例子

      从当前文章获取值

      下方的示例展示了如何显示当前文章中所有字段的列表(名称和值)。

      <?php 
      
      $fields = get_fields();
      
      if( $fields ): ?>
          <ul>
              <?php foreach( $fields as $name => $value ): ?>
                  <li><b><?php echo $name; ?></b> <?php echo $value; ?></li>
              <?php endforeach; ?>
          </ul>
      <?php endif; ?>

      从指定文章中获取值

      下方的示例展示了如何从不同的数据对象中加载所有字段(名称和值)。

      // 从当前文章获取值
      $fields = get_fields();
      
      // 从 ID = 1 的文章中获取值
      $post_fields = get_fields( 1 );
      
      // 从 ID = 2 的用户中获取值
      $user_fields = get_fields( 'user_2' );
      
      // 从 ID = 3 的分类中获取值
      $term_fields = get_fields( 'term_3' );
      
      // ... 或者使用分类法的名称
      $term_fields = get_fields( 'category_3' );
      
      // 从 ID = 4 的评论中获取值
      $comment_fields = get_fields( 'comment_4' );
      
      // 从 ACF 选项页中获取值
      $option_fields = get_fields( 'options' );
      
      // ... 或者使用 'option'.
      $option_fields = get_fields( 'option' );

      获取未经格式化的值

      这个示例展示了如何加载所有字段(名称和值)而不进行格式化。

      格式化是指从数据库中加载后如何显示值。例如,一个图像字段值仅作为附件 ID 保存到数据库中,但可以根据字段选项作为 URL 返回。

      在某些情况下,不管字段选项如何,确保返回原始值可能会更有用。为此,我们应该使用 $format_value 参数。

      $fields = get_fields( 123, false );

      请登录之后再进行评论

      登录