=== Advanced Custom Fields: Extended ===
Contributors: hwk-fr
Donate link: https://hwk.fr/
Tags: acf, custom fields, meta, admin, fields, form, repeater, content
Requires at least: 4.9
Tested up to: 5.1.1
Requires PHP: 5.6
Stable tag: 0.5.8
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

All-in-one enhancement suite which improves Advanced Custom Fields administration.

== Description ==

ACF Extended is a all-in-one enhancement suite which improves Advanced Custom Fields administration.

**Requires at least ACF Pro 5.7.10**

*If you don't already own [ACF Pro](https://www.advancedcustomfields.com/pro/), I can only advise you to seriously consider it. It's one of the most powerful WordPress plugin, with a life-time licence for unlimited websites. What more could anyone want?*

== Field Groups ==

* **Auto Sync PHP**
Automatically synchronize field groups with local PHP files upon field group updates. This feature will create, include and update a local PHP file for each field group (just like the native Json sync feature).
Default folder: `/wp-content/themes/my-theme/acfe-php/`

* **Auto Sync Json**
Control which field groups you want to synchronize with local Json files. Display warnings if the Json file has been manually deleted. Manually synchronize Json from field group screen.

* **Categories**
Spice up your field groups with a custom taxonomy and filter field groups by terms.

* **Permissions**
Add permission layer to field groups. Choose which roles can view & edit field groups in the post edition screen.

* **Alternative Title**
Display an alternative field group title in post edition screen.

* **Note**
Add a personal note in the field group administration. Only visible to administrators

* **Custom meta data**
Add custom metas (key/value) in the field group administration

* **View raw data**
Display raw field group data in a modal to check your configuration & settings

* **Custom key**
Set custom field group key. ie: `group_custom_name`

== Field Groups List ==

* **Column: Category**
Display and filter field groups categories

* **Column: Locations**
Quick view of field groups locations informations using icons & popover

* **Column: Load**
Quick view of field groups load engine (DB or PHP. See Sync PHP)

* **Column: Sync PHP / Json**
Quick view of field groups synchronization status with warnings

* **Row action: Export PHP / Json**
One-click export for each field groups

* **Row action: Field group key**
Quick view of field groups keys

== Fields ==

* **Bidirectional fields**
An advanced bidirectional setting (also called post-to-post) is available for the following fields: Relationship, Post object, User & Taxonomy terms.
Fields will work bidirectionally and automatically updating each others. Works in groups & clones (prefixed field names must be turned off).

Usage example:
- Create a field group "Page: Relation" displaying on the post type: page
- Inside it, create a relationship field, allowing the post type: post
- Create an another field group "Post: Relation" displaying on the post type: post
- Inside it, create a relationship field, allowing the post type: page
- Activate the "Bidirectional" setting and select the "Page: Relation" relationship field
- Edit any page, and select any post of the post type post
- The page is now also saved in the said post

* **Advanced validation**
A more sophisticated validation conditions (AND/OR) with custom error messages in the post edition screen.

* **Advanced update filter**
Add specific PHP filters right before the value is saved in the database.

* **Permissions**
Add permission layer to fields. Choose which roles can view & edit fields in the post edition screen. (can be combinated with field groups permissions)

* **View raw data**
Display raw field data in a modal to check your configuration & settings

* **New field: Dynamic message**
Display dynamic PHP content using `acf/render_field`

* **New field: Button**
Display a submit button

* **New field: Post type selection**
Select any post type (format: checkbox, radio or select)

* **New field: Taxonomy selection**
Select any taxonomy (format: checkbox, radio or select)

* **New field: Slug**
A slug text input (ie: `my-text-input`)

== ACF Settings ==

* **Settings page**
Display all ACF settings in one page.

== Dynamic Post Types ==

Create and manage post types from your WordPress administration (Tools > Post Types). All WordPress post types arguments can be set and managed. But also:

* Manage Posts per page, order by and order for the post type archive
* Manage Posts per page, order by and order for the post type administration screen
* Set custom single template (ie: `my-single.php`) instead of the native `single-{post_type}.php`
* Set custom archive template (ie: `my-archive.php`) instead of the native `archive-{post_type}.php`

== Dynamic Taxonomies ==

