=== KAAAH Car Finder ===
Contributors: benign01
Tags: car finder, car selector, car chooser, car buying, automotive
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later

Add the independent KAAAH UK car-matching widget to WordPress using a block or shortcode.

== Description ==

KAAAH Car Finder gives visitors a clear route into KAAAH's independent UK personalised car-matching service. Add it with the KAAAH Car Finder block or the `[kaaah_car_finder]` shortcode.

Customers answer 56 detailed questions about their driving, journeys, budget, comfort, performance and practical requirements. KAAAH then provides three detailed recommendations, five further alternatives and version-level buying guidance.

The plugin's display script is bundled locally. It does not collect questionnaire answers or personal information on the WordPress site. When a visitor chooses to start, they leave the WordPress site and continue on kaaah.co.uk.

== Screenshots ==

1. Add and customise the KAAAH Car Finder block in the WordPress editor.
2. The finished responsive car-finder widget as visitors see it.
3. Optional partner-code settings and shortcode instructions.

== Installation ==

1. Upload the plugin ZIP under Plugins > Add New > Upload Plugin.
2. Activate KAAAH Car Finder.
3. Open Settings > KAAAH Car Finder.
4. Optionally enter a referral code supplied by KAAAH. The widget also works without one.
5. Add the KAAAH Car Finder block, or use [kaaah_car_finder].

The questionnaire, payment and customer report remain securely on kaaah.co.uk. The plugin does not collect questionnaire answers or personal information. Its display code is bundled inside the plugin; it does not download executable code from KAAAH.

== External service ==

When a visitor clicks the widget, they are taken to https://kaaah.co.uk/ to use the KAAAH car-matching service. If the site owner has entered a partner code, that code is included in the destination URL so KAAAH can attribute the active browser-tab visit and any verified purchase. See https://kaaah.co.uk/partners/terms/ for partner terms.

== Frequently Asked Questions ==

= Do I need a KAAAH partner code? =

No. The widget works without a partner code. A code is only needed if you have joined the KAAAH partner programme and want eligible purchases attributed to you.

= Does the plugin collect visitor information? =

No. The plugin does not collect questionnaire answers or personal information on your WordPress site. Visitors continue to kaaah.co.uk when they choose to start.

= Can I change the button text or appearance? =

Yes. The block includes light and dark themes and editable button text. Shortcode users can set the `theme` and `button` attributes.

= Is the car-matching report free? =

Visitors can complete the questionnaire and see their initial match before deciding whether to purchase the full report. Current pricing is shown on kaaah.co.uk.

== Changelog ==

= 1.1.0 =
* Bundled the widget display script locally for WordPress.org compatibility.
* Made the partner referral code optional.
* Updated the displayed one-time customer price to £4.99.

== Shortcode options ==

[kaaah_car_finder]

[kaaah_car_finder theme="dark" button="Find my ideal car"]
