=== Advanced Views - Display Custom Fields (ACF, Pods, MetaBox), Posts, CPT and Woo Products anywhere in Gutenberg, Elementor, Divi, Beaver... ===
Contributors: wplakeorg
Tags: post grid, wp_query, meta fields, custom post types, taxonomy
Requires at least: 5.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.9.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display content with full control over selection and layout. Lightweight and compatible with any theme or page builder.

== Description ==

Display content with full control over selection and layout. Lightweight and compatible with any theme or page builder.

==⭐ Why Choose Advanced Views?==

Advanced Views is a framework that empowers you to create the layouts and selections you need, without bloatware or heavy dependencies.

✅ **Solid by design**: craft modular and reusable layouts. Avoid repetition, style conflicts, and messy code snippets.
✅ **Content-driven**: pull content dynamically, with granular filtering and sorting options, built on top of the native WordPress Query. Master advanced database queries with post fields, taxonomies, and meta values.
✅ **Time-saver**: automate the groundwork and data fetching. Focus on creating while leaving typical routines behind.
✅ **Fully customizable**: directly access the template code to create advanced elements, like Grids and Sliders, and harness your theme styles and scripts.
✅ **Easy to embed**: copy and paste a native WordPress shortcode to add layouts anywhere.

==🧩 Plenty of Use Cases==

Custom fields and Post Types are essential to WordPress. Advanced Views natively supports them – giving you the freedom to pull, mix, and combine them in a common layout.

Popular scenarios include:

**Displaying custom fields:**

🔹On a single page: to enrich landing page sections
🔹CPT-wide: estimated delivery time for all Products
🔹Site-wide: contact details from the Options page
🔹User-specific: fields of the current user in a custom banner or profile page

**Displaying Posts, Products and CPT:**

🔹Posts: blog posts from a specific category
🔹WooCommerce: related Products in a grid or carousel
🔹Event lists: Show upcoming events, hide past events
🔹Real Estate listings: properties by location, size, or type
🔹Locations map: display all pick-up location markers on a single map
🔹Reviews and Comments: product reviews or user comments

==🔗 Multiple Content Sources==

Advanced Views is vendor-independent and plugin-agnostic - so it will work with WordPress Posts, WooCommerce Products, and any CPT on your website.

Learn it once and use it everywhere with built-in support for:

