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

WooCommerce widgets for Elementor with product grid, category grid, cart button, favorites, wishlist, and recently viewed products.

== Description ==

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

Build product grids, category grids, product detail sections, and add-to-cart experiences faster inside Elementor.

ShopKeys also includes a built-in favorites and wishlist flow that lets customers save products for later and return to them more easily.

It also adds recently viewed product features, including a dedicated query source and a compact side peek widget for bringing shoppers back to products they have already explored.

This helps improve product discovery, encourage repeat visits, and create more useful WooCommerce shopping experiences.

---

== Build a Favorites / Wishlist 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.

---

== Add Recently Viewed products (included in Free) ==

ShopKeys Free also helps stores surface products a visitor has already looked at.

Includes:
- `Recently Viewed` query for Product Grid
- Recently Viewed Peek widget

This is useful on product pages and other shopping flow areas where returning to recent products can improve browsing and help customers pick up where they left off.

---

== 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  
- Recently Viewed Peek: Show recent products in a compact side drawer  

---

== 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 and Recently Viewed 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. Recently Viewed Peek open on a product page.
7. 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-17 - version 2.6.30 =
* New - Added Recently Viewed support in Free, including a shared query source and the new Recently Viewed Peek widget.
* Improved - Stabilized Product Grid and Product Table query handling when max product count is used.
* Improved - Refined top-row spacing controls for sorting and paging, especially for mobile layouts.

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

= 2026-05-18 - version 2.6.23 =
* Fix - Prevented duplicate bootstraps from breaking updates when an old plugin folder still exists alongside the current ShopKeys folder.
* Fix - Guarded ShopKeys constants so update edge cases do not trigger redefinition warnings or wrong include paths.

= 2026-05-17 - version 2.6.22 =
* Fix - Restored Category Carousel visibility and Box Placement behavior after recent styling changes.
* Fix - Tightened Category Carousel isolation from shared grid CSS for more predictable images, overlay text, and spacing.

= 2026-05-16 - version 2.6.21 =
* Improved - Added Product Grid column height and pagination alignment controls.
* Improved - Improved Product Filters Bar button labels and button styling behavior.
* Improved - Refined Product Images left layout controls, image resolution options, and fit behavior.

= 2026-05-15 - version 2.6.20 =
* Fix - Restored Product Filters Bar category and attribute option rendering so dropdown results are shown correctly again.
* Fix - Improved Product Filters Bar Select2 dropdown positioning for frontend and Elementor editor contexts.
* Improved - Refined Product Filters Bar toggle and action button styling for better alignment and responsiveness.

= 2026-05-15 - version 2.6.19 =
* Improved - Adjusted the Pro Freemius bootstrap to follow the premium `set_basename` pattern more closely during activation and upgrades.
* Improved - Prepared a safer ShopKeys upgrade path when Free and Pro basenames need to be reconciled by the SDK.

= 2026-05-15 - version 2.6.18 =
* Improved - Moved ShopKeys admin CSS and notice-handling script into shared local assets for cleaner Free and Pro admin pages.
* Improved - Made the ShopKeys admin notice relocation more robust so third-party notices stay out of the hero area.

= 2026-05-15 - version 2.6.17 =
* Improved - Moved the Freemius SDK to `vendor/freemius` to align ShopKeys with the packaging pattern used in our release flow.
* Improved - Updated the Pro Freemius bootstrap for the new ShopKeys slugs, PRO premium suffix, and packaged SDK path.

For a more complete release history, see the bundled `changelog.txt` file in the plugin package.
