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

The simple way to display posts and their ACF fields anywhere on your site using shortcodes. This means you don’t need to write any PHP code to query posts, get field values and display it anymore!

== Description ==

ACF Views is the simple way to display posts and their ACF fields anywhere on your site using shortcodes. This means you don’t need to write any PHP code to query posts, get field values and display it anymore!

The views are reusable and their shortcodes can be pasted ANYWHERE (that supports shortcodes e.g. Gutenberg shortcode block or WooCommerce product page) with ANY THEME using ANY PAGE BUILDER.
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.

**Important! ACF Views plugin requires an active Advanced Custom Fields PRO plugin.**

== Display content ==

Solve all these scenarios without coding.
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
Real example : add ACF fields to your homepage and display them

* Display specific posts (manually assigned or by filters) with their fields
Real example : display 10 latest WooCommerce products with their ACF fields

* Display specific post with 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
Real example : display specific ACF fields for all WooCommerce products

== Powerful features ==

* Display post fields (like title or thumbnail) in your view along with ACF fields with a special built-in ‘$Post$’ group
* Define custom CSS & JS
* Display fields from another page
* Combine fields from different groups in one View

== Get more with PRO ==

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

* Edit HTML Markup (still no coding, only HTML knowledge is necessary)
Real sample : change the default post markup to get 2 columns (left for an image and right for fields)

* Use Repeater field
Real sample : display a grid of custom items (without creation of CPT)

* Add your own Gutenberg block
Real sample : add a custom quote block to your Blocks Library

== Expert support ==

We have a small team of Happiness Engineers ready to assist. Ask your questions in [our support forum](https://wordpress.org/support/plugin/acf-views/) or [contact us directly](https://wplake.org/contact-us/) if you have questions about ACF Views PRO version.

== Video review ==

https://youtu.be/arxOs4DB0oY

== PRO features review ==

https://youtu.be/Vvrbfrbbffg

== Screenshots ==

1. Overview page
2. Demo import page
3. List of ACF views
4. ACF View field settings
5. ACF View advanced settings
6. List of ACF cards
7. ACF Card Filter tab

== Frequently Asked Questions ==

= Supported field types =

ACF Views currently supports the following field types (with all available return formats):

Basic

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

Content

* Image
* File
* Wysiwyg

Choice

* Select
* Checkbox
* Radio
* True_false

Jquery

* Date_picker
* Date_time_picker
* Time_picker
* Color_picker

Relational

* Link
* Page_link

= How to create an ACF view =

ACF View allows to display ACF fields for a specific post or page.

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).

= How to create an ACF card =

ACF Card allows to choose a set of posts and display them with their ACF fields (using one of ACF Views).

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).

== Changelog ==

= 1.0.11 (2022-09-19)
- CPT Views, 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