WordPress.org

Taiwan 正體中文

取得 WordPress
WordPress.org

Plugin Directory

Driveline Core

Driveline Core

由 Azhar Ali 開發
下載

外掛說明

Driveline Core provides the content types and booking logic for vehicle rental sites. It works with any theme, and the data belongs to the plugin rather than to the theme, so changing how the site looks never puts a reservation at risk.

What it registers

Vehicles, locations, packages, extras, bookings and enquiries, each as its own content type, plus taxonomies for make, vehicle type, fuel, transmission and features. Everything is prefixed, so nothing collides with another plugin.

Availability and booking

A vehicle has a number of units, and availability is counted against those units across a half-open date window, so a rental ending exactly when another starts is not a conflict. A booking takes a hold first, and the hold is what reserves the unit while the customer finishes paying. Two customers reaching the last car at the same moment cannot both take it: the claim is made behind a named database lock and re-checked after it is written.

Holds expire. An unpaid booking releases its units on a scheduled sweep so a car does not sit reserved for someone who never came back.

Pricing

Rates are per vehicle with rules layered over them: seasonal percentages, weekday surcharges, long rental discounts, driver age bands, delivery, one way returns, add-ons and damage protection tiers. Money is stored in minor units against a declared currency, so a rounding error cannot creep in between the quote a customer saw and the amount an operator collects.

Checkout

WooCommerce is optional. With it installed, a booking is paid through a normal WooCommerce order, which brings refunds, taxes, gateways and reporting with it. Without it, a booking is still placed, still holds its units and is still confirmed by an operator.

Customer accounts and operator screens

Customers see their rentals, ask to change dates and download their documents through a signed link that expires rather than a guessable path. Operators get a month-by-month fleet calendar and the booking list on the same dashboard, and pricing rules, submitted listings and notification settings under the Fleet menu.

Search and maps

Visitors filter the fleet by dates, location, vehicle type and features. Maps are off until you turn them on, and every service the plugin can contact is listed below.

External services

This plugin can contact the services below. All of them are switched off when the plugin is installed, and none is contacted until an administrator turns it on under Fleet, Maps.

OpenStreetMap tile servers

Used to draw the map images on any page showing a map. When maps are switched on, each visitor’s browser requests map tiles directly from https://tile.openstreetmap.org/{z}/{x}/{y}.png. Those requests carry the visitor’s IP address, their browser’s user agent, and the area of the map being viewed. No personal data is sent by this plugin.

Turning maps off in the settings stops the requests entirely: the map area shows a short notice instead and no tile is ever requested.

Service provided by the OpenStreetMap Foundation.
Terms: https://osmfoundation.org/wiki/Terms_of_Use
Tile usage policy: https://operations.osmfoundation.org/policies/tiles/
Privacy policy: https://osmfoundation.org/wiki/Privacy_Policy

Nominatim geocoding

Used to turn an address typed into a vehicle or branch into map coordinates. When address lookup is switched on, this site’s server sends the address, and a contact address you configure, to https://nominatim.openstreetmap.org/search. Turning a dragged map pin back into an address uses https://nominatim.openstreetmap.org/reverse the same way. Nothing is sent from a visitor’s browser.

Every result is stored permanently, so an address is looked up once and never again, and lookups are paced at one per second as the service requires.

Service provided by the OpenStreetMap Foundation.
Terms: https://osmfoundation.org/wiki/Terms_of_Use
Usage policy: https://operations.osmfoundation.org/policies/nominatim/
Privacy policy: https://osmfoundation.org/wiki/Privacy_Policy

Mapbox

Optional, and used only if you select Mapbox as the tile provider and save a public access token.

For map images, each visitor’s browser requests raster tiles from https://api.mapbox.com/styles/v1/{style}/tiles/512/{z}/{x}/{y}, where the style is the one you selected. Those requests carry the visitor’s IP address, their browser’s user agent, the area of the map being viewed, and your public access token. The token is public by design and is visible in the page source, so restrict it to your site’s URL in your Mapbox account.

