acf下载 - acf源代码下载

acf

其他源码

4.0.0

下载

Corcel ACF插件

轻松获取Corcel内部的所有高级自定义字段（ACF）字段。

此Corcel插件允许您使用Laravel Framework中使用相同的雄辩语法来获取由ACF插件创建的WordPress自定义字段。您可以使用任何PHP应用程序使用WordPress后端使用雄辩的模型和集合来改善开发。

有关Corcel工作方式的更多信息，请访问存储库。

安装
用法
- 这个想法
- 缺什么
- 字段
贡献
- 运行测试
执照

版本兼容性

科塞尔	拉拉维尔	php
`^4.0`	7.x	`>=7.2`
`^5.0`	8.x	`>=7.3`

安装

为Corcel安装ACF插件很容易：

 composer require corcel/acf

此插件需要Corcel，但是不用担心，如果缺少它也将安装。

用法

这是一个开发版本，因此使用情况可以进一步改变。该插件的所需行为是允许这样做：

 $ post = Post :: find ( 1 );
echo $ post -> acf -> url ; // returns the url custom field created using ACF

表现

当使用$post->acf->url类的东西时，插件必须进行一些额外的SQL查询才能根据ACF方法获取现场类型。因此，我们创建了另一种方法来获取它，而无需进行这些额外的查询。您只有信息插件是什么是帖子类型，作为函数：

 // Extra queries way
echo $ post -> acf -> author_username ; // it's a User field

// Without extra queries
echo $ post -> acf -> user ( ' author_username ' );

PS：方法名称应以camelCase()格式编写。因此，例如，对于字段类型date_picker您应该编写$post->acf->datePicker('fieldName') 。该插件可为您提供从camelCase转换为snake_case的转换。

这个想法

使用corcel中的默认$post->meta->field_name返回wp_postmeta表中的meta_value列的值。它可以是字符串，整数甚至串行的数组。问题是，当您使用ACF时，此值可能不仅仅在于。例如，如果您有整数，则可以是post id ， user id甚至一系列posts ids 。

ACF必须制作2（两个）SQL查询才能找出字段类型，因此，根据meta_value的类型，它具有不同的行为。例如，如果该值为45 ，并且post type为post_object ，则值45是具有ID 45的帖子。因此，在这种情况下，Corcel应该返回CorcelPost实例，而不仅仅是整数。

首先，ACF在wp_postmeta表中获取meta_value ，其中meta_key是_field_name之类的，并且帖子ID是您想要自定义字段的帖子的ID。返回的值是field key ，看起来像该field_57f421a2b81bd 。使用此键，它在wp_posts中获取相应的帖子，其中post_name = 'field_57f421a2b81bd' 。通过结果，它将获得post_content值，一个序列化数组，对其进行序列化并在type键上获取内容。这是字段类型。据此，ACF（以及此插件）做正确的事情。

该插件可与CorcelAcfFieldBasicField Abstract类内的基本逻辑一起使用，具有许多有用的功能来返回field key ， value等。CORCEL CorcelAcfFieldFactory负责返回正确的字段实例根据字段类型，因此，如果字段类型为post_object则返回CorcelAcfFieldPostObject的实例，并且它将在get()方法中返回CorcelPost的实例。

缺什么

首先，我们应该创建字段类和测试用例。在我们必须设置Corcel如何使用corcel/acf插件之后，以格式$post->meta->field或$post->acf->field返回具有不同行为的字段（完成！）。

为Repeater场创建更多的单元测试；
使用单元测试实施Flexible Content字段（完成！）；
提高性能。当前，该插件为每个字段提供一个SQL查询。该目标是使用whereIn()条款来改进该目标。

一些字段仍缺少（下面的检查表并贡献）。

字段

场地	地位	开发人员	返回
文本	好的	@jgrossi	`string`
Textarea	好的	@jgrossi	`string`
数字	好的	@jgrossi	`number`
电子邮件	好的	@jgrossi	`string`
URL	好的	@jgrossi	`string`
密码	好的	@jgrossi	`string`
Wysiwyg（编辑）	好的	@jgrossi	`string`
宣告	好的	@jgrossi	`string`
图像	好的	@jgrossi	`CorcelAcfFieldImage`
文件	好的	@jgrossi	`CorcelAcfFieldFile`
画廊	好的	@jgrossi	`CorcelAcfFieldGallery`
选择	好的	@jgrossi	`string`或`array`
复选框	好的	@jgrossi	`string`或`array`
收音机	好的	@jgrossi	`string`
是/错误	好的	@jgrossi	`boolean`
帖子对象	好的	@jgrossi	`CorcelPost`
页面链接	好的	@jgrossi	`string`
关系	好的	@jgrossi	`Post` `CorcelPost`或`Collection`
分类学	好的	@jgrossi	`CorcelTerm`或`Term`的`Collection`
用户	好的	@jgrossi	`CorcelUser`
Google地图	丢失的
日期选择器	好的	@jgrossi	`CarbonCarbon`
日期时间选择器	好的	@jgrossi	`CarbonCarbon`
时间选择器	好的	@jgrossi	`CarbonCarbon`
彩色选择器	好的	@jgrossi	`string`
中继器	好的	@jgrossi	集合的`Collection`
灵活的内容	好的	@marcoboom	`Collection`

贡献

欢迎所有贡献。在提交拉动请求之前，请先了解以下准则：

根据develop分支： git checkout -b my-fix-branch develop ，在新的GIT分支机构中进行更改；
创建您的补丁/功能，包括适当的测试用例。必须进行测试，以确保您的工作正在工作，并且在插件中没有什么都没有打破；
运行单元测试并确保所有测试通过。请在提交PR糊剂时， phpunit命令的结果促进批准工作；
在GitHub中，将拉力请求发送到corcel/acf:develop始终开发。不要将公关发送给我们的master分支！我们鼓励您使用git flow （https://github.com/petervanderdoes/gitflow-avh）工作流程，以使您的生活更轻松。这不是必需的，但也对您的发展事业有好处；
确保您的代码遵循PSR-2公约（http://www.php-fig.org/psr/psr/psr-2/）。