=== Quote Calculation System ===
Contributors: bikram_sth
Donate link: http://bikramkaji.com.np/
Tags: quote, vehicle rental, booking, hourly rate, reservation
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A modern, secure vehicle quote calculator with a quote request system. Customers request quotes, and admins confirm pricing.

== Description ==

Quote Calculation System is a comprehensive tool for vehicle rental and transfer businesses. It allows customers to request quotes based on vehicle hourly rates and flexible pickup/drop-off locations. 

**Version 2.0.0 is a complete modern rewrite!** It transitions from an instant-booking model to a professional **Quote Request System**. Direct PayPal integration has been removed to give administrators full control over pricing, duration verification, and offline payment collection.

= Key Features =
* **Quote Request System:** Customers submit their details and receive an estimated price. Admins review the request and confirm the exact price via email.
* **No Direct PayPal:** PayPal integration has been removed. This allows you to verify routes, adjust for traffic/duration, confirm the exact final price, and collect payments via your preferred method (bank transfer, cash, or manual PayPal invoices).
* **Flexible Text-Based Locations:** Customers can type in exact pickup and drop-off addresses instead of being restricted to a predefined dropdown list.
* **Vehicle-Centric Hourly Pricing:** Prices are calculated simply as `Hourly Rate × Duration`. No complex route matrices to manage.
* **Database Booking Management:** All quote requests are saved to the WordPress database under a dedicated "Bookings" menu. Never lose a lead!
* **Automated Email Notifications:** 
  * Admins receive an instant email with all booking details.
  * Customers receive a confirmation email upon submission.
  * Customers receive automated email updates when you change the booking status (e.g., from "Quote Requested" to "Confirmed" or "Paid").
* **Modern & Secure Architecture:** Built using native WordPress Custom Post Types. 100% jQuery-free, fully sanitized, and compliant with the latest WordPress.org security standards.
* **Backward Compatible:** Your old `[quote-system]` shortcodes still work perfectly.

= How It Works =
1. **Add Vehicles:** Go to Vehicles > Add New. Set the vehicle name, upload a featured image, and set the Hourly Rate.
2. **Customer Requests Quote:** The customer fills out the form with their pickup/drop-off addresses, date, and estimated duration.
3. **Admin Reviews:** You receive an email and can view the request in your WordPress Dashboard under "Bookings".
4. **Confirm & Collect:** You contact the customer with the final price, update the booking status to "Confirmed" or "Paid", and collect payment offline.

== Installation ==

1. Upload the `quote-calculation-system` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Navigate to **Vehicles** in your admin sidebar to add your fleet and set their hourly rates.
4. Go to **Settings > Quote System** to configure your Currency Symbol and Receiver Email Address.
5. Create a new page and add the shortcode `[qcs_calculator]` (or the legacy `[quote-system]`).

== Frequently Asked Questions ==

= What happened to the PayPal integration? =
In version 2.0.0, direct PayPal integration was intentionally removed. This change was made to transition the plugin into a **Quote Request System**. By removing instant payments, administrators can manually verify the customer's route, adjust the duration if necessary, confirm the exact final price, and collect payment via their preferred method without the risk of undercharging or dealing with complex API refunds.

= Will my old shortcodes still work? =
Yes! The plugin is fully backward compatible. The legacy shortcodes `[quote-system]`, `[quote-system-processing]`, and `[quote-system-reservation]` have been mapped to the new smart multi-step form. You only need to use `[qcs_calculator]` or `[quote-system]` on your page.

= Will updating delete my old vehicles and locations? =
Version 2.0.0 uses a modern Custom Post Type architecture instead of custom database tables. You will need to re-add your vehicles using the new "Vehicles" menu in your WordPress dashboard. Your old database tables will simply be ignored.

= Do customers need to know the exact duration? =
No. The form includes a helpful guide for typical durations. Customers provide an *estimated* duration to generate a baseline price. As the admin, you review the request and confirm the exact final price with the customer before payment.

== Screenshots ==

1. Frontend quote request form with helper text.
2. Vehicle selection step showing estimated prices.
3. Customer details submission form.
4. Admin dashboard showing the Bookings list.
5. Booking details meta box in the WordPress admin.
6. Vehicle management screen with hourly rate settings.
7. Plugin settings page.

== Changelog ==

= 2.0.1 =
* Removed directory assets from plugin code as per WordPress.org guidelines.

= 2.0.0 =
* **MAJOR REWRITE:** Complete architectural overhaul for WordPress.org compliance and PHP 8+ compatibility.
* **REMOVED:** Direct PayPal integration to support the new Quote Request workflow.
* **ADDED:** Automated status update emails. When an admin changes a booking's status, the customer receives an email notification.
* **ADDED:** Database saving for all bookings to prevent lost leads.
* **IMPROVED:** Changed frontend location fields from dropdowns to flexible text inputs, allowing customers to enter exact addresses.
* **IMPROVED:** Replaced complex location-rate matrices with simple Vehicle-Centric Hourly Pricing.
* **IMPROVED:** Removed all jQuery dependencies for lightning-fast page loads.
* **SECURITY:** Fixed critical security vulnerabilities (SQL injection, XSS, CSRF) by implementing strict input sanitization, output escaping, and nonce verification.
* **SECURITY:** Full compliance with the official WordPress Plugin Check (PHPCS).

= 1.3 =
* Legacy version. Issue while adding database in admin fixed. Minor bugs fixed.

= 1.0 =
* Initial release of the Quote Calculation System.

== Upgrade Notice ==

= 2.0.0 =
This is a major architectural rewrite. It removes direct PayPal integration in favor of a flexible Quote Request system, adds automated status update emails, and allows customers to type in exact addresses. Please review your booking workflow and re-add your vehicles in the new admin interface.

== Privacy Policy ==

Quote Calculation System uses [WordPress' native Custom Post Types](https://developer.wordpress.org/plugins/post-types/) to store quote requests. 

When a customer submits a quote request, the following data is saved to the WordPress database:
* Customer Name
* Customer Email Address
* Customer Phone Number
* Pickup and Drop-off Locations
* Requested Duration and Estimated Price

This data is stored securely in the WordPress database and is only accessible to site administrators. No data is sent to external third-party servers.
