ACF职业

ACF职业是WordPress最强大的工具之一，开发人员和非开发人员都喜欢!允许您创建自定义字段的任何帖子类型与大量的显示选项。

开始

去Pro >验证或X >验证为X然后寻找ACF职业．点击Install。

一旦安装，安装按钮会改变并说激活．单击该按钮，它将激活插件。然后您将看到状态更改为安装和激活．

在WordPress仪表板导航中，你现在应该看到ACF Pro菜单项如下所示:

继续单击Custom Fields菜单项。这将带您到ACF Pro的主要概述。

什么是字段组

第一件事你会看到的主要ACF Pro概述是字段组这些字段组是ACF用来对你在主题、子主题、模板或插件中创建的字段进行分组的。

正如你所看到的，我们已经有了一个我们之前建立的字段组，让我们探索一下，看看发生了什么，以及我们如何利用ACF添加一个关于作者元框到我们的单一帖子模板。

这是我们的基本字段组布局:

这里发生了很多事情，所以让我们一个一个地来分析。首先，我们有我们的规则，这些是这个特定字段组中字段如何显示的基本规则。例如，在我们创建的字段组中，如果post类型等于post，我们检查它以显示这个字段组。这意味着，例如，如果您在一个投资组合项目上，字段组将不会显示。

我们可以在字段组显示规则上展开并添加多个其他条件，如何添加这些条件是ACF Pro的重要部分。有两个选择both和as well添加规则组．

选项1和允许您在第一个规则之外添加另一个规则，该规则必须与第一个规则匹配才能显示字段组。这对于ACF来说既有用又强大。在这个例子中，假设我们有一个杂志风格的网站。我们可能不希望Author字段组显示在所有类别中，只显示常规博客。因此，如果我们有一个类别称为博客在ACF Pro，然后我们可以设置Post Taxonomy等于博客。

有了这个设置，我们的字段组就会像这样:

这现在意味着我们的字段组将只显示文章类型是文章，如果文章分类是博客。如果只匹配其中一个条件，则意味着字段组将不显示。

但如果你想让它显示这两个条件是否匹配呢?

选项2:添加规则组属性中添加其他规则组字段组这是一个或条件，而不是And条件，这意味着如果条件A或条件B都满足，则显示字段组字段组不需要满足规则就可以显示字段组。如果我们设这个值为文章分类等于博客我们的Field Group会是这样的:

这现在意味着我们的字段组如果帖子类型是帖子，或者帖子分类设置为Blog，则会显示。这意味着如果您在另一篇文章类型上有博客分类，Field Group仍然会显示，而选项1则不会显示，因为两个条件都必须匹配。

现场组显示是ACF Pro的一个非常强大的部分，允许您实现几乎无限的显示选项。

的其余选项字段组设置:

• 状态
• 风格
• 位置
• 标签位置
• 指令位置
• 订单号
• 描述
• 隐藏在屏幕上

关于所有这些选项需要注意的重要一点是，它们都是针对wp-admin中的Field Group不字段组如何在主题中显示。

例如，如果您将位置设置为正常(内容后)你在字段组中的字段将显示在你配置的字段组显示的页面/帖子的底部。是这样的:

然而，如果我们将其更改为显示在一侧，那么我们在字段显示组中的字段将像这样显示在一侧:

一旦你对你的Field Group满意了，继续并保存它。

添加字段

在字段组上单击添加字段：

然后你会看到一系列的字段选项，像这样:

正如您所看到的，每个字段都可以填写各种选项，选项将根据您所选择的字段类型而变化，因此请确保您选择了字段类型填写前场的选择．

首先给你的字段起一个名字，为了本文的目的，我们已经提到了，我们添加了一个关于作者部分链接到我们的博客文章。

的字段标签将是字段的名称，因为它出现在你的字段组设置显示的post类型的编辑页面上。

的字段名是你将在你的主题，子主题，模板或插件检索字段值，所以不要让它太复杂。在本例中，我们使用了about_author，它可以有下划线或破折号，但不允许有空格。

