=== Consortia ShopKeys for Elementor ===
Contributors: tommyhansen21
Tags: elementor, woocommerce, product grid, favorites, wishlist
Requires at least: 6.0
Tested up to: 7.1
Stable tag: 2.6.35
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 ==

Build better WooCommerce shopping experiences in Elementor without installing a huge addon pack.

ShopKeys gives you focused WooCommerce widgets for product layouts, favorites, recently viewed products, and easier product discovery.

Use it to help shoppers find products faster, save products they like, and return to products they have already viewed.

= Help customers find the right products =

Create flexible WooCommerce layouts directly in Elementor with widgets for:

- Product grids
- Category grids
- Product prices
- Ratings
- Product information
- Add-to-cart buttons

Build cleaner product sections without relying on large Elementor addon bundles.

= Let shoppers save products for later =

ShopKeys Free includes a built-in Favorites system.

Customers can:

- Save products with a Favorite button
- See how many products they have saved
- View saved products in a dedicated product grid

No separate wishlist plugin required.

Favorites can help shoppers keep track of products they are considering and make it easier to return later.

= Bring shoppers back to products they viewed =

Visitors often browse several products before deciding what to buy.

ShopKeys includes:

- Recently Viewed query for the Product Grid
- Recently Viewed Peek widget

Use them to surface products a shopper has already explored and make it easier to continue browsing.

= Included in ShopKeys Free =

- **Product Grid** - Create responsive WooCommerce product layouts
- **Category Grid** - Display product categories with images and content
- **Product Field** - Show SKU, stock, brands, categories, and other product data
- **Product Price** - Style regular and sale prices
- **Star Rating** - Display product ratings
- **Cart Button** - Add products to the cart with quantity support
- **Favorite Button** - Let shoppers save products
- **Favorites Counter** - Show the number of saved products
- **Recently Viewed Peek** - Give shoppers quick access to recently viewed products

= Built for WooCommerce stores using Elementor =

ShopKeys is useful if you want to:

- Build better WooCommerce layouts in Elementor
- Improve product discovery
- Add Favorites without another plugin
- Help shoppers return to recently viewed products
- Keep your Elementor setup focused and lightweight

= Need more? =

ShopKeys Pro adds tools for stores that want to improve product browsing, ordering, and merchandising even further.

Pro features include:

- Product Table for faster and bulk ordering
- Product Filters Bar
- Quick View
- Cart Peek
- Product image enhancements
- Category Carousel
- Advanced layout tools
- Favorites insights and product interest data
- Abandoned cart and left-behind product insights

== Requirements ==

- Elementor
- WooCommerce
- PHP 7.4 or newer recommended

---

== Like ShopKeys? ==

If ShopKeys helps you build better WooCommerce layouts in Elementor, please consider leaving a review on WordPress.org. Reviews help other store owners discover the plugin and help us keep improving it.

== Support ==

For help with the free version, please use the WordPress.org support forum for this plugin.

---

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

---

== 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-08-19 - version 2.6.35 =
* Improved - Updated WordPress compatibility to 7.1 and refreshed the WordPress.org description, support, and review messaging.
* Improved - Changed the default Recently Viewed Peek offset to use pixels for more predictable placement on smaller screens.
* Improved - Tightened the WordPress.org package so Free builds only include Free runtime modules.

= 2026-06-30 - version 2.6.34 =
* New - Added a new Pro `Abandoned` admin tab with first-phase abandoned cart insights, including top abandoned products, recoverable carts, estimated lost revenue, and a configurable abandoned-cart timing threshold.
* Improved - Added Favorites styling controls to Product Grid and Product Table, including clearer icon-state styling for grid overlays and table favorite buttons.
* Improved - Refined Product Grid query UX so `Include Products` behaves as a real narrowing filter for source-based queries like Favorites and Recently Viewed.

= 2026-06-21 - version 2.6.33 =
* Fix - Restored favorite toggle clicks inside Recently Viewed Peek so the heart button works reliably inside the panel.
* Fix - Cart Peek now respects the configured visible item count after removing items and refills the panel correctly.

= 2026-06-19 - version 2.6.32 =
* Improved - Refined Product Table and Product Grid sorting/paging layout controls so top-row spacing and alignment behave more predictably.
* Improved - Added clearer Product Grid editor labels and guidance for item height, item padding, and full card height controls.
* Improved - Added product link color controls to Recently Viewed Peek and Cart Peek, plus a smoother Cart Peek loading state when removing items.
* Fix - Product Table quantity now resets back to the configured default after add to cart, while bulk-order flows can still reset to zero.

= 2026-06-18 - version 2.6.31 =
* New - Added Cart Peek in Pro with live cart updates, subtotal, remove-item actions, and compact View Cart / Checkout access.
* Improved - Refined Recently Viewed Peek with add-to-cart support, cleaner action styling, and better layering behavior when used together with Cart Peek.
* Fix - Scoped ShopKeys tooltip initialization and strengthened add-to-cart handling in Cart Button and Quick View for more stable frontend behavior.

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