在本篇文章中,了解如何使用 ACF 将重复字段添加到您的块中。
如果你错过了我们之前的文章: 在 WordPress 中使用高级自定义字段 (ACF) 创建自定义 Gutenberg 块, 在深入了解 ACF 重复字段的使用方法之前,请务必先阅读这篇文章。
重复字段允许您创建一组可以重复多次的子字段,这在创建图片库、评价滑块或内容列表等块时尤其有用。
创建重复字段
在您的 WordPress 控制面板上导航至 ACF 设置。创建新的字段组,或者选择您想要添加重复字段的现有字段。添加一个新的字段,并选择字段类型为 中继器. 然后,您可以根据需要将子字段添加到重复字段中。
更新块模板
接下来,更新该块的 PHP 模板,以便处理重复字段。如果您的块名称是 评价, 您的文件应该在 block-testimonial.php. 这个文件应该包含 PHP 和 HTML,用于显示您的块的内容。如果您的重复字段的名称是 评价重复器, 它有两个子领域。 评价名称 还有 评价文字, 您的 PHP 代码可能看起来像这样:
<code><?php
if (have_rows('testimonial_repeater')) :
while (have_rows('testimonial_repeater')) : the_row();
$name = get_sub_field('testimonial_name');
$text = get_sub_field('testimonial_text');
?>
<div class="testimonial">
<h2><?php echo $name; ?></h2>
<p><?php echo $text; ?></p>
</div>
<?php
endwhile;
endif;
?>
这个代码使用了 ACF 的 has_rows 函数可以检查 repeater 字段是否存在任何行,然后 the_row 函数用于遍历每个行。该函数 get_sub_field 函数用于获取子字段的值。
使用“Block”
最后,您可以在任何帖子或页面中添加此块,并在编辑器中看到重复显示字段。您可以添加任意多的行,每个行都将按您块的 PHP 模板中的定义显示在前端。
请记住,重复置换功能是 ACF 的高级功能,所以你需要使用 ACF Pro 来使用它。此外,请确保你的主题的 CSS 样式也支持它。 .testimonial 根据所使用的类(或其他类)的特性,适当地调整颜色设置,以达到理想的效果。
请注意,上述 PHP 代码只是一个非常基本的实现,并未包含任何错误检查功能。在生产环境中,您可能需要添加更多检查功能,以确保如果某些字段为空时代码不会发生崩溃。