Oscar Dispatch Waste Clearance Calculator

By bandzis

0+ active installationsVersion 1.9.18

Fast waste clearance & rubbish quote calculator with dynamic calendar, multi-currency (£/€/$), unlimited items & Stripe deposit checkout.

Description

Waste Clearance & Rubbish Removal Quote Calculator by Oscar is a modern, responsive, high-converting waste clearance quote and booking plugin built for waste carriers, rubbish clearance companies, junk removal operators, and local man-and-van businesses.

Embed the calculator anywhere on your WordPress site using the shortcode:
[waste_clearance_calculator] (or legacy [oscar_disposal_calculator])

🌟 Key Features

  • Itemized Waste Inventory & Multi-Category Search:

    • Add unlimited items and clearance services organized into custom categories (Living Room & Sofas, Appliances, Mattresses, Garden & Outdoor, Commercial Waste, etc.).
    • Smooth [-] [qty] [+] interactive quantity steppers with real-time reactive price calculation.
    • Instant search bar with categorized picker drawer and automatic item filtering.
    • Minimum callout fee threshold enforcement (e.g. min £60 threshold).
  • Airline-Style Dynamic Calendar & Time Slot Pricing:

    • Interactive rolling date carousel strip (airline booking style) with live day-by-day availability.
    • 3 visual arrival window slot cards: Morning (08:00 – 12:00), Afternoon (12:00 – 16:00), Evening (16:00 – 20:00).
    • Flexible dynamic pricing modifiers: adjust prices automatically for same-day callouts, peak weekend dates, or custom calendar dates.
  • Multi-Currency Support (GBP £, EUR €, USD $):

    • Native presets for British Pound (£ GBP), Euro (€ EUR), and US Dollar ($ USD).
    • Configure your currency symbol and ISO currency code directly in the WP Admin dashboard.
    • Seamless Stripe Elements integration processing transactions directly in your chosen currency (£, €, $).
  • Live Activity & Conversion Funnel Analytics:

    • Built-in visual funnel dashboard directly inside WP Admin (Views → Picked Items → Logistics & Date → Checkout Ready → Confirmed Bookings).
    • Discover your exact drop-off stages and live conversion rates over the Last 7 Days, Last 30 Days, or All Time.
    • Top Quoted Clearance Items: Instantly track customer demand by seeing which items are calculated most (sofas, mattresses, appliances, builders waste).
    • Total Quoted Value & Average Quote Size: Real-time visibility into the gross monetary pipeline generated by your website visitors.
    • Privacy-First & Lightweight: Uses an aggregated local daily database table (~50 KB/year). Zero page slowdown, zero external tracking cookies. Includes native GA4 event triggers.
  • Instant WhatsApp Quote & Inquiry Support:

    • Built-in WhatsApp quote button inside the item selection step (“Can’t find your item? Chat on WhatsApp”).
    • Converts customers with bulky, unusual, or bespoke items (pianos, construction rubble, hazardous waste) into instant chat leads.
  • Logistics & Floor Access Surcharges:

    • Postcode and street pickup address inputs with optional address autocomplete.
    • Floor level selector: Ground Floor, 1st Floor, 2nd Floor, 3rd+ Floor, High-Rise.
    • “Service Lift Available” toggle: Automatically waives stair surcharges when bulky items can be transported via lift!
  • Low-Friction Customer Booking:

    • Full Name, Phone Number (WhatsApp/SMS ready), and Email Address.
    • Access notes (gate code, parking instructions, entry obstacles).
    • Automated email notifications via wp_mail to customer (with itemized receipt) and fleet dispatcher.
  • Flexible Checkout & Payment Modes:

    • Quote / Inquiry Only: Zero-friction lead generation without upfront card collection.
    • Cash / Card to Driver on Collection: Customer books slot; driver collects payment upon arrival.
    • Stripe Online Payment: Integrated Stripe Elements v3. Admin can charge 100% full balance or a fixed deposit (e.g. £25 / €25 / $25 deposit online, remainder to driver).
  • Optional Oscar Smart Dispatching Fleet Sync:

    • 100% Optional Integration: The plugin is completely standalone by default. No data leaves your WordPress site unless you choose to connect.
    • If your company uses Oscar Smart Dispatching (https://oscardispatch.com), simply paste your private API Key in settings to automatically sync confirmed bookings directly into your live fleet dispatch board.
    • 15-Minute Abandoned Cart Win-Back: When connected, if a customer enters their phone number but drops off before paying, Oscar alerts your dispatch team with a 1-click WhatsApp recovery link.
  • WordPress.org Guidelines Compliance:

    • Includes an admin toggle to enable or disable the “Powered by Oscar Smart Dispatching” attribution badge.

External Services

This plugin can optionally connect to the following third-party / external services to provide specific functionalities:

  1. Stripe API & Stripe.js (Only used if Stripe payment mode is enabled by administrator)

    • Service Provider: Stripe, Inc.
    • Purpose: Facilitates secure online credit/debit card processing and upfront deposit payments on Step 3 of the calculator.
    • When Data Is Sent: Only when a customer fills in card details and submits a booking payment.
    • Data Transmitted: Card details are securely tokenized directly via Stripe Elements to Stripe’s PCI-DSS Level 1 servers. Customer name, email, order reference, and payment amount are transmitted to create and confirm the Stripe PaymentIntent.
    • Terms of Service: https://stripe.com/legal/consumer
    • Privacy Policy: https://stripe.com/privacy
  2. OpenStreetMap / Photon Geocoding API (Disabled by default – Requires explicit Admin Opt-in)

    • Service Provider: Komoot GmbH / OpenStreetMap contributors
    • Purpose: Provides optional real-time address search suggestions in Step 2 of the calculator.
    • When Data Is Sent: Only when the administrator explicitly enables the ‘OpenStreetMap / Photon Autocomplete’ option in plugin settings, and only as the customer types into the address input.
    • Data Transmitted: The partial text typed in the address field is sent to https://photon.komoot.io/ to return street suggestions. No personal identifiers or customer contact details are ever sent.
    • Terms of Service: https://www.komoot.com/terms-of-service
    • Privacy Policy: https://www.komoot.com/privacy
  3. Google Maps Places API (Disabled by default – Requires API Key)

    • Service Provider: Google LLC
    • Purpose: Provides optional Google Places address search if the administrator enters a Google Maps API Key in settings.
    • When Data Is Sent: Keystrokes in the address input field are sent to Google Places API to fetch address suggestions.
    • Terms of Service: https://cloud.google.com/maps-platform/terms
    • Privacy Policy: https://policies.google.com/privacy
  4. Oscar Smart Dispatching REST API (Disabled by default – Requires API Key)

    • Service Provider: Oscar Smart Dispatching (https://oscardispatch.com)
    • Purpose: Synchronizes confirmed bookings and optional abandoned leads with the operator’s Oscar Dispatch CRM fleet management portal.
    • When Data Is Sent: Only when the administrator enables Oscar Dispatch Integration in settings and provides their API key.
    • Data Transmitted: Booking details (reference, customer name, phone, email, address, items inventory, pricing) are transmitted securely to the operator’s Oscar Dispatch API endpoint.
    • Terms of Service: https://oscardispatch.com/terms
    • Privacy Policy: https://oscardispatch.com/privacy

Installation

  1. Upload the oscar-dispatch-waste-clearance-calculator folder to the /wp-content/plugins/ directory, or install the .zip file via Plugins -> Add New -> Upload Plugin.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Navigate to Oscar Disposal -> Settings in your WordPress dashboard to configure your items, pricing, payment mode, and email templates.
  4. Paste the shortcode [oscar_dispatch_waste_clearance_calculator] (or [waste_clearance_calculator]) into any page, post, or Elementor/Gutenberg block.

FAQ

How does the built-in Funnel Analytics work?

The calculator tracks 5 key milestones locally in your WordPress database: calculator views, items picked (Step 1), logistics reached (Step 2), checkout visits (Step 3), and confirmed bookings. It also reveals your top quoted clearance items and total monetary quote value without using third-party tracking cookies or slowing down page speed. You can filter by 7/30 days or reset test stats at any time from the admin dashboard.

Which currencies are supported?

The plugin supports British Pound (£ GBP), Euro (€ EUR), and US Dollar ($ USD) with full Stripe payment integration and currency symbol configuration in Oscar Disposal -> Settings -> 2. Pricing & Currency.

Do I need an Oscar Dispatch CRM account to use this plugin?

No. The plugin is 100% standalone and works right out of the box on any WordPress site without any external accounts. All bookings and leads are stored safely in your own WordPress database and emailed directly to your company email address. Syncing with Oscar Smart Dispatching (https://oscardispatch.com) is purely optional for fleets that want automated driver scheduling and live GPS dispatching.

How do I change the waste items and prices?

Go to Oscar Disposal -> Settings -> 1. Items & Pricing. You can add unlimited items, organize them under custom categories (e.g. “Sofas”, “Appliances”, “Mattresses”), set individual prices, choose icons, and enable or disable items at any time.

Is email address required from the customer?

Yes. A valid email address is required so the system can automatically send an instant booking confirmation, itemized inventory manifest, and payment receipt to the customer.

How does the 15-Minute Grace Period work for abandoned leads?

When a customer enters their phone number and selects items, the calculator registers a draft quote. The system waits 15 minutes (configurable in settings: 10, 15, 30, or 60 minutes). If the customer completes checkout, the timer is cleared and the job is confirmed. If they abandon checkout, Oscar Dispatcher alerts your team with a 1-click WhatsApp button to win back the booking.

Can I take fixed deposits with Stripe?

Yes. In Payment Settings, choose Stripe and select “Charge Fixed Deposit Online”. You can set any deposit amount (e.g. £25.00), and the customer is clearly notified that the remainder is payable to the driver.

Can I hide the “Powered by Oscar” link?

Yes. Under Settings -> 5. Appearance & Branding, you can turn the attribution badge on or off with a single checkbox.

Changelog

1.9.18

  • Funnel Conversion Analytics Logic: Standardized conversion percentages relative to total visitor traffic (eliminating confusing >100% ratios), added session deduplication to Step 3 quote analytics, and enforced physical funnel hierarchy consistency.

1.9.17

  • Robust Step 1 Interaction Tracking: Fixed hook triggers for calculator view and first item interaction so adding items on Step 1 immediately increments the engagement funnel and top quoted items, even if abandoned before Step 2.

1.9.16

  • Documentation & Feature Spotlight: Added full details for the built-in Live Activity & Conversion Funnel Analytics, demand item tracking, and local privacy-safe database architecture.

1.9.15

  • Manual Statistics Management: Operators can now delete stats older than 30 days, older than 90 days, or reset all activity statistics with 1 click directly from the Funnel header.

1.9.14

  • Live Activity & Conversion Funnel Dashboard: Real-time insights right on the admin Bookings & Leads screen showing calculator views, engaged visitors (items selected), logistics reached, checkout visits, and total quote values.
  • Popular Items Analytics: Real-time tracking of top quoted clearance items so operators immediately see customer demand.
  • Privacy-safe local storage: Zero performance overhead with 1 aggregated row per day in WordPress MySQL.
  • Native Google Analytics 4 (GA4) event dispatching for calculator views, interactions, and checkout.

1.9.13

  • Clean Lead Capture Quality Safeguard: Leads are strictly captured only when genuine contact details (phone or email) are provided, completely preventing empty anonymous visitors from cluttering the leads table.
  • Active Drafts with real phone numbers automatically convert to Abandoned Leads after the 15-minute grace period with 1-click WhatsApp follow-up link.
  • Added live tab counts to Admin Bookings & Leads table.

1.9.12

  • Enhanced Abandoned Leads & Draft Capture: quotes reaching Step 3 (Checkout stage with items and address) are now captured immediately as active drafts, updating in real-time as the customer types their phone, email, or name.
  • Added live tab counts to Admin Bookings & Abandoned Leads table (All Entries, Confirmed Bookings, Abandoned Leads, Active Drafts).
  • Implemented automatic expiration check on Admin page load so drafts older than the grace period (default 15m) automatically convert to Abandoned Leads even when WP-Cron is delayed.
  • Added 5 Minutes option to Abandoned Lead Grace Period settings for faster lead processing.
  • Added database auto-healing schema check on update to ensure bookings table is always initialized without requiring manual plugin deactivation and reactivation.

1.9.11

  • Logistics Summary Display: Removed 200px max-width clamp and ellipsis truncation on Step 3 date and time slot summary strip, ensuring full collection arrival windows (e.g. Afternoon 12:00 – 16:00) display completely without being cut off.

1.9.10

  • Address Autocomplete Fix: Restored instant free address and postcode suggestions via OpenStreetMap/Photon in Step 2, and added an admin toggle in Logistics Settings.

1.9.9

  • Step 3 Breakdown Fix: Resolved JavaScript scope ReferenceError on item word count variable, ensuring the Items Subtotal row and individual item manifest render accurate item counts and prices instead of defaulting to 0.

1.9.2

  • Tablet & Viewport Protection: Fixed horizontal overflow on tablets in portrait mode (Samsung Galaxy Tab, iPad 768px-820px) where desktop rules applied 860px max-width and 46px side paddings exceeding tablet screen width. Enforced universal max-width: min(100%, 860px), dedicated tablet breakpoints (up to 1024px), zero-width flex containment on the date carousel, and minmax(0, 1fr) grid columns ensuring Step 2 never spills over screen margins on any tablet or phone.
  • Dropdown Footer Consistency: Restored full ‘Continue to Booking ({amount})’ button label across desktop, tablet, and mobile, while keeping ‘Done’ on mobile to guarantee generous space without text truncation.
  • Pricing Calculation: Fixed JavaScript ReferenceError on currency symbol variable when minimum callout fee adjustments applied, ensuring live estimated total updates accurately to the minimum callout fee instead of freezing at £0.
  • Search Input: Shortened mobile placeholder from ‘Search items or click to browse categories…’ to ‘Search items or categories…’ to eliminate final word truncation on compact smartphone screens.
  • Category Alignment: Fixed multi-line category alignment bug where ‘Living Room & Dining Room’ centered wrapped text due to parent theme text-align inheritance. Enforced strict text-align: left and flex expansion across all category rows and drawer elements.
  • Mobile Layout: Strengthened mobile constraints on Step 2 (date strip zero-width flex basis, single-column slot cards across 767px breakpoint, and container overflow isolation) to guarantee perfect fit on all mobile screens.

1.9.1

  • Mobile Responsive: Replaced fragmented mobile media queries with unified @media (max-width: 767px) covering all modern smartphones and phablets. Added inline scoped mobile layout rules directly to widget container to guarantee 100% viewport fit and prevent Step 2 from overflowing.

1.9.0

  • Mobile UX: Fixed horizontal layout blowout on Step 2 caused by date carousel flex min-width overflow. Constrained date carousel with smooth touch scroll.
  • Theme Isolation: Enforced strict left text-alignment and direction across all form labels, schedule headings, and logistics hints to prevent parent theme right-align bleed.
  • Catalog: Allowed item titles in category drawer to wrap naturally without ellipsis truncation, displaying complete names.
  • Dropdown Footer: Streamlined continue button label to ‘Continue ({amount})’ with responsive padding to prevent text truncation on narrow mobile screens.

1.8.9

  • UI: Fixed Contact Our Office email modal visibility bug where display:flex !important forced modal to appear by default on page load and prevented dismissal. Added strict display:none default, is-open toggle, native inline click fallback, and Escape key dismissal.

1.8.8

  • Email: Fixed email address breaking across two lines (e.g. santis.smagars@gma / il.com). Applied strict nowrap, reduced mobile email padding, widened value column from 64% to 72%, and streamlined logistics labels.

1.8.7

  • Pricing: Added explicit ‘Minimum Callout Fee’ line item in email receipts and Step 3 checkout breakdown whenever an order is adjusted to meet the minimum threshold.

1.8.6

  • UI: Replaced silent mailto links on ‘Email us’ with an interactive 100% fail-safe modal featuring 1-click clipboard copy, direct Gmail webmail compose, and default mail client launch.

1.8.5

  • Email: Added table-layout fixed, strict box-sizing, and word-break rules to logistics summary to prevent customer email and addresses from overflowing on mobile devices.
  • Logistics: Updated high-rise floor levels (5th – 10th and 11th – 50th+) to show ‘(Lift Required)’ and automatically check ‘Lift Available’ with waived stair fees.

1.8.4

  • UI: Updated confirmation screen WhatsApp button label to ‘Chat with Office’ to align with Call Office and email receipts.
  • UI: Strengthened hover styles for WhatsApp and Call Office action buttons to prevent background/text fade.

1.9.8

  • Financial Breakdown Itemized Display: Transformed the ‘Items Subtotal’ summary row in Step 3 (both Stripe card/deposit and Cash options) from a continuous comma-separated text string into a clean, vertical itemized list with bullet indicators, individual quantities, item titles, and line totals.
  • Responsive Alignment: Aligned the main subtotal amount to the top-right of the row while allowing the itemized breakdown list to expand vertically underneath on the left without horizontal wrapping collisions or overflow.

1.9.7

  • Fixed Calendar Card trigger: eliminated click blocking condition on hidden date input so clicking anywhere on “More… / Calendar” reliably triggers native picker.
  • Enhanced mouse drag detection threshold (12px) to prevent micro-movements on click from registering as a drag gesture.
  • Added fallback pointer-events toggle to ensure 100% reliable picker invocation across all desktop and mobile browsers.

1.9.6

  • Added desktop Mouse Drag-to-Swipe (grab & drag gesture) with fluid velocity and drag-click collision protection.
  • Added mouse wheel horizontal scrolling support over date carousel strip.
  • Added CSS touch scroll-snap (x proximity) and scroll-snap-align for smooth finger swiping on mobile and tablets.
  • Added dynamic navigation arrow states (dimmed/disabled when scrolled to carousel limits).
  • Hidden default browser scrollbars for clean, modern app-like carousel feel.

1.9.5

  • Removed redundant “Pick Date” header button to streamline Step 2 UI.
  • Anchored native calendar picker directly inside the “📅 More… / Calendar” carousel card with full-card click capture.
  • Fixed calendar popup anchoring: native picker now opens directly on the carousel card rather than at the bottom-left corner of the viewport.

1.9.4

  • Added dedicated “Your Clearance Items” Order Review card in Step 3 showing all selected items, quantities, and line totals before payment.
  • Added quick-action “✏️ Edit Items” button to jump back to Step 1 and “Change” button for collection date/address logistics.
  • Added “Items Subtotal” row to both Stripe and Cash payment breakdown tables for total financial clarity.
  • Added Stair Logistics breakdown line item.

1.9.3

  • Expanded Date Carousel to a full 30-day rolling window for effortless upcoming booking selection.
  • Added native Calendar Picker trigger button (“Pick Date”) in Step 2 header to book up to 180 days in advance without infinite horizontal scrolling.
  • Added intuitive “📅 More… / Calendar” card at the end of the date carousel strip.
  • Implemented dynamic on-the-fly custom card creation and auto-scroll centering when booking dates beyond the initial 30 days.
  • Fixed minimum callout fee live recalculation and enhanced tablet (iPad / Galaxy Tab) container containment.

1.8.3

  • Fixed email receipt financial breakdown for cash bookings to accurately show Total Due on Arrival instead of online deposit.
  • Redesigned email receipt header with high-contrast clean white background and accent borders to prevent logo blending.
  • Refined AJAX deposit parameter handling when payment mode is set to Pay on Collection (Cash).

1.7.6

  • Enhanced styling and readability of the commercial clearance & large volume footer inquiry notice.
  • Increased font size to 15px with bold typography and prominent brand-colored action links.

1.7.5

  • Added percentage discount & peak surcharge support for Arrival Windows (Morning, Afternoon, Evening) in the Interactive Pricing Calendar.
  • Dynamic calculation of slot percentage modifiers against item inventory subtotal.

1.7.4

  • Added percentage discount & peak surcharge support for specific calendar dates in the Interactive Pricing Calendar.
  • Real-time dynamic calculation on items total and automated visual badges (e.g. 10% OFF / SAVER).

1.7.3

  • Integrated developer support and Buy Me a Coffee donation link in plugin header, action links, row meta, and admin dashboard.

1.7.2

  • Updated Morning arrival window icon to a modern vector Sunrise icon for consistent visual progression (Morning Sunrise -> Afternoon Sun -> Evening Moon).
  • Enhanced icon contrast across light and dark theme canvas modes.

1.7.1

  • Enhanced light theme luminance auto-detection and bulletproof high-contrast styling for category and item names in hierarchical dropdown menu.

1.7.0

  • Introduced interactive floating category browse and live search menu with instant item selection and quantity steppers.

1.4.0

  • Reversed Strikethrough & Discount Display: Fixed Step 1 live price calculation so the higher original sum is struck through and the lower discounted price is prominently highlighted.
  • Unlimited Clearance Inventory & Categories: Upgraded from a 10-item limit to unlimited items with customizable Category grouping (rendered with native HTML ).
  • Specific Calendar Date & Arrival Window Pricing: Added admin calendar manager to pick specific individual dates, set day pricing adjustments, and configure custom arrival window modifiers without affecting recurring weekdays.
  • Added Basement Floor Logistics: Added Basement Floor option with custom configurable fee in Stair Logistics.
  • Newsletter Opt-In Checkbox & Subscribers Tab: Added opt-in checkbox at checkout. Subscribed customers are stored in a dedicated admin tab with 1-click CSV Export.

1.3.4

  • Directly extracted --oscar-text and --oscar-muted from widget root for Stripe Elements input style, ensuring typed card digits are dark (#141313) on white backgrounds and white (#ffffff) on dark backgrounds instead of invisible white-on-white.

1.3.3

  • Explicitly locked Stripe.js and Elements instance to English locale (locale: 'en') to prevent client browser auto-translating placeholders (e.g. “Kartes numurs”) into Latvian or other regional languages.

1.3.2

  • Fixed item quantity stepper counter visibility in Light / Clean White themes by binding .oscar-pill-qty to --oscar-text and eliminating dark-mode specificity override.
  • Added dynamic lightness detection (YIQ formula) in calculator widget template to automatically assign oscar-theme-light vs oscar-theme-dark based on canvas background color.

1.3.1

  • Fixed mobile layout overflow where payment choice selector cards (“Pay Full (100%)”) protruded beyond widget bounds on smartphones.
  • Implemented automatic responsive stacking (single column) on screens <= 580px for payment choices and multi-column inputs.
  • Forced box-sizing: border-box !important across all widget components to prevent third-party theme sizing collisions.
  • Added overflow: hidden and text auto-wrapping to payment panels and terms rows on narrow viewports.

1.3.0

  • Significantly expanded desktop container width to 680px (with responsive media query scaling).
  • Enhanced desktop typography, taller form inputs (48px) and hero CTA buttons (52px) for premium look.
  • Added desktop max-width selector in Appearance & Branding settings (480px, 540px, 680px, 760px).

1.2.9

  • Fixed dropdown focus background bleed by overriding theme-level CSS rules with !important.
  • Automatically blurred item select on selection to clear active focus rings on desktop and mobile.

1.2.8

  • Added mandatory Terms & Conditions and Hazardous Waste Exclusion agreement checkbox before booking confirmation / deposit payment.
  • Added admin settings in Payment Settings tab to customize agreement text and terms URL.
  • Added client-side and server-side validation with shake feedback animation.

1.2.7

  • Added real-time Live Calculator Preview in Appearance & Branding settings tab.
  • Added official 1-click brand preset themes.
  • Removed parenthetical Latvian labels for clean English admin UI.

1.0.0

  • Initial official release.
  • Multi-step waste clearance calculator shortcode [oscar_disposal_calculator].
  • 10 customizable inventory items with stepper controls.
  • Floor level logistics and service lift waiver calculations.
  • Stripe Elements checkout with deposit and full charge options.
  • Automated HTML email confirmation system.
  • Oscar Dispatcher CRM sync and 15-minute smart abandoned leads capture.