=== Consortia ShopKeys for Elementor ===
Contributors: tommyhansen21
Tags: elementor, woocommerce, product grid, favorites, product table
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 2.6.29
Requires PHP: 7.4
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Build better WooCommerce experiences in Elementor — including a simple Favorites system your customers can actually use.

== Description ==

ShopKeys gives you focused WooCommerce widgets for Elementor — without the bloat of large addon packs.

In addition to essential product layout widgets, ShopKeys includes a built-in Favorites system that lets customers save products they want to come back to.

This makes it easy to improve product discovery, encourage repeat visits, and build more useful shopping experiences directly inside Elementor.

---

== Build a Favorites experience (included in Free) ==

ShopKeys Free includes a lightweight Favorites system — no extra plugins required.

Let customers:
- Save products with a Favorite button  
- See how many items they’ve saved  
- View their saved products in a dedicated grid  

Includes:
- Favorite Button widget  
- Favorites Counter widget  
- “My Favorites” query for Product Grid  

Perfect for improving product discovery and bringing customers back to products they’re interested in.

---

== Free Widgets ==

ShopKeys Free includes practical WooCommerce building blocks for Elementor:

- Product Grid: Show products in responsive layouts  
- Category Grid: Display WooCommerce categories with images and content  
- Product Field: Output SKU, stock, brands, categories, and more  
- Product Price: Style regular and sale prices  
- Star Rating: Show product ratings  
- Cart Button: Add-to-cart with quantity support  
- Favorite Button: Save products for later  
- Favorites Counter: Display saved product count  

---

== Built for real WooCommerce stores ==

ShopKeys works best if you:

- build WooCommerce layouts in Elementor  
- want cleaner product sections and grids  
- need simple product discovery improvements  
- want to add Favorites without extra setup  

---

== Screenshots ==
1. ShopKeys widgets in the Elementor panel.
2. Product Grid widget used to build a product listing layout.
3. Category Grid widget used to highlight WooCommerce categories.
4. Product page example with Cart Button, Favorite Button, Product Price, and Product Field.
5. Favorites Counter together with a Product Grid showing saved favorite products.
6. ShopKeys admin in the free version.

---

== ShopKeys Pro ==

ShopKeys Pro is designed for stores that want to go beyond layouts and improve how customers browse, compare, and buy.

---

=== Faster shopping and better product experience ===

- Product Table for bulk and fast ordering  
- Product Filters Bar for better navigation  
- Quick View for faster product exploration  
- Product Images and display enhancements  
- Category Carousel and layout tools  

---

=== Turn Favorites into insights ===

ShopKeys Pro adds insights on how customers interact with your products:

- See which products are saved most often  
- Track trends over time  
- Understand interest before purchase  

This helps you:
- identify demand earlier  
- improve merchandising decisions  
- optimize campaigns and product placement  

---

== Requirements ==

- Elementor must be installed and activated.
- WooCommerce must be installed and activated.
- PHP 7.4 or newer is recommended.

---

== Installation ==

= Upload in WordPress =
1. Download the plugin zip.
2. Go to Plugins > Add New.
3. Click Upload Plugin.
4. Choose the ShopKeys zip file.
5. Click Install Now, then Activate.

= Manual installation =
1. Download the plugin zip.
2. Extract the zip file.
3. Upload the `consortia-shopkeys` folder to `wp-content/plugins/`.
4. Activate ShopKeys from the Plugins screen.

---

== Frequently Asked Questions ==

= Do I need Elementor? =
Yes. ShopKeys is built for Elementor and requires Elementor to be active.

= Do I need WooCommerce? =
Yes. ShopKeys is made specifically for WooCommerce stores.

= Can I use Favorites in the free version? =
Yes. ShopKeys Free includes Favorite Button, Favorites Counter, and “My Favorites” query support.

= Is there a Pro version? =
Yes. ShopKeys Pro adds advanced WooCommerce features like product tables, filters, quick view, and Favorites insights.

---

== Changelog ==

= 2026-06-15 - version 2.6.29 =
* Improved - Added an optional Product Grid favorite button overlay for image items, positioned in the top right corner by default.
* Improved - Updated the ShopKeys admin to use the refreshed ShopKeys logo asset.
* Improved - Trimmed the public readme to keep the WordPress.org listing lighter and easier to scan.

= 2026-06-08 - version 2.6.28 =
* Fix - Replaced the legacy `new $wp_query(...)` category count query with a proper `WP_Query` implementation for better compatibility.
* Fix - Prefixed the remaining Favorites schema option and cached term transient names for the WordPress.org package, while keeping legacy fallback support.
* Fix - Removed the old temporary term cache global from helper logic to keep the free package cleaner and more predictable.

= 2026-06-02 - version 2.6.27 =
* Improved - Stabilized the Product Images widget with cleaner main image/thumbnails controls, safer autoplay timing controls, and better editor behavior.
* Improved - Added a dedicated transition speed control for Product Images effects and autoplay.
* Improved - Automated Pro JavaScript minification during package builds so `.min.js` assets stay in sync for release packages.
