=== Withdrawl — Right of Withdrawal Button ===
Contributors: withdrawl
Tags: woocommerce, returns, withdrawal, refund, ecommerce
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: MIT
License URI: https://opensource.org/licenses/MIT

Adds a floating Withdraw / Return button linking customers to your hosted Withdrawl portal for right-of-withdrawal requests.

== Description ==

This plugin adds a customisable button (floating, shortcode, or Gutenberg block) to your WordPress or WooCommerce site. The button opens your store's withdrawal portal, hosted by the Withdrawl service, where a customer can submit a request to withdraw from their purchase.

**Important:** no plugin can create, provide, automate or guarantee legal compliance. This plugin renders a button; the withdrawal handling, record keeping and customer notifications are performed by the Withdrawl service (see "External Services" below). Whether your business meets its obligations under EU Directive 2011/83/EU — as amended by Directive (EU) 2023/2673 — depends on your own processes, and you remain responsible for them. Please consult your own legal advisor.

= What this plugin does on your site =
* Renders the button on your storefront, with configurable label, colour and screen position
* Provides a `[withdrawl_button]` shortcode for placing the button inline in any page or post
* Registers a "Withdrawl Button" block for the block editor
* Adds a settings screen (Settings → Withdrawl) to enable/disable the button and configure appearance
* Detects your site domain so the button resolves your store without you copying an ID, with a manual Store ID override if you prefer

= What the Withdrawl service does =
The hosted service at withdrawl.eu provides the substantive functionality: a multi-language withdrawal form, automatic confirmation emails to the customer and merchant, a merchant dashboard listing every request with status tracking, a per-case audit record, and CSV export. A free plan is available; optional paid features are described at https://withdrawl.eu and are billed and enforced entirely by the service. Terms and privacy policy: https://withdrawl.eu/privacy

== Installation ==

1. Install the ZIP via Plugins → Add New → Upload Plugin, then Activate.
2. Create a free account at https://withdrawl.eu and enter your store website under Dashboard → Setup.
3. Visit Settings → Withdrawl and enable the button. Configure the label, colour and position if you wish.

== Frequently Asked Questions ==

= Does this plugin make my shop legally compliant? =
No. No plugin can do that. This plugin displays a button, and the linked Withdrawl service records and processes withdrawal requests for you. Meeting your legal obligations depends on your own business processes and how you handle each request. Consult a legal advisor if you are unsure.

= Do I need a Withdrawl account? =
Yes. The button links to a portal hosted by the Withdrawl service, so you need an account (a free plan is available) with your store website registered.

= Do I need to paste a Store ID? =
No. Once your website domain is registered in your Withdrawl dashboard, the button resolves your store automatically. The Store ID field remains as an optional override.

= Does this require WooCommerce? =
No. It works on any WordPress site, but it pairs naturally with WooCommerce stores.

= Does the plugin send data from my site? =
No. The plugin does not transmit any data from your WordPress installation. It only renders a link. Data is submitted by your customer's own browser, on the portal page, after they click the button.

== External Services ==

This plugin links to Withdrawl, a hosted withdrawal-management service operated by Mintagency OÜ (Estonia).

* What it is used for: hosting your store's withdrawal request form, notifying you and your customer by email, and storing the resulting records for your dashboard and audit trail.
* When data is sent: only when one of your customers clicks the button and submits the form on withdrawl.eu. The data they enter (order number, name, email address, and any optional details) is transmitted to and processed by the service at that point. The plugin itself sends nothing from your server.
* Service links: https://withdrawl.eu · privacy policy https://withdrawl.eu/privacy

== Screenshots ==

1. The floating Withdraw / Return button on a storefront.
2. The plugin settings screen (Settings → Withdrawl).
3. The hosted withdrawal form the button links to.

== Changelog ==

= 1.1.0 =
* The button resolves your store by your site's domain — no Store ID required.
* Store ID kept as an optional override.

= 1.0.0 =
* Initial release.
