=== WebSync Checkout for Elementor ===
Contributors: websynctech
Tags: woocommerce, elementor, product grid, mini cart, my account
Requires at least: 6.0
Tested up to: 7.1
Stable tag: 1.2.1
Requires PHP: 7.4
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Build WooCommerce product, cart, checkout, order confirmation, mini cart, and My Account layouts with Elementor.

== Description ==

WebSync Checkout for Elementor is a WooCommerce page-builder toolkit for the free Elementor plugin. It provides dedicated widgets for products, product archives, single products, mini carts, carts, checkout, order confirmation, and customer accounts.

The widgets customize presentation while WooCommerce continues to handle product data, cart totals, coupons, shipping, taxes, checkout validation, payments, orders, authentication, and customer permissions.

Elementor Pro is not required. WooCommerce and Elementor must be installed and active.

= Included Elementor widgets =

* **Products Grid:** Display latest, featured, on-sale, best-selling, top-rated, category, tag, or manually selected products.
* **Archive Title:** Display the current WooCommerce shop, product-category, or product-tag archive title.
* **Archive Description:** Display the current product archive description.
* **Archive Products:** Render WooCommerce's current archive query with result count, ordering, product cards, and pagination.
* **Single Product:** Present a complete WooCommerce product inside an Elementor page.
* **Menu Cart:** Add a live header cart using a side cart or dropdown layout.
* **Cart:** Build a responsive cart page with coupons, cross-sells, shipping, and totals.
* **Checkout:** Customize customer fields, shipping, order review, coupons, terms, gateways, and the place-order area.
* **Order Confirmation:** Style the verified WooCommerce order-received and Thank You experience.
* **My Account:** Design login, registration, account navigation, orders, downloads, addresses, payment methods, and account details.

= Highlights =

* Responsive product grids with six query sources, taxonomy filters, ordering, sorting, and pagination
* Native WooCommerce product cards, archive queries, and AJAX add-to-cart behavior
* One-column or two-column Cart and Checkout layouts with optional sticky summaries
* Native coupons, shipping, taxes, totals, gateways, terms, and order processing
* Side Cart and Mini Cart Dropdown modes with WooCommerce cart fragments
* Automatic cart quantity and totals updates
* Verified order confirmation with payment details, items, downloads, and addresses
* Complete WooCommerce login, registration, password reset, and customer account endpoints
* Detailed Elementor content, style, and responsive controls
* Anonymized editor previews that do not expose customer or administrator data

= Free companion addon =

