=== Advanced Views - Display Posts, Custom Fields, and More ===
Contributors: wplakeorg
Tags: WooCommerce, ACF, Meta Box, Posts, Query
Requires at least: 5.5
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 3.8.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Effortlessly display WordPress posts, custom fields, and WooCommerce data.

== Description ==

Advanced Views is a powerful, flexible tool that lets you **display posts, custom fields, and content from ACF, MetaBox, Pods, WooCommerce, and WordPress itself**.

Whether you're building a custom layout, creating dynamic templates, or designing advanced content displays, this plugin simplifies the process - without relying on bulky page builders.

==Why Choose Advanced Views?==

✅ **Display Posts & Custom Fields Anywhere** – Show posts, Custom Post Types (CPT), WooCommerce products, and metadata effortlessly.
✅ **Supports ACF, MetaBox, and Pods** – Retrieve and display data from [multiple field plugins](https://docs.advanced-views.com/getting-started/supported-data-vendors) with ease.
✅ **Solution for Everyone** – Perfect for site owners, developers, and designers who want full control over content display.
✅ **Smart, Lightweight, and Developer-Friendly** – Uses [Twig & Blade templates](https://docs.advanced-views.com/templates/template-engines) with automatic escaping, and [Just-in-Time assets strategy](https://docs.advanced-views.com/templates/css-and-js#id-1.1-just-in-time-assets) for smooth performance.

==🎨 One Plugin – Multiple Content Sources==

Advanced Views [seamlessly integrates](https://docs.advanced-views.com/getting-started/supported-data-vendors) with:

🔹 WordPress Posts & Pages
🔹 Custom Post Types (CPTs)
🔹 [WooCommerce](https://wordpress.org/plugins/woocommerce/) Products & Fields
🔹 [Advanced Custom Fields](https://wordpress.org/plugins/advanced-custom-fields/) (ACF)
🔹 [MetaBox](https://wordpress.org/plugins/meta-box/) & [Pods](https://wordpress.org/plugins/pods/) Fields

Whether you're crafting a blog, directory, or custom WooCommerce store, Advanced Views makes it easy to query and display dynamic content.

== 🚀 Powerful Features ==

High-quality results without the time-consuming steps.

**🔄 Smart Content Queries & Display**

🔹 Easily [display posts, custom fields](https://docs.advanced-views.com/getting-started/introduction/creating-your-first-view), and taxonomies with powerful [WP_Query enhancements](https://docs.advanced-views.com/getting-started/introduction/creating-your-first-card)
🔹 Filter, sort, and customize results with Twig or Blade templates.

**📌 Pre-Built Components for Quick Setup**

🔹 Use [ready-made components](https://docs.advanced-views.com/templates/pre-built-components) for fast and easy content structuring.
🔹 Includes meta fields, responsive CSS rules, and reusable templates.

**⚡ Streamlined Development Workflow**

🔹 **[Built-in Data Binding](https://docs.advanced-views.com/getting-started/introduction/key-aspects#id-3.1-built-in-data-binding) & [Template Generation](https://docs.advanced-views.com/getting-started/introduction/key-aspects#id-3.2-automated-template-generation)** – No need to manually convert field data.
🔹 **[File System Storage option](https://docs.advanced-views.com/templates/file-system-storage) & [Live Reload feature](https://docs.advanced-views.com/templates/live-reload)** – Works seamlessly with IDEs, Git, Sass, and TypeScript.

**🛠️ Simplified WordPress Queries**

🔹 Master WP_Query with [intuitive wrappers](https://docs.advanced-views.com/getting-started/introduction/key-aspects#id-4.-card-component) that make querying posts and fields easier.
🔹 Bulk template validation to keep everything running smoothly.

**📚 Extensive Documentation & Friendly Support**

🔹 [Step-by-step guides](https://docs.advanced-views.com/) to help you get started.
🔹 [Community forum](https://wordpress.org/support/plugin/acf-views/) for free support, plus [Pro version support](https://wplake.org/acf-views-support/) for premium users.

==🔓 Unlock More with Advanced Views Pro==

[Advanced Views Pro](https://advanced-views.com/pro/) takes your content displays to the next level with powerful features designed for flexibility, interactivity, and efficiency:

✅ **Repeater, Group & Flexible Fields Support** - Display complex nested fields — including repeaters within repeaters and flexible content layouts.
✅ **Meta & Taxonomy Filters** - Powerful backend filters based on custom fields and taxonomies.
✅ **AJAX Pagination** - Improve user experience by loading new content pages seamlessly without full page reloads.
✅ **Sliders & Gallery Field Integration** - Assign slider and gallery fields directly in your Views, enabling slick interactive carousels and image galleries out of the box.
✅ **Custom Data Integration** - Inject additional PHP variables into templates for more tailored content outputs beyond the standard fields.
✅ **Custom Gutenberg Blocks** - Turn any View into a reusable Gutenberg block, making it simple to insert dynamic content inside the block editor.
✅ **Reusable Component Libraries** - Build and manage a library of reusable components to maintain design consistency and speed up site building.

== 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://wplake.org/advanced-views-pro/).
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://wplake.org/acf-views-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.2 (2025-11-17) =
- 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