=== 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, shortcodes, elementor, divi, bricks, layout
Requires at least: 5.5
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 3.8.4
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 craft layouts and selections that you miss, without bloatware or heavy dependencies.

✅ **Solid by design**: craft modular and reusable layouts. Eliminate replications, style conflicts, and avoid 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, customizing your block-based theme, Advanced Views makes it easier for you 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 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. Layouts list managed using the familiar interface.
2. Get a basic setup in seconds with Demo import.
3. Assign multiple fields to Layouts.
4. The default template can easily be customized.
5. Query items with Post Selections and display using the selected Layout.
6. Posts can be filtered, sorted and styled.
7. Import and Export Tool helps with site migration.
8. Tools for Import and Export.

== 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 ==

= Can I display fields from user profile, taxonomy term or options page? =

Advanced Views supports all the field sources provided by your chosen meta vendor.

For example, if you're using ACF (Advanced Custom Fields), you can access fields from option pages, user profiles, terms, comments, and menus.

You can refer to the [documentation](https://docs.advanced-views.com/getting-started/supported-data-vendors) for the specific list of supported field sources for your meta vendor.

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

= 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.8.4 (2025-03-10) =
- Enhance: $_GET support for custom Ajax requests

= 3.8.3 (2025-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