字段类型，从简单的文本区域到所见即所得编辑器，还有很多很多的选项。

字段说明，这些指示显示给你的其他管理员，编辑，作者和任何其他有权编辑你的字段组设置为显示的文章类型的人。

要求如果字段被设置为required并且没有被填充，那么在尝试发布/更新时将会显示一个错误。因为我们不希望页面上的作者简介是空的，所以我们将其设置为required。

默认值在这里，你可以输入一个默认值来创建一个新的帖子。

如果您选择Wysiwyg选项，您将看到两个其他选项。

使用这些选项，您可以使用所见即所得编辑器选择是否可视和文本选项都可用，或者如果您想为您的自定义字段显示媒体上传按钮，则只能选择其中一个。

一旦你对一切都感到满意，点击更新/保存．

显示字段

现在您已经添加了一个字段并创建了一个字段组，但是如何在主题中实际输出字段值呢?创建了about author字段后，希望将其显示在留下评论在我们选择的堆栈上的单个帖子模板的部分精神．

在我们开始添加字段之前，我们需要确保我们已经准备好了子主题。如果你的网站上还没有儿童主题，你可以下载一个在这里．

现在使用您的FTP或SFTP程序，如Coda, Filezilla, Cyberduck等通过FTP/SFTP登录并导航到wp-content /主题/ x-child并在这个确切的路径下创建以下文件夹:

框架/视图/精神/ wp-single.php

这是一个模板，负责输出Ethos堆栈的单个帖子模板。的父主题复制该文件的内容wp-content /主题/ x /框架/视图/精神/ wp-single.php．代码应该是这样的:

<？php  // ============================================================================= // 视图/精神/ WP-SINGLE.PHP  // ----------------------------------------------------------------------------- // 单输出精神。// ============================================================================= $ fullwidth = get_post_meta (get_the_ID(),“_x_post_layout”,真正的);> < ?php get_header ();?> 
 
 
  < ?PHP x_get_view('ethos'， 'content'， get_post_format()); ?>   
    
 
 

在这行之前:

<？php the_field(“about_author”);? >

添加从ACF Pro中检索自定义字段值的代码，该字段为:

<？php  // ============================================================================= // 视图/精神/ WP-SINGLE.PHP  // ----------------------------------------------------------------------------- // 单输出精神。// ============================================================================= $ fullwidth = get_post_meta (get_the_ID(),“_x_post_layout”,真正的);> < ?php get_header ();?> 
 
 
  < ?PHP x_get_view('ethos'， 'content'， get_post_format()); ?>    
    
 
 

注意，你不需要段落标签，他们只是给我们一些额外的样式与间距，而不是全部捆绑在一起，这也是一个基本的实现，你可以添加一系列额外的样式和标记，唯一的限制是你的想象力。

这使得整个文件看起来像这样(在我们的子主题中)。

现在我们已经添加了代码来显示我们的字段，让我们添加一个值来显示，打开任何帖子并在作者详细信息框中填写您想要的内容。保存帖子并在前端访问它。你应该看到你创建的新自定义字段显示如下:

恭喜!您已经成功地创建了一个自定义字段组，添加了一个自定义字段，并通过使用子主题和ACF Pro的get_field函数来显示自定义字段。您可以找到更多关于get_field函数的信息在这里．

基石/内容构建器集成

我们已经包含了一个基本的ACF Pro与基石的集成，它允许你在你的页面和帖子中使用一个短代码来自动拉出你的ACF Pro自定义字段的值，而不必修改模板文件。

你会使用:

{{acf: field_name}}

在您的基石内容中，field_name是字段的名称，如ACF Pro字段编辑屏幕所示。请注意，这是一个基本的集成，只支持基于文本的字段。例如，它不会输出图库。另外，使用所见即所得类型字段时要谨慎——WordPress的可视编辑器会自动添加标签，这会破坏元素标记，导致显示问题。

总结

做得好!现在你知道如何使用X和Pro安装附带的ACF Pro轻松地添加自定义字段到你的WordPress站点。

进一步的阅读

要了解更多关于ACF Pro，请查看官方文档在这里．