For address lookup, if you also select Mapbox as the geocoding service, this site’s server sends the address to https://api.mapbox.com/search/geocode/v6/forward, and a dragged map pin to https://api.mapbox.com/search/geocode/v6/reverse. By default Mapbox returns temporary results that may not be stored, so nothing is cached and every changed address costs another lookup. Results are cached only when you tick the setting declaring that your account is entitled to permanent geocoding, which sets the permanent parameter on the request.

Service provided by Mapbox, Inc.
Terms: https://www.mapbox.com/legal/tos
Privacy policy: https://www.mapbox.com/legal/privacy
Attribution requirements: https://docs.mapbox.com/help/dive-deeper/attribution/

Privacy

A booking holds the customer’s name, email address, telephone number and any notes they left, together with the dates, the branches, the vehicle and the price agreed. All of it stays in this site’s database. The plugin sets no cookie of its own, writes nothing to a visitor’s browser, and sends no personal data to any external service; the services listed above receive an address to geocode or a map area to draw, never a customer.

Rental data is reported and cleared through the privacy tools WordPress already has, under Tools, Export Personal Data and Tools, Erase Personal Data. A customer can raise the same request from their own dashboard, and the button there raises a core request rather than acting on the spot, so the link WordPress emails has to be opened before anything is exported or destroyed. A dashboard left open on a shared machine is not enough.

Erasure takes the name, email address, telephone number and notes off the rentals and keeps the rentals. A booking is a commercial record with an invoice number against it, and the right to erasure does not reach the ledger a tax authority can ask about. The erasure screen says exactly that, rather than reporting a clean job it did not do.

Resources

Leaflet 1.9.4
Copyright (c) 2010-2023 Volodymyr Agafonkin, (c) 2010-2011 CloudMade
License: BSD 2-Clause
Source: https://github.com/Leaflet/Leaflet
Bundled at assets/vendor/leaflet/, unmodified. The minified leaflet.js is the file that loads; the readable leaflet-src.js it was built from ships beside it. The licence text is at assets/vendor/leaflet/LICENSE.

Leaflet marker and layer images
Copyright (c) 2010-2023 Volodymyr Agafonkin
License: BSD 2-Clause
Source: https://github.com/Leaflet/Leaflet/tree/v1.9.4/dist/images
Bundled at assets/vendor/leaflet/images/, unmodified.

螢幕擷圖

