Box Tracker Online

By jrmoser

10+ active installationsVersion 2.5.0

IMPORTANT

Description

IMPORTANT

The Box Tracker plug in enables web visitors to order dumpster services from the private waste haulers who maintain the sites.  The plug in interacts with the Box Tracker API described here: https://www.dumpster.software/api/ under SSL.  Box Tracker is an enterprise solution for managing  waste hauling by providing services such as order management, and dispatch which the plug in is intended to facilitate.  The information is used exclusively by the company the visitor is explicitely patronizing to facilitate the service that the web visitor is explicitly requesting and is not transmitted, sold, licensed or even accessible by any third party. The plug in does not track the visitor and reports information provided only for the purpose of ordering dumpster services.

Questions may be directed to James Moser President / Lead Developer of Cairn Applications 603 546 6751 ext 101 or jim@cairnapps.com

Importing Plugin

To import “Box Tracker” plugin into WordPress. User needs to navigate to “Upload Plugin” feature under the Plugins area in the WordPress dashboard.

Activating Plugin

To activate the “Box Tracker” plugin user need to navigate to “Installed Plugins” section under the Plugins area in the WordPress dashboard.
Here user will get list of all the installed plugins, from this list user need to find “BoxTracker Online” and click on “Activate”.

Setting up BoxTracker Online

To update setting of “BoxTracker Online” user need to access plugin setting using “Box Tracker” feature from the sidebar are of admin panel, and then update all required fields.

Amongts those required fields is the google api key. You will need it or the plugin wont function. To obtain a google api key follow the steps bellow:

  1. Go to “https://cloud.google.com/maps-platform/” and click on “Get Started”
  2. A pop up window will open, asking you to select a product(s); select maps and places.
  3. Login to or create a google account, then enter a project name and create a billing account.
  4. After you billing account is created, you will be prompt with another option, allowing you to
    enable google maps platform. Click next, and google will respond with an api key. This method will
    activate all google maps platform API(s). However, you can go back and remove the ones you wont need
    for this plugin. The API(s) you will need are the followings: Directions API, Distance Matrix API,
    Geocoding API, Maps Elevation API, Maps JavaScript API and Places API.

You will find an option called API Mode. in TEST mode, the system will return a URL with which you can validate
the variables sent to Box Tracker. Mode TEST posts will not render for the hauler.

Using Plugin in front end

To use the plugin at front of the WordPress site user needs to create a new page and use the shortcode [box-tracker-online] in the page or the user can add the shortcode [box-tracker-online] in any existing page where user wants to use the plugin.

Changelog

2.5.0

  • New: Material-Based Pricing. When enabled in BoxTracker Preferences, customers choose a material before container size, and sizes, availability and pricing follow that material. A material with no price sheets of its own uses the price sheets without a material. The selected material is sent with the order.
  • Sites that enable Material-Based Pricing in BoxTracker must run this version or later; earlier versions do not filter price sheets by material.
  • New: with several yards (multiple map centers), distance and pricing use the nearest yard, and the yard is sent with the order.
  • Checkout re-validates the quoted material, price sheet and container size, and the Review step and the order are tied to the browser tab that received the quote.
  • The requested date is checked against the earliest booking date on the server, not only in the date picker.
  • After a declined card, customers can go back to payment and try again without re-entering their details. With the matching BoxTracker update, the retry reuses the same customer record when the billing email matches; without it, a retry still works but creates a new customer.
  • The Thank You page is only used for placed orders; a failed order stays on the form so the customer can retry. Thank You page links are URL-encoded.
  • The Order button is disabled while the order is sent. If BoxTracker does not answer, customers are told the order could not be confirmed instead of being invited to submit it again.
  • The Review step no longer shows the card security code (CVV), and shows customer details as plain text.
  • Refreshed ordering form: rounded fields and buttons, visible focus outlines, labels linked to their fields, and a five-step progress bar.
  • Payment and billing fields support browser autofill; phones show a number pad for the card number and CVV.
  • Redesigned order summaries, CVV help popup (now fits small screens) and confirmation screen.
  • Plugin CSS and JavaScript are versioned by file so browsers load updated files after an upgrade.
  • Fix: the form now appears where the shortcode is placed, and loads in page builders and block themes.
  • Fix: a connection problem with BoxTracker or Google shows an error message instead of stopping with a server error.
  • Fix: job addresses are sent to Google with their commas intact.
  • Fix: availability table stays visible when the selected date is unavailable; billing and payment state selections are kept when pricing is requested again (Back, Review EDIT).
  • Fix: the date picker counts from the site’s local date. With the matching BoxTracker update, the earliest booking date and cut-off time use the site’s local time.
  • PHP sessions are only started for the ordering form requests, not on every page of the site.
  • Admin debug panel (Pricing Query JSON Response) is only shown to administrators, and only when debug mode is on.
  • Settings: the saved password is no longer printed into the settings page; leave it blank to keep it.
  • New setting: Server: Google API Key, used for the server-side Google calls (geocoding, distance). Leave blank to use the Google API Key. Setting it lets you restrict the Google API Key to the site’s domain.
  • New: optional Txn Class field on step 1 (Settings: Hide, Show or Required). Needs the matching BoxTracker update; without it the field stays hidden.
  • Requires PHP 7.0 and WordPress 5.3.