Create and manage taxonomies from your WordPress administration (Tools > Taxonomies). All WordPress taxonomies arguments can be set and managed. But also:

* Manage Posts per page, order by and order for the taxonomy term archive
* Manage Posts per page, order by and order for the taxonomy administration screen
* Set custom taxonomy template (ie: `my-taxonomy.php`) instead of the native `taxonomy-{taxonomy}.php`

== Ajax Author Box ==

Replaced the native WP Author Metabox with a dynamic version allowing to manage thousands of users without slowing down the post administration.

== Options ==

BETA: Manage all WordPress options from Settings > Options.

* View, add, edit and remove simple options (string/boolean)
* View and remove serialized options (displayed as array for readability)

== Installation ==

= Wordpress Install =

1. Install Advanced Custom Fields: Pro
2. Upload the plugin files to the `/wp-content/plugins/advanced-custom-fields-extended` directory, or install the plugin through the WordPress plugins screen directly.
3. Activate the plugin through the 'Plugins' screen in WordPress.
4. Everything is ready!

== Frequently Asked Questions ==

= How to activate Auto Sync PHP? =

Create a folder `/acfe-php/` in your theme. Go to your field group administration, check to 'Sync PHP' option in the sidebar and save the field group.

= How the bidirectional field setting works? =

An advanced bidirectional setting (also called post-to-post) is available for the following fields: Relationship, Post object, User & Taxonomy terms.
Fields will work bidirectionally and automatically updating each others. Works in groups & clones (prefixed field names must be turned off).

Usage example:
* Create a field group "Page: Relation" displaying on the post type: page
* Inside it, create a relationship field, allowing the post type: post
* Create an another field group "Post: Relation" displaying on the post type: post
* Inside it, create a relationship field, allowing the post type: page
* Activate the "Bidirectional" setting and select the "Page: Relation" relationship field
* Edit any page, and select any post of the post type post
* The page is now also saved in the said post

== Screenshots ==

1. Field Groups List
2. Field Groups List (Labeled)
3. Field Group
4. Field Group (Labeled)
5. Field Group: Raw Data (Modal)
6. Field
7. Field: Raw Data (Modal)
8. ACF Settings

== Changelog ==

= 0.5.8 =
* Field: Added Bidirectional setting for the following fields: relationship, post object, user & taxonomy terms
* Module: Added 'Ajax Author' field to replace the native WP Author Meta Box
* Module: Dynamic Post Type & Taxonomy - Better exclusion from ACF post types selection (location & fields)
* General: Fixed ACF Select2 CSS to fit ACF input styles (border-radius, border-color & line-height)
* General: Renamed ACF-Extended assets for better readability in the browser console resources tab
* Compatibility: Removed the Taxonomy Order submenu created under ACF for the taxonomy 'Field Group Category' by the plugin 'Category Order and Taxonomy Terms Order'

= 0.5.5.1 =
* Module: Dynamic Taxonomy - Fixed Terms PHP warning
* General: Plugin readme

= 0.5.5 =
* Module: Added Dynamic Post Type module
* Module: Added Dynamic Taxonomy module
* Admin: Added WP Options page
* Field: Added Post Type Selection field
* Field: Added Taxonomy Selection field
* Field: Added Slug field
* Field Groups: Fixed 'no field groups found' wrong colspan
* General: Reworked plugin folders and files hierarchy

= 0.5.2.3 =
* Field Groups: Fixed unused category column on Field Groups Sync page
* Fields: Fixed subfields 'ghost' acfcloneindex saved when duplicating flexible content (thanks to @AsmussenBrandon)

= 0.5.2.1 =
* Field Group: Fixed Left Label Placement overwriting existing field groups (thanks to @AsmussenBrandon)

= 0.5.2 =
* Fields: Added new dynamic message field
* Fields: Added new button field
* General: Added compatibility filters for 'Post Types Order' plugin
* Plugin: Updated assets
* Plugin: Reworked readme
* Plugin: Fixed typos

= 0.5.1 =
* Plugin: Added screenshots
* Field Group: Moved Auto Sync Warnings below Auto Sync instructions
* Field: Added filters variation to `acfe/validate` & `acfe/update`

= 0.5 =
* Initial release

== Upgrade Notice ==

None