🔹All Custom Post Types registered in WordPress
🔹[WordPress post fields](https://wplake.gitbook.io/advanced-views/getting-started/supported-data-vendors#id-1.-wordpress) (title, featured image, author, taxonomy terms...)
🔹[Woo Product fields](https://wplake.gitbook.io/advanced-views/getting-started/supported-data-vendors#id-2.-woocoomerce-plugin) (price, sku, stock status, weight...)
🔹[Advanced Custom Fields](https://wplake.gitbook.io/advanced-views/getting-started/supported-data-vendors#id-3.-advanced-custom-fields-plugin) (whether it’s text, select, image, gallery, repeater or relationship)
🔹[MetaBox fields](https://wplake.gitbook.io/advanced-views/getting-started/supported-data-vendors#id-4.-metabox-plugin) (like map, oEmbed, taxonomy, group... )
🔹[Pods fields](https://wplake.gitbook.io/advanced-views/getting-started/supported-data-vendors#id-5.-pods-plugin) (from WYSIWYG, price, date and time... )

You can integrate data from any external source, including API-based, directly into Layouts using snippets.

==🚀 Powerful features==

Whether you're a developer working on a child theme, a web creator using a page builder, or a tech-savvy website owner, Advanced Views makes the process easier with:

🔹[Storage options](https://wplake.gitbook.io/advanced-views/templates/file-system-storage): craft Layouts using the on-site editor, or edit them inside your favourite IDE, with git-friendly templates.
🔹[Multilingual-friendly](https://wplake.gitbook.io/advanced-views/templates/multilingual): translate any text or label in the Layouts using your favourite tool  (like WPML or Polylang)
🔹[Automatic template validation](https://wplake.gitbook.io/advanced-views/getting-started/introduction/key-aspects#id-3.3-seamless-data-connection): keep all the Layouts up-to-date with bulk validation, and get prompted to update the relevant layouts when used meta fields have been changed.
🔹[Template engine options](https://wplake.gitbook.io/advanced-views/templates/template-engines): opt for the Twig or Blade template engine site-wide, or mix it up and make a per Layout decision.
🔹[Just-in-time assets loader](https://wplake.gitbook.io/advanced-views/templates/css-and-js#id-1.1-just-in-time-assets): get layout styles and scripts injected just-in-time, on a per-page basis. Make fast page loading and great speed metrics your defaults.
🔹[Live reload and Dev mode](https://wplake.gitbook.io/advanced-views/templates/live-reload): see live changes to Layouts on the page, and find used layouts without searching.

==📚 Extensive Documentation & Friendly Support==

🔹[Helpful guides](https://docs.advanced-views.com/), FAQs, tips, and common use cases with code snippets
🔹Lite users are supported via the public [wordpress.org forum](https://wordpress.org/support/plugin/acf-views/)
🔹Pro users get priority support via [our website](https://advanced-views.com/support/)
🔹Actively maintained and tested against the latest WordPress releases

==🔓 Unlock More with Advanced Views Pro==

[Advanced Views Pro](https://advanced-views.com/pro/#pricing) takes your content displays to the next level with extended features:

**Layouts get:**

🔹[Repeater, Group, and Flexible fields support](https://wplake.gitbook.io/advanced-views/display-content/meta-fields/layout-fields/repeater-pro) - display complex nested fields — including repeaters within repeaters.
🔹[Gutenberg block option](https://wplake.gitbook.io/advanced-views/display-content/custom-gutenberg-blocks-pro) - turn any layout into a Gutenberg block with a single checkbox. Same template with full markup control and zero React coding.
🔹[Masonry, LightBox, Slider integrations](https://wplake.gitbook.io/advanced-views/display-content/front-end-assets-management-pro#supported-libraries-and-field-types) - turn your Repeater or User fields into a slider, Gallery Images into Masonry, or enable LightBox for single images.
🔹[Reusable components library](https://wplake.gitbook.io/advanced-views/templates/reusable-components-library-pro) - reuse existing Layouts on other websites with a single-click Git sync.

**Post Selections get:**

🔹[Meta filters](https://wplake.gitbook.io/advanced-views/query-content/meta-filters-pro) - precise post selections with filtering by meta fields: define bindings to URL arguments, current meta values, and more.
🔹[Ajax pagination](https://wplake.gitbook.io/advanced-views/query-content/pagination-pro) of results: choose between options for load more button, infinity scroll, or page numbers.
🔹Post carousels: turn queried posts into sliders.

== Screenshots ==

1. Workflow overview.
2. Layouts list managed using the familiar interface.
3. Get a basic setup in seconds with Demo import.
4. Assign multiple fields to Layouts.
5. The default template can easily be customized.
6. Query items with Post Selections and display using the selected Layout.
7. Posts can be filtered, sorted and styled.
8. Settings allow easily adjusting default behavior.
9. Import and Export Tool helps with site migration.

== Installation ==

**Installation for Advanced Views Framework**

From your WordPress dashboard:

1. Visit the Plugins list, click "Add New"
2. Search for "Advanced Views"
3. Click "Install Now" and "Activate" for the Advanced Views plugin
4. Visit the new menu item "Advanced Views Framework" and click "Add New" to create your first View

See our official [plugin documentation](https://docs.advanced-views.com/getting-started/introduction) for more.

**Installation for Advanced Views: Pro edition**

To purchase a Pro license key click [here](https://advanced-views.com/pro/#pricing).
After payment you'll receive an email with your license key which includes the Pro plugin archive.

1. Visit the Plugins list, click "Add New", then click "Upload Plugin"
2. Click on "Choose File" and locate the downloaded Pro archive, then click "Open"
3. Click on "Install Now" and wait for the package to upload and install, then click "Activate Plugin"
   Note: Lite plugin will automatically be deactivated. You can safely delete it from the Plugins list. (Don't worry, deleting it won't delete your data.)
4. In the Plugins list for Advanced Views: Pro edition click "Activate your Pro license" or use the left admin menu and click on "License".
5. Copy and paste your Pro License Key, then click "Activate"

Enjoy all the features and settings the Advanced Views Framework has to offer with automatic updates.
Customers with an active Pro license have personal support via our [support form](https://advanced-views.com/support/).

== Frequently Asked Questions ==

= What's the difference between a Layout and a Post Selection? =

A **Layout** defines how a single item is displayed (fields, HTML structure, styling).
A **Post Selection** queries posts from the database and displays them using the selected Layout.

= How do I display a Layout or Post Selection on a page? =

You can insert them using a shortcode anywhere on your site — including pages, posts, templates, or page builders.
Advanced Views Pro also allows inserting them as reusable blocks in the Gutenberg editor.

= Can I display fields inside the Gutenberg Query Loop? =

You can use the View shortcode inside the Gutenberg Query Loop element.

Please make sure you've added it via the built-in Shortcode block, as it won't work properly with other block types, like Code or Custom HTML.

= How do I display fields from an Options page? =

Create a Layout with your Options page fields, then set the `object-id` argument in the shortcode.

* If you’re using Advanced Custom Fields Options Pages, use `object-id="options"` for any Options page.
* If you’re using Meta Box Settings Pages, use the specific ID of your Options page instead.

= Can I customize the output template? =

Yes. Advanced Views generates a starter template for each Layout and Post Selection which you can edit.

The plugin supports template engines like Twig and Blade, giving you full control over the output markup.

= Can I display fields from taxonomy terms or other data sources? =

Yes. Advanced Views can retrieve fields from various data sources supported by your field plugin, such as taxonomy terms or comments.

= Can I display repeater or flexible fields? =

Yes, but this requires **Advanced Views Pro**.
The Pro version supports complex field types such as repeater, group, and flexible content fields from plugins like Advanced Custom Fields.

= Can I add pagination or load more posts with AJAX? =

Yes. **Advanced Views Pro** includes AJAX pagination options, allowing you to load additional posts without refreshing the page.
This is useful for blog archives, directories, and large content lists.

= Can I create reusable blocks for the block editor? =

Yes. With **Advanced Views Pro**, you can register your Layouts as reusable blocks for Gutenberg.
This allows editors to insert dynamic content directly in the block editor.

= Can I create sliders or galleries from queried posts? =

Yes, this is available in **Advanced Views Pro**.
You can connect your Post Selections to sliders or gallery layouts to display dynamic content such as featured posts, testimonials, or portfolio items.

= Does the plugin have a Git repository? =

Yes, we maintain an [official Git repository](https://github.com/wplake/advanced-views-framework).
You're welcome to open issues or PRs there.

== Changelog ==

= 3.9.1 (2026-07-20) =
- UX improvements
- Fix: custom Twig templates - false save-validation alarms

= 3.9.0 (2026-07-16) =
- Enhance: vanilla PHP as a template engine option
- Enhance: Layout & Selection - disabled automated markup minification (for better compatibility)
- Enhance: Layout & Selection - faster saving on ACF 6.8.1+
- Enhance: Starter Layout/Selection for new installations
- Fix: Layout/Selection editor working without an active ACF plugin
- Fix: Twig - escape filter support: |e("html_attr")
- Fix: trick allowing users with non-admin roles to update Layout/Selection settings via ACF calls
- Feature adoption: Pro Twig functions and filters

= 3.8.11 (2026-06-23) =
- Fix: ACF support - empty single Post Object field with the Null option - displayed the current page title

= 3.8.10 (2026-06-16) =
- Fix: Layout & Selection loading optimizer message - old settings page url

= 3.8.9 (2026-05-26) =
- Fix: PHPController compatibility with the FS storage option
- Fix: Readme changelog - wrong year
- Uphold: get rid of deprecated names in template; code fields and hook names
- Uphold: ES translations

= 3.8.7 (2026-05-20) =
- Feature adoption: PHP Controller (before Custom Data in Pro)
- Feature adoption: Reusable Components Library
- Feature adoption: Lightbox
- Bugfix: Layout with default Blade template repeats in Post Selection
- Bugfix: Layout - Lightbox - Simple type - duplicate popups if several instances of the same selector is on the same page
- UX: Layout & Selection settings - put "Template engine" below "Custom Template"
- UI: Layout - field dropdown font-size adjustment
- Uphold: tested with WP 7.0

= 3.8.6 (2026-04-03) =
- Bugfix: Post Selection - sortby

= 3.8.5 (2026-03-27) =
- Feature adoption: Layout & Post selection - Mount Points (before Pro-only)
- Feature adoption: Layout - in-template shortcode support
- Feature adoption: Post Selection - Taxonomy filters
- Bugfix: minor UI and message bugfixes
- Readme update

= 3.8.4 (2026-03-10) =
- Enhance: $_GET support for custom Ajax requests

= 3.8.3 (2026-02-27) =
- Feature adoption: Custom field layout for object fields (before Pro-only)
- Support: tested with the latest WordPress 6.9
- Enhance: "Layout not found" error message is hidden for guests

= 3.8.2 (2025-11-18) =
- Enhancement: Migrations - automated flush caches, logging, incomplete upgrade detection
- Enhancement: Tools - Debugging: added 'Flush caches' & 'Upgrade from version' options

= 3.8.1 (2025-11-14) =
- Better entity names: View => Layout, Card => Post Selection

= 3.7.20 (2025-09-19) =
- Level up View & Card management capabilities to 'manage_options' (for security reasons)
- Updated internal dependencies (ACF)

= 3.7.19 (2025-07-18) =
- UX improvements

= 3.7.18 (2025-06-27) =
- Enhancement: Woo - Stock quantity and featured fields support
- Enhancement: View - labels for default field groups
- Enhancement: Shortcode - View/Card not found error message
- Enhancement: Plugins list - AVF action links
- Enhancement: Tools - migrated Debugging tab (from the Settings)

= 3.7.17 (2025-04-19) =
- Fix: Shortcode_Block - rewritten PHP 7.4 incompatible code

= 3.7.16 (2025-04-18) =
- Fix: shortcode in Block theme template with Query Loop

= 3.7.15 (2025-04-11) =
- Fix: shortcode not rendered in Elementor with block-based theme
- Enhancement: [Translations loading](https://wordpress.org/support/topic/function-_load_textdomain_just_in_time-was-called-incorrectly-113/)
- Enhancement: Code editor improvements
- Maintenance: compatibility with upcoming WP 6.8

= 3.7.14 (2025-03-21) =
- Improved compatibility with non-block themes
- UX improvements & readme update

= 3.7.12 (2025-03-14) =
- Improved compatibility with Masteriyo LMS
- UX improvements

= 3.7.11 (2025-03-08) =
- View: fixed conditional logic-related bug

= 3.7.10 (2025-03-03) =
- Improved compatibility with the [MetaBox Lite plugin](https://metabox.io/lite/)
- Improved compatibility with the Impreza and Zephyr themes
- Improved PHP 8.2 support (get rid of the deprecated message in the Front_Assets class)

= 3.7.9 (2025-01-13) =
- Improved WP Interactivity Api support in block themes

= 3.7.8 (2024-12-07) =
- WP 6.7: fixed PHP notice - _load_textdomain_just_in_time was called incorrectly
- WP 6.7: added support for the new Interactivity API path
- Improved compatibility with the SiteGround Optimizer plugin

= 3.7.7 (2024-11-12) =
- View & Card: made the ajax 'View' selector compatible with latest ACF.
- Editor: made the toggle bar icon visible

= 3.7.6 (2024-11-01) =
- Compatibility with WordPress 6.7
- Improved compatibility with themes that use laravel packages

= 3.7.5 (2024-10-18) =
- Views: fixed bug for items inside Gutenberg loop on the taxonomy archive pages
- UX improvements

= 3.7.4 (2024-09-13) =
- Improved Twig validation
- Fixed editor layout issue related to WP 6.6.2

= 3.7.3 (2024-08-21) =
- Improved Blade support
- Improved Rest Api support

= 3.7.2 (2024-08-01) =
- Shortcodes: improved naming
- View shortcode: added the 'post-slug' argument
- Internal improvements

= 3.7.1 (2024-07-22) =
- View: Post - added attachment link and attachment video fields
- WebComponent: Improved the shadow DOM type option
- Introduced the [Live Reload feature](https://docs.advanced-views.com/templates/live-reload)
- Libraries CSS improvement: turned to inline styles
- Minor enhancements

= 3.7.0 (2024-07-09) =
- Added [Blade template engine](https://docs.advanced-views.com/templates/template-engines/blade) support (as a Twig alternative)
- WP Taxonomy Terms field: fixed a visible label on the empty value

= 3.6.2 (2024-07-04) =
- Card: Fixed View ajax select-related issue
- WP 6.6 compatibility mark

= 3.6.1 (2024-06-21): =
- Card: fixed 'pages_amount' is missing for the 'Source: Page context'
- Translations: updated and added the Performant feature support 

= 3.6.0 (2024-06-19): =
- Card: added a new option to load posts from the page context (e.g. archive/author/category)
- ACF vendor: added the Icon field type support
- Markup generator: enhancement to use semantic div alternatives (section/p tags where it's relevant)
- Tailwind: [improved support](https://docs.advanced-views.com/templates/file-system-storage#tailwind-usage)
- UX improvements

= 3.5.3 (2024-05-31): =
- Minor improvements

= 3.5.1 (2024-05-23): =
- Added 'Enhanced compatible mode' setting to the Settings->Debugging tab
- Updated translations

= 3.5.0 (2024-05-21): =
- Added [WP Interactivity support](https://docs.advanced-views.com/templates/wordpress-interactivity-api)
- Added [Tailwind support](https://docs.advanced-views.com/templates/file-system-storage#tailwind-usage)
- Added support for Taxonomies without string titles
- Added Defaults tab in the settings
- Added a setting to control the class generation in the default template
- Fixed a custom-arguments shortcode-related bug when passed array via Bridge/View_Shortcode 

= 3.4.9 (2024-04-11): =
- Enhanced automatic field id generation: now a) uses field name instead of label b) converts non-English locales (on hosting with php-intl extension)
- Enhanced MetaBox OSM and Map field types support

= 3.4.8 (2024-04-02): =
- Fixed JS error on the plugins page

= 3.4.7 (2024-04-02): =
- UX improvements
- Introduced a new 'raw_value' property for oEmbed and other HTML-related fields

= 3.4.6 (2024-03-22): =
- Improved Twig scoping to avoid potential conflicts

= 3.4.5 (2024-03-21): =
- Performance improvements
- Improved compatibility with the 'wp_insert_post' wrong calls
- Minor improvements

= 3.4.1 (2024-03-07): =
- Added more pre-built components
- Meta fields import: fixed ACF group duplication instead of overriding
- Meta groups: improved 'add new' button behavior (now uses the general 'group' field)
- Minor improvements

= 3.4.0 (2024-03-04): =
- Added the [pre-build components](https://docs.advanced-views.com/templates/pre-built-components)
- Internal improvements
- Improved WP playground compatibility
- Readme update
- Image fields: added 'id' property

= 3.3.4 (2024-02-26): =
- Improved translations compatibility (round 2)

= 3.3.3 (2024-02-26): =
- Improved translations compatibility

= 3.3.2 (2024-02-25): =
- Added compatibility with the 'Plain' permalink structure
- Added 6 translations (ES, DE, IT, FR, RU, JA)

= 3.3.0 (2024-02-22): =
- Updated codebase to the WordPress coding standards
- Introduced logging (the Debugging tab in the Settings)
- View & Card: added the 'shadow-dom' option to the [web component setting](https://docs.advanced-views.com/templates/css-and-js#web-components-for-js-code)

= 3.2.3 (2024-02-10): =
- Internal improvements
- Fixed the pre-publish popup styles bug

= 3.2.0 (2024-02-08): =
- Improved compatibility with the WordFence plugin
- Removed auto-converting new-lines to br for the wysiwyg field
- Added workaround for the 'uncode' theme post_content corrupting bug
- Improved View/Card edit screen loading speed

= 3.1.2 (2024-01-31): =
- Shortcode: fixed object-id argument bug for websites with 'index.php' in permalinks
- Internal improvements
- List table: added the 'FS only' tab (for items present in the FS storage only)
- List table: added the 'Bulk validation' tab

= 3.1.1 (2024-01-29): =
- Select field: added 'choices' property
- Comment content field: auto converting '\n' to 'br'
- Plugin nav: fixed Docs link on localhost
- Date field: added 'timestamp' property
- FS storage: added permission issue warning

= 3.1.0 (2024-01-25): =
- Added Pods fields support

= 3.0.3 (2024-01-22): =
- WP Taxonomy term field: fixed field-related bug

= 3.0.2 (2024-01-19): =
- ACF: Textarea field improvement

= 3.0.1 (2024-01-18): =
- Fixed a shortcode bug in the Gutenberg query loop in the block template

= 3.0.0 (2024-01-17): =
- Removed 'ACF' dependency
- Added [file system option](https://docs.advanced-views.com/templates/file-system-storage) for template storage
- Added MetaBox fields support
- Added a [native way to render](https://docs.advanced-views.com/shortcode-attributes/common-arguments#id-2.-using-advanced-views-class) Views and Cards in PHP
