=== ACF Views ===
Contributors: wplake
Tags: acf, display custom fields, display posts, acf views, shortcode, custom fields in frontend, show acf fields, get field values, get posts
Requires at least: 5.5
Tested up to: 6.1
Requires PHP: 7.4
Stable tag: 1.7.13
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display ACF values. Anywhere. Using shortcodes.

== Description ==

**Display ACF values. Anywhere. Using shortcodes.**
Query posts, get field values and display them
without PHP coding in a few minutes!

Demo import lets you get started in seconds.

Important! "ACF Views" plugin requires [Advanced Custom Fields](https://wordpress.org/plugins/advanced-custom-fields/) plugin to be enabled on your website (either Free or Pro version).

== Display content ==

Solve all these scenarios without coding.
Almost all plugins use CPT to store their data, it means our plugin supports them! Like WooCommerce Products. Output markup will be generated automatically and can be styled easily using custom CSS rules included in every view.

* [Display page's ACF fields on the same page](https://docs.acfviews.com/guides/acf-views/basic/display-fields-on-a-single-page)
Real example : add ACF fields to your homepage and display them

* [Display specific posts](https://docs.acfviews.com/guides/acf-cards/basic/display-multiple-posts-and-their-fields) (built-in or CPT, manually assigned or by filters) with their fields
Real example : display 10 latest WooCommerce products with their ACF fields

* [Display specific post (or CPT item) with its fields](https://docs.acfviews.com/guides/acf-views/basic/display-custom-post-and-its-fields)
Real example : display information about a sponsor (Sponsor CPT item) on another post

* [Display specific ACF fields for all items of a CPT](https://docs.acfviews.com/guides/acf-views/basic/display-fields-for-a-custom-post-type)
Real example : display specific ACF fields for all WooCommerce products

== Less time. Less efforts ==

* Select field names from a list, no need to worry about return type
* UI to define DB query settings, no need to worry about arguments
* Editing theme files via FTP is in the past
* CSS/JS code can be added without hassle
* Built-in features, like pagination to save hours of coding

== Extensive Docs and Friendly Support ==

Our [YouTube channel](https://www.youtube.com/watch?v=Ieu3Mk2Ah0A&list=PL4WYpE2DYvTyzk1DtNhXJ4BXRjtIndht3) showcases the use of our plugin and its features, making it easier for new users to get started. See our [Docs](https://docs.acfviews.com/getting-started/acf-views-plugin-for-wordpress) for step by step guides and for information about customization.
Questions about the Free ACF Views plugin are handled through the [support forum](https://wordpress.org/support/plugin/acf-views/). Customers with an active Pro license have personal support via our [contact form](https://wplake.org/contact-us/).

== Powerful features ==

* Use ACF View item to display ACF fields for a specific post/page/CPT item
* Use ACF Card item to choose a set of posts (or CPT items) and display them with their ACF fields
* Display built-in post fields (like title or thumbnail) in your view along with ACF fields
* Define custom CSS & JS
* Display fields from another page/post/CPT item
* Combine fields from different ACF groups in one View
* Restrict access to ACF View Or Card by user roles

== High Performance ==

Every wrapper has some overhead. We do our best to make this number as small as possible. One unique ACF View/Card on a page would only effect this by 0.01 seconds**\*** overhead compared to the usual way with coding. It's impossible to notice these tiny numbers visually without testing it.
**\***More about the test [here](https://docs.acfviews.com/getting-started/performance).

== Get more with Pro ==

Do you need more? We have a [Pro version](https://wplake.org/acf-views-pro/) with extra features:

* Edit HTML Markup.
* Filter posts by meta and taxonomies. Use AJAX pagination
* Repeater field type
* Add Custom Gutenberg blocks
* Add plugin's shortcodes to pages/CPT items without code editing

See tutorials on [our youtube channel](https://www.youtube.com/watch?v=Ieu3Mk2Ah0A&list=PL4WYpE2DYvTyzk1DtNhXJ4BXRjtIndht3).

== Video overview ==

https://youtu.be/UaxdVYupmok

== Screenshots ==

1. Overview page will go you through all main points
2. Import Demo lets you get started in seconds. Click, import and you've got a basic setup for an ACF Group, ACF view and a Demo Post
3. List of ACF views, all management is available via the familiar interface
4. Create ACF View item to select target ACF fields and copy the shortcode to display field values for a specific post/page/CPT item
5. ACF View has advanced settings that allow you to add your own CSS/JS code
6. List of ACF Cards, all management is available via the familiar interface
7. Create ACF Card item to choose a set of posts (or CPT items) and paste the shortcode in a target place to display the posts with their ACF fields (which fields are printed depending on a selected ACF View in the Card settings)

== Frequently Asked Questions ==

= Supported field types =

All field types with values are supported.

Basic group

* Text
* Textarea
* Number
* Range
* Email
* Url
* Password

Content group

* Image
* File
* Wysiwyg
* Oembed
* Gallery

Choice group

* Select
* Checkbox
* Radio
* Button Group
* True false

Relational group

* Link
* Post Object
* Page Link
* Relationship
* Taxonomy
* User

JQuery group

* Google Map
* Date Picker
* Date Time Picker
* Time Picker
* Color Picker

= How to create an ACF View =

Create ACF View item to select target ACF fields and copy the shortcode to display field values for a specific post/page/CPT item.

1. Setup Fields in your Advanced Custom Field Group
2. Create an ACF View and select target fields (they can be from different field groups)
3. Copy and paste the shortcode in the target place (like a page or post, WooCommerce product...)
4. Make sure the chosen fields are filled at the target object. By default, field values will be read from the current object where the shortcode was pasted. To show another object's data use the special shortcode argument (object-id).

That's it! Now you can visit the frontend, your view will get field values properly (depending on a field type), and will automatically insert an HTML markup, that you can style with CSS (using assigned or built-in view classes).
You can restrict access to the ACF View by using user-with-roles="ROLE1,ROLE2" user-without-roles="ROLE1,ROLE2" shortcode arguments.

= How to create an ACF Card =

Create ACF Card item to choose a set of posts (or CPT items) and paste the shortcode in a target place to display the posts with their ACF fields (which fields are printed depending on a selected ACF View in the Card settings).

1. Setup an ACF View following the guide above
2. Create an ACF Card, choose a target ACF View and setup post filters (like post type) or manually assign posts
3. Copy and paste the shortcode in the target place (like a page or post)

That's it! Now you can visit the frontend, your view will get posts and display them, using the ACF View, now you can style output as grid/list/whatever with CSS (visit an ACF Card Advanced tab).
You can restrict access to the ACF Card by using user-with-roles="ROLE1,ROLE2" user-without-roles="ROLE1,ROLE2" shortcode arguments.

== Changelog ==

= 1.7.13 (2022-11-03): =
- Fixed bug with missing fields

= 1.7.12 (2022-11-02): =
- Improved code : no PHP warnings on the ACF options page
- Readme

= 1.7.11 (2022-11-01): =
- View : supporting of the google map field
- UX : links to Docs

= 1.7.10 (2022-10-28): =
- Bug fixed : automatic deactivation on activation of some plugins
- UX improvement : removed automatic redirection to the Overview page
- More supported field types : oembed, gallery, button_group, post_object, relationship, taxonomy, user

= 1.7.0 (2022-10-27): =
- View, Card : MountPoints feature
- View, Card : improved CSS shortcuts

= 1.6.17 (2022-10-24): =
- Updated readme
- Updated field labels

= 1.6.13 (2022-10-21): =
- Performance : improved caching

= 1.6.12 (2022-10-21): =
- Copy to clipboard : improved working on HTTP protocol, fixed the roles shortcode copying

= 1.6.11 (2022-10-21): =
- Copy to clipboard : improved working on HTTP protocol

= 1.6.10 (2022-10-21): =
- Demo import : fixed a bug
- Gutenberg block feature : improved notice
- Improvement : removed double slashing for View/Card fields in DB

= 1.6.0 (2022-10-21): =
- Performance improving : View/Card settings now in JSON from post_content instead of using postMeta
- Gutenberg block feature : fixed a bug

= 1.5.10 (2022-10-17): =
- Card Shortcodes postbox : fixed wrong argument name
- ACF dependency : improved links (to the local add-plugin page)
- Improved redirection after activation (to use TRANSIENTS)
- Automatic deactivation one of instances when both Basic & PRO activated
- Added information about restricting access to View/Card by user roles
- Added escaping output of plain field types
- Improved import

= 1.5.0 (2022-10-13): =
- Downgraded ACF dependency from PRO to Basic
- New shortcode arguments : user-with-roles, user-without-roles
- Fixed ImageSize for repeater fields

= 1.4.10 (2022-10-12): =
- View : preview feature
- Card : preview feature, custom variables filter
- Improved 'ACF PRO' dependency notice

= 1.4.0 (2022-10-10): =
- View : reordered fields (new tab)
- View : image size field : dynamic list instead of hard coded, $Post$ thumbnail support

= 1.3.1 (2022-10-04): =
- View : improved Gutenberg block description
- Toolbar improved
- Code structure improved
- Filters added

= 1.3.0 (2022-09-30): =
- Backend optimization
- Card : fixed CSS classes field
- Card : new tab - "Layout"
- View : improved UX (field settings is displayed only for specific field types)
- View&Card : disabled autocomplete

= 1.2.1 (2022-09-28): =
- Overview page content
- Demo imported error fixed
- Demo import improved (added ACF Card)

= 1.2.0 (2022-09-27): =
- Card markup preview field
- Card no posts found message
- Preview of PRO fields
- Admin Table bug fixed (select all)
- clone item feature improved

= 1.1.1 (2022-09-25): =
- Markup and other improvements

= 1.1.0 (2022-09-20): =
- Markup improvements

= 1.0.11 (2022-09-19): =
- ACF Cards, readme

= 1.0.10 (2022-09-09): =
- Readme, assets

= 1.0.9 (2022-09-09): =
- Minor improvements, readme

= 1.0.8 (2022-09-01): =
- Improved code editor

= 1.0.7 (2022-08-31): =
- JS code feature
- Link and Page_link field types

= 1.0.6 (2022-07-30): =
- Code improving

= 1.0.5 (2022-06-24): =
- Demo import feature

= 1.0.4 (2022-06-18): =
- Video review

= 1.0.3 (2022-06-09): =
- Readme

= 1.0.2 (2022-06-09): =
- Plugin's version

= 1.0.1 (2022-06-09): =
- Screenshots, plugin's version