The optional [WebSync WooCommerce Builder Addon](https://websync.tech/woo-addons-for-elementor/) is available as a free separate download. It adds Conversion Split, Multi-Step, and Accordion checkout skins plus reusable Single Product and Product Archive templates with Include and Exclude display conditions.

The addon is not required for the widgets or the Default Cart and Checkout skins included in this plugin.

= Built for WooCommerce compatibility =

* Uses WooCommerce templates, hooks, nonces, cart fragments, and checkout events
* Loads widget assets only when required by the current Elementor document
* Preserves existing WebSync widget settings when an addon skin is unavailable
* Provides versioned Core and skin APIs for compatible extensions
* Keeps the WebSync WooCommerce widget group easy to find in Elementor
* Does not load frontend scripts, styles, fonts, or executable code from third-party services

== Screenshots ==

1. Build a complete WooCommerce shopping journey with focused widgets in the Elementor editor.
2. Style a responsive Products Grid with images, ratings, sale pricing, badges, and add-to-cart buttons.
3. Design a two-column Cart with products, coupons, shipping, totals, and checkout actions.
4. Customize Checkout customer fields, order review, shipping, gateways, and the purchase button.
5. Brand the My Account experience with navigation, account endpoints, orders, and customer actions.
6. Create a clear Order Confirmation with the order overview, details, address, and next actions.

== Installation ==

1. Install and activate WooCommerce and Elementor.
2. Install **WebSync Checkout for Elementor** through **Plugins > Add New**, or upload it to `/wp-content/plugins/websync-checkout-for-elementor`.
3. Activate the plugin.
4. Edit the required page with Elementor and add widgets from the **WebSync WooCommerce** section.
5. Remove an existing WooCommerce block or shortcode when it would duplicate the selected widget.
6. Assign the Cart, Checkout, and My Account pages under **WooCommerce > Settings > Advanced**.
7. Test the full customer journey with the store's payment, shipping, tax, and account configuration before publishing.

For a standard checkout page, add both **Checkout** and **Order Confirmation**. Order Confirmation stays hidden during checkout and appears on WooCommerce's verified order-received endpoint.

== Frequently Asked Questions ==

= Does this plugin require Elementor Pro? =

No. It works with the free Elementor plugin. WooCommerce is also required.

= Does the plugin replace WooCommerce checkout or payment processing? =

No. The widgets customize layout and content. WooCommerce continues to process cart data, checkout validation, coupons, shipping, taxes, payments, and orders.

= Does it edit the WooCommerce Cart and Checkout Blocks? =

No. The Cart and Checkout widgets use WooCommerce's classic PHP templates and hooks. Remove the corresponding block when it would duplicate the widget output.

= Where should I add the Order Confirmation widget? =

Add it to the same assigned Checkout page as the Checkout widget. It renders only after WooCommerce verifies an order-received request. Its Elementor preview uses fixed sample data and never loads a real customer order.

= Is the Menu Cart a fast checkout? =

It is a quick-access mini cart, not a replacement checkout. Customers can review or remove items and continue to the Cart or Checkout page.

= Does the Menu Cart update after AJAX add to cart? =

Yes. It uses WooCommerce cart fragments and add-to-cart events to update its item count, subtotal, products, and actions.

= Where should I add the My Account widget? =

Add it to the page assigned under **WooCommerce > Settings > Advanced > My account page**. Remove the `[woocommerce_my_account]` shortcode if it would duplicate the output.

= Will WooCommerce extensions work? =

The plugin preserves standard WooCommerce hooks and native markup. Extensions that replace templates or output custom fields, endpoints, gateways, or product types may require additional styling. Test extension-specific flows on a staging site.

= How do I get the additional checkout skins and Theme Builder? =

Download and activate the free [WebSync WooCommerce Builder Addon](https://websync.tech/woo-addons-for-elementor/). The link opens the WebSync website; this plugin does not download or install the addon automatically.

= What should I test before launch? =

Test product queries, cart quantities, coupons, taxes, shipping calculations, checkout validation, every enabled payment method, order confirmation, login, registration, password reset, account endpoints, and mobile layouts on a staging site.

== External services ==

Storefront widgets do not depend on WebSync services. The lifecycle requests described below are the plugin's only automatic connection to WebSync.

The editor contains links to `https://websync.tech/woo-addons-for-elementor/` for the optional free companion addon. No request is made to that site until an authorized user clicks the link. The linked page is used only to explain and download the addon. See the [WebSync privacy policy](https://websync.tech/privacy-policy/).

The plugin sends a lifecycle event to `https://api.websync.tech/` when it is activated or deactivated. Each request includes the plugin name, slug, version, and event type. The optional deactivation survey also includes the selected reason and comments when **Submit & Deactivate** is used; **Skip & Deactivate** sends only the lifecycle data. These requests do not include the site URL, administrator email, customer information, cart contents, or order data. See the [WebSync privacy policy](https://websync.tech/privacy-policy/).

== Privacy ==

The frontend widgets do not transmit personal data beyond the normal processing performed by WooCommerce and the store's configured payment, shipping, analytics, and marketing extensions. Editor previews use fixed sample information and do not query customer orders, read administrator customer data, or modify the administrator's cart.

External links and plugin lifecycle requests are documented in the External services section.

== Changelog ==

= 1.2.1 =

* Added Archive Title, Archive Description, and Archive Products widgets to the free Core plugin.
* Updated Theme Builder and premium-skin prompts for the free WebSync WooCommerce Builder Addon.
* Updated addon branding, download links, compatibility messaging, and documentation.
* Removed Display Conditions actions from Checkout, Cart, Order Confirmation, and My Account pages.
* Fixed empty carts redirecting the Elementor Checkout editor preview away from the page being edited.
* Added activation and deactivation lifecycle events, including deactivation without survey feedback.
* Preserved existing widget IDs and the Core API 1.2.0 extension contract for backward compatibility.

Older release history is available in `changelog.txt`.

== Upgrade Notice ==

= 1.2.1 =

Adds free archive widgets and updates compatibility with the free WebSync WooCommerce Builder Addon.

== Support ==

For support, visit https://websync.tech/contact/ and include the WordPress, WooCommerce, Elementor, plugin, and PHP versions with relevant error messages.
