=== SudsQuote – Cleaning Price Calculator & Lead Manager ===
Contributors: anishfromnepal
Tags: cleaning, quote calculator, price calculator, lead generation, estimate
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Instant cleaning price calculators for your website. Visitors get a price in seconds; you get their details as a lead.

== Description ==

SudsQuote turns your WordPress site into a quoting tool for your cleaning business. Visitors answer a few questions (property type, bedrooms, bathrooms, extras) and see an instant estimate. When they request a quote, their details arrive in your dashboard and your inbox.

Everything in this plugin is free and fully functional. There are no locked features, licence keys or usage limits.

= What you can do =

* **Instant price calculators** – multi-step, mobile-friendly calculators for domestic, deep and end-of-tenancy cleaning, or build your own.
* **Flexible pricing** – base price, per bedroom, per bathroom, per square metre or hourly pricing, fixed or percentage extras, minimum booking price and VAT.
* **Conditional logic** – show questions and adjust prices based on earlier answers.
* **Lead inbox** – every quote request is saved with the full price breakdown. Filter, search, add notes, change status and export to CSV.
* **Customers & quotes** – turn a lead into an itemised quote, email it, and let the customer accept or decline online.
* **WhatsApp follow-up** – one-click “Chat on WhatsApp” links for each lead.
* **Simple analytics** – views, estimates and leads for each calculator.
* **Built-in spam protection** – honeypot, timing check and rate limiting, with no CAPTCHA service needed.
* **Privacy tools** – consent checkbox, and support for WordPress personal data export and erasure.
* **Block and shortcode** – add a calculator with the “SudsQuote Calculator” block or `[sudsquote id="1"]`.

= Quick setup =

After activation, a short setup wizard asks for your business name, lead email and currency, lets you pick a starter calculator, and can create a draft “Get a Quote” page for you.

== Installation ==

1. In your WordPress admin go to Plugins → Add New, search for “SudsQuote” and click Install, then Activate. (Or upload the ZIP under Plugins → Add New → Upload Plugin.)
2. The setup wizard opens automatically. Enter your business details and choose a starter calculator.
3. Review the prices under SudsQuote → Calculators.
4. Publish the quote page the wizard created, or add the “SudsQuote Calculator” block or the `[sudsquote id="1"]` shortcode to any page.
5. Submit a test quote to see how leads arrive.

== Frequently Asked Questions ==

= Is everything free? =

Yes. All features in this plugin work without a licence, account or payment.

= Can I have more than one calculator? =

Yes. Create as many calculators as you like and put each one on a different page.

= Can I change the questions and prices? =

Yes. Every question, option and price can be edited in the calculator builder, with a live preview.

= Which currencies are supported? =

Any. Choose a currency in the setup wizard or under SudsQuote → Settings → General.

= Do I need to know how to code? =

No. Everything is set up from the WordPress admin.

= Where is my data stored? =

In your own WordPress database. SudsQuote does not send lead or customer data to any external service.

== External services ==

SudsQuote does not connect to any external service by itself.

WhatsApp links: on the Leads screens, SudsQuote can show a “Chat on WhatsApp” link that points to https://wa.me/ with the lead’s phone number and a pre-filled message. Nothing is sent to WhatsApp unless an administrator clicks the link, which opens WhatsApp in their browser. WhatsApp is provided by WhatsApp LLC / Meta: [Terms of Service](https://www.whatsapp.com/legal/terms-of-service), [Privacy Policy](https://www.whatsapp.com/legal/privacy-policy).

== Source code ==

All JavaScript and CSS in this plugin is shipped as human-readable source. There is no build step and no minified or compiled code. The block editor script is `blocks/index.js`.

== Screenshots ==

1. The setup wizard.
2. A calculator on the front end with a live price.
3. The dashboard with the getting-started checklist.
4. The calculator builder with live preview.
5. The lead inbox.

== Changelog ==

= 1.0.1 =
* Fix: the calculator no longer shows a "Please complete the required field" error before the visitor has answered, and old error messages clear once the price updates.
* Fix: required questions are now checked on every step with a clear message under the question (previously conditional rules could silently remove the "required" setting).
* Fix: selected answer buttons now highlight when clicked.
* Fix: "Show field" rules now keep the field hidden until the rule matches, and answers to hidden questions no longer change the price.
* Fix: VAT now appears as a line in the price breakdown so the lines add up to the total.
* Fix: calculators keep working on sites that use page caching (fresh security token on load, automatic retry).
* Fix: editing a calculator no longer resets its cleaning category to "Domestic".
* Fix: the Conditional Logic panel only shows on the "Design & Rules" step of the builder.
* Fix: builder live preview now applies conditional rules.
* Fix: fixed-amount and percentage question prices are only charged when the question is answered (not for "No" or 0).
* Fix: area, bedroom and bathroom questions with custom names are priced correctly; calculators without those questions are no longer charged for them.
* New: +/- counters for bedroom, bathroom and number questions.
* New: "Price per answer option" pricing — set a price or percentage on each option (value|Label|25 or value|Label|10%).
* New: Pricing step can switch the main pricing method (rooms, square metres, hourly or base fee only) and edit condition, property type, frequency and extras prices.
* Improved: Office, Airbnb, Carpet, Window and Garden templates now price every question.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.1 =
Fixes several calculator bugs (false required-field errors, answer highlighting, VAT line, conditional rules, page-cache compatibility). Recommended for all users.

= 1.0.0 =
Initial release.
