README

您正在使用 ACF Fluent 吗？

ACF Fluent 的下载量接近 8000，我觉得这已经很酷了！我的意思是，这并不是很多下载，但无论如何都很酷。如果您在使用它，我很乐意听到您的反馈。请给我发邮件，告诉我您在哪些项目上使用了它 :)。虽然我现在没有积极地进行开发，但我仍然很高兴维护它。

什么是 ACF Fluent？

ACF Fluent 是 Advanced Custom Fields WordPress 插件的流畅接口。它允许主题开发者使用表达性强、流畅的接口来创建自定义字段 "查询"，使得使用 ACF 进行模板设计变得轻松。

为什么？

如果您在 WordPress 模板中大量使用 Advanced Custom Fields（您应该这样做），那么您可能发现自己在编写大量重复的代码，只是为了打印出您的字段。例如，您可能有用于页面英雄部分的 heading 字段

<?php

$heading = get_field('heading');

if (is_null($heading)) {
    $heading = get_the_title();
} else {
    $heading = esc_html($heading);
}

?>

<h1><?= $heading ?></h1>

正如您所知，这种类型的模板编码会很快使您的模板文件变得杂乱，将您的结构良好的 HTML 变成 PHP 标签和块的混乱。最糟糕的是，您会发现自己在 PHP 逻辑的混乱中，而且重复相同的逻辑！

ACF Fluent 通过一个流畅的构建器来最小化混乱，该构建器让您可以轻松获取和更新字段及其子字段，并在过程中添加约束。让我们看看上面的相同功能，使用 ACF Fluent

<?php

use Samrap\Acf\Acf;

$heading = Acf::field('heading')
                ->default(get_the_title())
                ->escape()
                ->get();

?>

<h1><?= $heading ?></h1>

感兴趣吗？ACF Fluent 具有更多功能且无依赖项。请查看文档，了解所有令人惊叹的功能。

文档

贡献

ACF Fluent 仍处于早期阶段。鼓励和感谢问题、PR 和改进建议。

由 @thesamrapaport 构建，samrapaport.com

ACF 标志由 Elliot Condon 和 Advanced Custom Fields 插件拥有

samrap / acf-fluent

维护者

详细信息

README

什么是 ACF Fluent？

为什么？

文档

贡献