=== 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.0
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.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