The Fleet menu, listing every vehicle with the make, type, fuel, transmission and features it is filed under.
The Fleet menu, listing every vehicle with the make, type, fuel, transmission and features it is filed under.
A vehicle's specifications and its rates: hourly, daily, weekly and monthly, the security deposit, the mileage allowance and the charge for going over it.
A vehicle’s specifications and its rates: hourly, daily, weekly and monthly, the security deposit, the mileage allowance and the charge for going over it.
The rental rules on the same vehicle, and the fleet behind it. Six identical cars are one listing with a quantity of six, not six listings.
The rental rules on the same vehicle, and the fleet behind it. Six identical cars are one listing with a quantity of six, not six listings.
Address and coordinates for a vehicle. With maps switched off the coordinates are typed in, and an address that is looked up is never looked up twice.
Address and coordinates for a vehicle. With maps switched off the coordinates are typed in, and an address that is looked up is never looked up twice.
Vehicle types, one of the five taxonomies every listing is filed under.
Vehicle types, one of the five taxonomies every listing is filed under.
Makes and models, with a count of the listings on each.
Makes and models, with a count of the listings on each.
Fuel types.
Fuel types.
Transmissions.
Transmissions.
Features, which become the tick boxes a visitor filters the fleet with.
Features, which become the tick boxes a visitor filters the fleet with.
Branches, each one a place a rental can be collected from or returned to.
Branches, each one a place a rental can be collected from or returned to.
A branch, with its address, its pin, the pickup point type that decides the icon, and the timezone its pickup and return times are shown in.
A branch, with its address, its pin, the pickup point type that decides the icon, and the timezone its pickup and return times are shown in.
Bookings, each one a rental placed against a vehicle and a customer.
Bookings, each one a rental placed against a vehicle and a customer.
A quote request, with the vehicle, dates and customer ready to be converted into a booking that is priced and confirmed.
A quote request, with the vehicle, dates and customer ready to be converted into a booking that is priced and confirmed.
Extras, the add-ons a customer can put on a rental.
Extras, the add-ons a customer can put on a rental.
A vendor package, setting how many listings a vendor may have live and how many they may put forward.
A vendor package, setting how many listings a vendor may have live and how many they may put forward.
Adding a pricing rule, with the type, the scope it applies to, the adjustment and the conditions that decide when it runs.
Adding a pricing rule, with the type, the scope it applies to, the adjustment and the conditions that decide when it runs.
The pricing rules in force, running in priority order: seasons, weekends, long rentals, driver age, delivery, one way returns and tax.
The pricing rules in force, running in priority order: seasons, weekends, long rentals, driver age, delivery, one way returns and tax.
Notification settings, naming who each message comes from and letting an operator switch any of them off.
Notification settings, naming who each message comes from and letting an operator switch any of them off.
Map settings. Every external service is off until an administrator turns it on, and the screen says what each one sends and to whom.
Map settings. Every external service is off until an administrator turns it on, and the screen says what each one sends and to whom.
The operator dashboard, with every vehicle, the units behind it, the rate it is priced at and whether it takes an instant booking.
The operator dashboard, with every vehicle, the units behind it, the rate it is priced at and whether it takes an instant booking.
Incoming bookings, each with its reference, the customer, the vehicle, the dates, the status and the total the pricing rules produced.
Incoming bookings, each with its reference, the customer, the vehicle, the dates, the status and the total the pricing rules produced.
The month calendar, showing at a glance what every vehicle in the fleet is doing.
The month calendar, showing at a glance what every vehicle in the fleet is doing.

安裝方式

  1. In the admin, go to Plugins, Add New, Upload Plugin.
  2. Choose the zip file and select Install Now, then Activate.
  3. Open Fleet to add your vehicles, and Fleet, Pricing to set your rates.
  4. Maps and address lookup stay off until you switch them on under Fleet, Maps.

常見問題集

Does it need WooCommerce?

No. WooCommerce is the payment layer and is optional. Without it a booking is still placed, still holds its units and is still confirmed by an operator; what you lose is the order, and with it refunds, taxes and gateways.

Does it need a Google Maps API key?

No. Maps need no API key and no billing account. Leaflet is bundled with the plugin and map images come from OpenStreetMap. Mapbox is offered as an alternative if you would rather use it, and needs a token of your own.

Does the plugin contact anything on its own?

No. Every external service is switched off when the plugin is installed and none is contacted until an administrator turns it on under Fleet, Maps. The services and what is sent to them are listed under External services.

Can two customers book the last vehicle at the same time?

No. The claim is made behind a named database lock and re-checked after it is written, so the second request is refused rather than oversold.

What happens to my data if I change theme?

Nothing. Vehicles, bookings, rates and customers belong to this plugin, not to the theme.

Does it work with a page builder?

Yes. Driveline for Elementor and Driveline for WPBakery place the same output in those editors. Both are optional, and both read from this plugin, so a price on a builder page and a price at checkout are produced by the same code.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈Driveline Core〉的開發相關工作。

參與者

將〈Driveline Core〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣？

任何人均可瀏覽程式碼、查看 SVN 存放庫，或透過 RSS 訂閱開發記錄。

變更記錄

0.1.0

  • First release. Vehicles, locations, packages, extras, bookings and enquiries.
  • Unit-level availability with expiring holds and a locked claim.
  • Rate plans with seasonal, length of rental, weekday and location rules.
  • Optional WooCommerce checkout, customer accounts and operator screens.
  • Fleet search, and maps through Leaflet with OpenStreetMap or Mapbox tiles.

中繼資料

評分

這個項目尚無任何評論記錄。

撰寫評分

查看全部使用者評論

參與者

技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

檢視技術支援論壇