Quick Start Guide

The Booking Forms plugin is the perfect tool to create a platform with multiple options for booking trips and deliveries and easy to integrate it into a WordPress website, a mobile app or a blog. All the tools and options to keep your customers happy by saving time and easy to work with. A lot of widgets, order forms, payment options and reports will make your website and mobile app to look professional and modern. In top of that it’s very easy to install with the guide provided. Also, we are here to back you up if something goes wrong.

Plugin Installation

You don’t need any advanced knowledge in web design coding or programming. Takes couple of minutes to install it. So, purchase and download the Booking Forms plugin.

Now you can install the plugin through WordPress user interface (Plugins > Add new) or unzip it and upload by using FTP. Warning! If you want to use WooCommerce, make sure this one is installed prior to Booking Forms plugin installation. If not, it is not it's possible to synchronize these two plugins.

For future updates you have to Export data to a restore file from the Plugin Settings. After that, just delete the plugin from your website and upload the new version of Booking Forms plugin and Import the restore file made previously. Now, in Settings use the Plugin Update Key provided by us and yo have the automatic update of the plugin from the Update server.

Database Codepage

Make sure the code page for the backend database is the correct one. Go to your hosting admin console, like cPanel and open phpMyAdmin tool. Set up the UTF-8 codepage for the database schema.

• Prior to install WordPress into database backend set the Database Collation to UTF-8. Could be as well utf_8_general_ci or utf8mb4_unicode_ci
• Set the Server Connection Collation to UTF-8: utf_8_general_ci or utf8mb4_unicode_ci
• Install the Booking Forms plugin to WordPress CMS

Plugin Timezone

Make sure you have the correct time zone of the are where you are located. Go to WordPress administration console > Plugin home > Admin Panel > Users & Features > Settings > Set the time zone value as UTC offset such as +02.00.

Displaying Plugin Forms

To display the forms of the Booking Forms plugin like booking, payment and widget forms, use the shortcodes: [CallCustomForm] (deprecated), [_3bit_custom_form] and others. Please, check for more info into the article “Shortcodes”.

Google API Key

Highly recommend create Google Maps API key for using: Maps JavaScript API, Places API, Geocode API, Directions API. Using gmail account for business and Google API console  Console developers  make a following steps: 1) Create a key (Credentials page) 2) Activate libraries (Library page) 3) Add billing to account (Billing page).

Put the Google Maps API key to  WordPress administration console > Plugin home > Settings > Maps & Languages. If you are getting an error message when you are trying to calculate price or make an order (“Book now” or “Get a Quote” in the Plugin booking forms, “Find” locations in the WordPress administration console Plugin Home > AdminPanel) then there is an issue with your Google Maps API key. Verify the key restrictions, activated libraries and actual billing account, attached to the Google API console account.

Warning! API keys with referrer restrictions cannot be used with this API.

This means that you have either have not enabled the services required for the Booking Forms plugin to work, either there are some restrictions on the API key. Please, log into your Google Console and check if the following services (Libraries) are activated:

• Maps JavaScript API
• Places API
• Geocoding API
• Directions API

Also check if the Google Maps API key can be used by the server you are hosting the Booking Forms plugin onto.

Read this guide for more information on how to configure Google Maps API key settings (Using API Keys read this guide).

Automatic Installation

To add Booking Forms plugin using the built-in plugin installer:

• Step 1 – Go to Plugins > Add New in WordPress administration console. 
• Step 2 – Click Upload Plugin on top of the page. 
• Step 3 – Click Choose File and select the Plugin file from your computer. 
• Step 4 – Click Install Now to install the Booking Forms plugin. 
• Step 5 – After installation is complete, click Activate Plugin to activate the Booking Forms plugin.

Manual Installation

The manual installation of the Booking Forms plugin requires FTP familiarity.

• Step 1 - Connect to your web server (on hosting) with your FTP program. 
• Step 2 - Go where your WordPress files are, to the folder /wp-content/plugins.
• Step 3 - Upload to the folder /wp-content/plugins the Plugin zip file and decompress it. 
• Step 4 - Go to WordPress administrative console > Plugins and find the newly uploaded the Booking Forms plugin. 
• Step 5 - Click Activate Plugin to activate the Booking Forms plugin.

Website Crashed

When installing or updating the Booking Forms plugin, due to the large number of processes that run only when the Plugin is installed, it is it's possible to that your server will crash. One solution is to increase the memory allocated to PHP or other server parameters: WordPress provides instructions on how to do that.

Installation Failed

If the Booking Forms plugin did not install properly, or you have problems with WordPress administration console after installation, please write us to the Support and we will debug the problem for you. The problem is always caused by incompatibility with another plugin, theme or the server is not configured correctly.

Plugin Update Key

Once you ordered Booking Forms plugin, you could send an email to us with request to the Plugin Update key. The Booking Forms plugin Update keys are using for plugin updates. Highly recommend make a backup of the folder of the Plugin before update it. Warning! The Plugin update will rewrite languages files into the folder of the Plugin.

Activate Plugin Update Key

To activate your Plugin Update key follow the steps:

• Step 1 - Sign into your WordPress administrative console.
• Step 2 - Go to Plugin Home > Settings > Plugin Data page.
• Step 3 - Select Plugin Update key input field.
• Step 4 - Enter the Update key and click on “Save” button at the bottom.

Update Plugin

Before update the Booking Forms plugin to the new version from WordPress administrative console > Plugins > Update highly recommend Export Plugin data (Plugin Home > Settings > Export) to SQL file for restoration (backup dump) and save the root folder of the Plugin (Plugin Home folder located /wp-content/plugins/3bit).

Import and Export Data

The Booking Forms plugin provide Export and Import tools (Plugin Home > Settings > Plugin Data > Export | Import) for save and restore old data or backup dump of website backend (It's a especially important after using website copying utilities and tools, such as Duplicator plugin). Before using website's copying utilities and tools, highly recommend to do Export data on the Settings page of the Booking plugin (Plugin Home > Settings > Plugin Data > Export). Use Export tool for saving data of the Booking plugin to SQL format. Use SQL file to restore data with phpMyAdmin tool in cPanel which using by hosting provider (or other Import/Export tools for restore SQL dump). Other way to restore old data or backup dump through Import tool on the Settings page of the Booking Forms plugin (Plugin Home > Settings > Plugin Data > Import). Warning! When website content has been restored by restore tool or plugin, highly recommend restore the Plugin's procedures and functions using “Restore Plugin routines After WordPress restore” switch (Plugin Home > Settings > Plugin Data).

Private API Parameters

Use Private Plugin API parameters: Username and Password (Plugin Home > Settings > Plugin API Parameters) for connect to the Booking Forms plugin administrative tools (Plugin API url, Plugin API key should be empty for Local database backend, it's using for Remote database backend connectivity, when website content located remotely). Password changing it's possible to on the Cabinet administrative page (Plugin Home > Cabinet) on the User profile tab. Use the Admin Panel (Plugin Home > Admin Panel > Users & Features > User) User page for users management and control. Private API parameters using for the Booking Forms plugin administrative tools: Admin Panel, Cabinet, Calendar, Map, Order (fast order creation), Transport (fast transport booking) pages.

Plugin Forms and Pages

The Booking plugin provide a lot of forms for using with a website, for bookings, payments, confirms, administrative, and etc.

Each form of the Plugin it's possible to execute on any website page, Type and Forms of the Booking plugin are:

• Administrative: Admin panel, Cabinet, Map, Calendar, Login, Register (/plugin home/client)
• Payments: to Customer Wallet, by Customer Order (/plugin home/client/forms/payments/)
• Widgets: Horizontal, Vertical, Vertical with Map, Vertical with Stores, Vertical with Products(/plugin home/client/forms/widgets/)
• Bookings: Airport, Trip, Tour, Cargo, Rent, Ride, Shuttle, Product, Service (/plugin home/client/forms/bookings/)
• Confirms: Order Confirmation (/plugin home/client/forms/confirms/)
• Badges: Languages (/plugin home/client/forms/badges/)
• Extends: Profile, Contact (/plugin home/client/forms/extends/)

Booking platform and forms allow business functions to specific kind of services:

• Cars Rental
• Boats & Yacht Rental
• Goods Rental & Delivery
• Tourist Tours
• Airport Transfers
• Shuttle & Bus Regular Transfers
• Taxi on Demand (Trips, Transfers from Pickup to Drop-off)
• Cargo Removals & Rubbish Cleaner
• Service on Demand (Battery Replacement, Tow Truck by Location)
• Food Booking & Delivery
• Doctor on Demand (Medical Services by Location, Transportation to Medical Clinics)
• Beauty Service (Style Hair)

Booking Forms

The form is intended for all types of transportation and transfers, including regular transportation such as buses and minibuses. For Products restriction using parameter input_data with Id list of Products (such as for Shortcode: [_3bit_booking_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5). Otherwise use store_id  parameter with Id for Store choosing for booking form (such as for Shortcode and URL: store_id=1). For callback action after Booking form used: payment_callback | order_callback  (when payment is cash). Additional URL parameters it's possible to use with form:  passengers_count,suitcases_count, calculate (auto calculate price after form has been loaded), product_id (auto chosen product by Product Id after form has been loaded), order_address (pickup), delivery_address  (drop-off), order_date,order_time, order_hourly (rent time).

The form is intended for all types of transportation and transfers from and to airport trips, including regular transportation such as buses and minibuses. For Products restriction using parameter input_data with Id list of Products (such as for Shortcode: [_3bit_booking_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5). Otherwise use store_id parameter with Id for Store choosing for booking form (such as for Shortcode and URL: store_id=1). For callback action after Booking form used: payment_callback | order_callback (when payment is cash). Additional URL parameters it's possible to use with form: passengers_count, suitcases_count, calculate (auto calculate price after form has been loaded), product_id (auto chosen product by Product Id after form has been loaded), product_type_id (auto chosen filter by Product Type Id), order_address (pickup), delivery_address (drop-off), order_date, order_time, order_hourly (rent time).

The form is intended for all types of transportation and transfers, including regular transportation such as buses and minibuses. For Products restriction using parameter input_data with Id list of Products (such as for Shortcode: [_3bit_booking_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5). Otherwise use store_id parameter with Id for Store choosing for booking form (such as for Shortcode and URL: store_id=1). For callback action after Booking form used: payment_callback | order_callback (when payment is cash). Additional URL parameters it's possible to use with form: passengers_count,suitcases_count, calculate (auto calculate price after form has been loaded), product_id (auto chosen product by Product Id after form has been loaded), order_address (pickup), delivery_address (drop-off), order_date,order_time, order_hourly (rent time).

The form is intended for tourist tours, including regular transportation such as buses and minibuses. For Products restriction using parameter input_data with Id list of Products (such as for Shortcode: [_3bit_booking_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5). Otherwise use store_id parameter with Id for Store choosing for booking form (such as for Shortcode and URL: store_id=1). For callback action after Booking form used: payment_callback | order_callback (when payment is cash). Additional URL parameters it's possible to use with form: passengers_count, suitcases_count,calculate (auto calculate price after form has been loaded), product_id (auto chosen product by Product Id after form has been loaded), product_type_id (auto chosen filter by Product Type Id), order_address (pickup), delivery_address (drop-off), order_date, order_time, order_hourly (rent time).

The form is intended for product booking and delivery (rental and transportation of rental goods). For Products restriction using parameter input_data with Id list of Products (such as for Shortcode: [_3bit_booking_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5). Otherwise use store_id parameter with Id for Store choosing for booking form (such as for Shortcode and URL: store_id=1). For callback action after Booking form used: payment_callback | order_callback (when payment is cash). Additional URL parameters it's possible to use with form: all_products (alternative for input_data parameters, but uses all products instead), city (uses for Store Location from the city) calculate (auto calculate price after form has been loaded), product_id (auto chosen product by Product Id after form has been loaded), store_part_id(auto chosen store by Store Location Id), product_type_id (auto chosen filter by Product Type Id), delivery_address (drop-off), order_date, order_time, order_hourly (rent time).

The form is intended for cargo removals and rubbish cleaner services. For Products restriction using parameter input_data with Id list of Products (such as for Shortcode: [_3bit_booking_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5). Otherwise use store_id parameter with Id for Store choosing for booking form (such as for Shortcode and URL: store_id=1). For callback action after Booking form used: payment_callback | order_callback (when payment is cash). Additional URL parameters it's possible to use with form: calculate (auto calculate price after form has been loaded), product_id (auto chosen product by Product Id after form has been loaded), order_address (pickup), delivery_address (drop-off), order_date, order_time, order_hourly (rent time).

The form is intended for cars rent, boats rent and other objects services. For Products restriction using parameter input_data with Id list of Products (such as for Shortcode: [_3bit_booking_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5). Otherwise use store_id parameter with Id for Store choosing for booking form (such as for Shortcode and URL: store_id=1). For callback action after Booking form used: payment_callback | order_callback (when payment is cash). Additional URL parameters it's possible to use with form: calculate (auto calculate price after form has been loaded), product_id (auto chosen product by Product Id after form has been loaded), order_address (pickup), delivery_address (drop-off), order_date, order_time, delivery_date, delivery_time (rent time: departure/arrival).

The form is intended for any services (performance of service works by location): car repaies, beauty saloons, medical clinics. For Products restriction using parameter input_data with Id list of Products (such as for Shortcode: [_3bit_booking_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5). Otherwise use store_id parameter with Id for Store choosing for booking form (such as for Shortcode and URL: store_id=1). For callback action after Booking form used: payment_callback | order_callback (when payment is cash). Additional URL parameters it's possible to use with form: calculate (auto calculate price after form has been loaded), product_id (auto chosen product by Product Id after form has been loaded), product_type_id (auto chosen filter by Product Type Id), delivery_address (drop-off), order_date,order_time, order_hourly (rent time).

For example for URL parameters uses to Booking form on page: https://localhost/home_page/?all_products=true&city=London&calculate=true&product_id=1&store_part_id=1&product_type_id=1&delivery_address=Soho,London,UK&order_date=&order_time=11:00&order_hourly=24

Administrative Forms

It's possible to use (Plugin Home > Cabinet) Cabinet page for administrative purpose and control with the tabs Sent orders, Reports, Messages, User profile and Payments:

• Bookings in descending order (Complete the Order set Driver for Order, Reset a Status for Order Status, Payment order, Cancel Order)
• Tracking of Clients and Drivers
• Messages from Customers to Administrator
• Private User profile
• Private Payments to Prepaid amount (User's Account Balance)

Additional URL parameters it's possible to use with form: for hide tabs using parameter hide_tabs_pages, for Order Id choose using parameter order_id.

You can use (Plugin Home > Calendar) Calendar for preview and control incoming orders form customers group by days of month. You can short information preview for every Order and open Cabinet page for selected order (click on button “Open an Order”). Calendar navigation use control buttons for Day, Week, Month and Today smart navigation.

It's possible to use (Plugin Home > Map) Map for real-time Orders and Transports preview (For watching set the switch-button “Watching” in ON position, Attention! GPS devices in Transports installed), control every Transport by smart control buttons under Transport's name for Location, Watch, NoWatch actions (for selected Transport).

It's possible to use (Plugin Home > Admin Panel) Admin Panel for Plugin's data manipulation and administrative control. Data separated to 3 groups: Users and Features, Types and Attributes, Trade and Services.

Users and Features provides data audit, system settings, users, transports and other base objects information for the system:

• Audit system events audit log
• Settings system settings for bookings and other options
• Languages system support for admin and forms parts
• Project system information of remote of local installed database backend (hidden)
• Dashboard summary information for administrator or for selected customer
• User list of customers profiles with Prepaid amount (Account Balance)
• Transport list of transports with attached Sensor (GPS device)
• Type-bound Transport list of transports that have a type
• Sensor list of GPS devices
• Document list of customers documents that have been sent to system
• Discount list of features that increase or decrease a price of Service or Product by Code
• Tax list of features that increase a price of Service or Product in Order and list of customers fee (for clients or drivers) for using system.
• Messages list of administrative messages, using for technical or important issues
• User review, Product review, Transport review customers reviews of User, Product, Transport
• Track tracking points list of GPS devices
• Sensor circle list of temporary united customers Sensors for visibility of their Track one to other, when Order not completed
• Sensor place list of important locations of customers Sensors

Types and Attributes provides types and attributes parameters of the base objects of the system:

• Attribute is a attributes parameters names list
• Attribute binding list of translations for the objects of the system and data formats (such as, Currency)
• Color list of colors
• Currency list of currencies with only one active (main)
• Language list of languages that used for translations
• Delivery type list of types for delivery Products
• Store type list of type for store
• Track type list of types for Track
• Order place list of places that used in Booking Forms and Widgets (depends of type) for pickup and dropoff Locations
• Order status list of Order status. Warning! Don't remove any of status records, all status has been reserved for Booking Forms and Widgets, Mobile applications.
• Pickup status list of pickup status for Shared Trips
• Product param list of add-on parameters or Services for Products
• Product type list of calculate formulas of products, identifier by Value
• Transport type list of types for Transport

Trade and Services provides trade operations and products/services information for the system:

• Stock provides Products in Stores with count information. Attention! For activate Product in Booking Forms and Widgets set Product count more then 0.
• Stock invoice provides information about receipts at Store
• Stock invoice addition provides details information about Products receipt at Store
• Store provides information about points of Service or Products booking
• Store location provides information about Locations of Store Points. Attention! Locations of Store points using in Booking Forms and Widgets for delivery Services.
• Order provides information about customers bookings
• Scheduled Order provides information about Accepted Orders for selected date
• Order product provides information about Products in Orders
• Manufacture provides information about Products owner or maker
• Product provides products/services for customers booking
• Product addition add-on parameters or services attached to Products
• Product type calculate formulas attached to Products
• Purchase list of purchased Orders
• Payment credit card paid list
• Prepaid card list of manufactured special cards with a recharge code for customers Prepaid amount (Account Balance). Customer can replenish private own account in Cabinet page.
• Coupon list of coupons for User special discount (using on Booking forms) or for every customer.

Confirm and Payments Forms

The form is intended for confirm of booking, which using after booking form and approved an order. Additional URL parameters it's possible to use with form: for user authencation using parameter token, for Order Id choose using parameter order_id and user_id.

The form is intended for payment of order, which using after booking form and when chosen option Card Payment. For callback action after Payment form used: payment_callback | order_callback | widget_callback(For Shortcode and payment_callback for URL parameters uses). Additional URL parameters it's possible to use with form: for payment of order using order_id parameter, for provider chosen by default using provider_idparameter, for provider mode (view of): banner or default (checkbox selecting view) using provider_mode parameter, for hide providers gateways or wallet using hide_providers | hide_wallet parameters (true | false set values).

The form is intended for payment to User account balance, which increase when payment has been done. For callback action after Payment form used: wallet_callback (For Shortcode and for URL parameters uses). Additional URL parameters it's possible to use with form: for provider chosen by default using provider_id parameter, for provider mode (view of): banner or default (checkbox selecting view) using provider_modeparameter, for hide providers gateways using hide_providers (true | false set values), for pay to User with amount using user_name | payment_amount parameters.

Widget Forms

The form is intended for Home page invitation to booking (vertical fields places), which could be using with any booking form and accept an user interface (ui_elem input parameter for Shortcode or for URL substring): from, to, datetime (date and time fields), return (return date and time fields), passuit (passengers and suitcases fields), hourly. As for example, for using to any page with Widget chosen fields set for Shortcode: [_3bit_widget_form ui_elem=from,to,datetime] and for URL: https://localhost/home_page/?ui_elem=from,to,datetime. For callback action after Widget form used: widget_callback. For example: With ui_elem = from,to,datetime and Without ui_elem

The form is intended for Home page invitation to booking (horizontal fields places), which could be using with any booking form and accept an user interface (ui_elem input parameter for Shortcode or for URL substring): from, to, datetime (date and time fields), return (return date and time fields), passuit (passengers and suitcases fields), hourly. For callback action after Widget form used: widget_callback.

The form is intended for Home page invitation to booking | booking form with map (with fields for: pickup, drop-off, passengers and suitcases), usually used for trip, transportation and removals booking. Form using as invitation to booking and as booking form too (advanced user can set a variable in the form code var WIDGET_MODE=false; /* true | false for booking */ or recommended using URL parameter widget_mode such as https://localhost/home_page/?widget_mode=true). For Products restriction using parameter input_data with Id list of Products (such as for Shortcode: [_3bit_widget_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5). For callback action after Widget form used: widget_callback | order_callback (when widget_mode=false).

The form is intended for Home page invitation to booking with stores for choosing and city of services. As for example, for using to any page with Widget Id Stores list set for Shortcode: [_3bit_widget_form input_data=1] and for URL: https://localhost/home_page/?input_data=1. For using cities from Store Location use city_places parameter (such as for URL: https://localhost/home_page/?city_places=true). For callback action after Widget form used: widget_callback.

The form is intended for Home page invitation to booking with products for choosing, pickup and drop-off fields. As for example, for using to any page with Widget Id Products list set for Shortcode: [_3bit_widget_form input_data=1,2,3,4,5] and for URL: https://localhost/home_page/?input_data=1,2,3,4,5. For using Store Location in drop-down list use store_places parameter with 2 parameters: city and store_id (such as for URL: https://localhost/home_page/?store_places=true&city=%25&store_id=1). For callback action after Widget form used: widget_callback.

WordPress Pages

When the plugin already installed and activated, next WordPress pages are installed into database (saved as post with page type):

• Booking pages with Shortcodes (shortcode with 2 callbacks of actions after order with cash or card payment, for example: [_3bit_custom_form page_name=forms/bookings/trip_booking.html content_id=content store_id=1 order_callback="/index.php/3bit-order-confirm/" payment_callback="/index.php/3bit-order-payment/"]) to Store (with Products of Store): Taxi on Demand, Airport Transfers, Shuttle Transfers,Tourist Tours, Goods Rental, Cargo Removals, Boats Rental, Food Delivery, Cars Rental, Service on Demand, Doctor on Demand, Beauty Service

• Service pages with Shortcodes (shortcode with callback of action after logon, for example: [_3bit_custom_form page_name=login.html content_id=content login_callback="/index.php/3bit-profile/"]) to Service forms: Start, Login, Register, Cabinet, Calendar, Map

• Extends pages with Shortcodes (shortcode, for example: [_3bit_custom_form page_name=/forms/extends/profile_form.html content_id=content]) to Extends forms: Profile, Contact

• Payments and Order Confirm pages with Shortcodes (shortcode with callback of payment after action, for example: [_3bit_payment_form content_id=content payment_callback="/index.php/3bit-profile/"]) to Payment/Confirm forms: Order Confirm, Order Payment, Wallet Payment

Customize Forms

Global Settings and Product, Product Type, Product Additional as used for Customize forms. It's possible to set a lot of options for each Booking/Widget form.

Login sub-form (auto sing-in/sign-up in Booking forms). Use Global Settings (Admin panel > Users and Features > Settings) for customize forms and set up notifications options.

Product form (choosing product and services in Booking forms). Use Admin panel > Trade and Services > Product for create or edit goods and services, set up options (for Product > Object Details) for product price calculation.

Booking form choosing pickup/drop-off addresses, date and time, product | service and other data. Use Global Settings (Admin panel > Users and Features > Settings) for customize forms and set up form options: order date, time, passengers, suitcases, and etc.

Booking form customers data, comments, payment type and other data. Use Global Settings (Admin panel > Users and Features > Settings) for customize forms and set up notifications options.

Booking form coupon code for discount, disclaimer information, Get a Quote and Order Now buttons. Use Global Settings (Admin panel > Users and Features > Settings) for customize forms and set up options for price calculation results.

Global Settings

The Plugin provide through the Admin panel Settings (Plugin Home > Admin panel > Users and Features > Settings) of Booking forms and other features of Booking tools. Partly it's possible to set up values in Settings, Mailings, Gateways administrative forms (Plugin Home > Settings | Mailings | Gateways).

WordPress Shortcodes

Shortcode is a WordPress feature, which uses for call additional functionality and visible forms for extend website pages possibilities. More details about WordPress Shortcodes on the official documentation page: https://wordpress.com/support/shortcodes/.

Shortcode of The Plugin for WordPress is CallCustomForm (deprecated), using with a lot of Parameters. Forms are built using the framework Bootstrap4. Alternative name of Shortcode is _3bit_custom_form. For example : [_3bit_custom_form page_name=cabinet.html tab_number=2 username=admin password=admin map_provider=google language=ENGLISH]

Shortcode of the Plugin:

_3bit_admin_form – download Admin panel form content to place where is shortcode located

_3bit_cabinet_form – download Cabinet form content to place where is shortcode located

_3bit_custom_form – download any of the Plugin form by page_name parameter

_3bit_badge_form – download default Badge form (it's possible to set up this and all next options in Plugin Home > Settings > Plugin Forms)

_3bit_wallet_form – download default Wallet form

_3bit_widget_form – download default Widget form

_3bit_booking_form – download default Booking form

_3bit_payment_form – download default Payment form

_3bit_confirm_form – download default Confirm form

Parameters of the Plugin Shortcodes:

page_name – name of the Plugin form (always required for _3bit_custom_form shortcode)

page_type – name of default page type for Widget, Booking, Confirm, Payment, Wallet forms (parameter uses when page_name is empty)

tab_number – number of tab for Cabinet form

order_id – number Id of order for Cabinet form

username – set up user credentials

password - set up user credentials

user_type – type of user (when parameter equals “1” and username and password belongs to administrator's type than uses user's role dropdown list) for Register form

map_provider – uses map provider (required values : “google”, “yandex”, “osm”, “here”, “mapbox”, “mapquest”. Warning! Maps Directions, Geocoding, Places using by default Google Maps API provider, for map preview using one of selected provider)

language – uses of language for the Plugin form (one of languages values /admin/json/messages.json from field “name” of the messages array, such as "name" : "ENGLISH", english by default)

callback (or order_callback | widget_callback | payment_callback | badge_callback | login_callback | register_callback for the Plugin forms) – uses callback (for other form or URL link to website page) after the Plugin form has been completed (for example, customer clicked on the Order Now button of Booking form)

input_data – input data (Id numbers of Products) for uses in Booking or Widget forms

payment_amount, user_name – default value of amount for payment to User (by user_name) of Wallet form

store_id – default Store for Booking form

store_part_id – default Store Location for Booking form (Product Booking)

ui_elem – uses visible fields of Vertical | Horizontal Widget forms

content_id – set up Id number identifier for the Plugin form content (for div element)

Woo Payment Page

When the Plugin was synchronized with WooCommerce, it's possible to integrate to Booking page callback (after customer clicked on Order Now button) redirect to WooCommerce pay page. Follow by the WooCommerce documentation need uses:

Checkout endpoints

The following endpoints are used for checkout-related functionality and are appended to the URL of the /checkout page:

Pay page – /order-pay/{ORDER_ID}

For examples: https://localhost/checkout/order-pay/172/?key=wc_order_LgPB2EMuoswSg&pay_for_order=true

1. Set WooCoomerce synchronization with the Plugin (Plugin Home >Settings Plugin Data)

2. Make order_callback Shortcode parameter with URL to standard WooCommerce Checkout – Order Pay page (order_callback = "https://yourdomain/checkout/order-pay/" wither ORDER_ID number and empty other URL parameters)

Object Details

Additional the Plugin's object fields uses Object Details as integrated data (in JSON format database saved) for: User, Order, Store, Product (Plugin Home > Admin panel > User | Order | Store | Product). Following fields are used for objects:

User | Set up User additional fields. Link to Store: store_id = <Store Id> number (for link Store to User for manager role)

Store | Set up Store additional fields. Link to User: user_id = <User Id> number (for link User to Store for manager role). Set up a lot of Store options by fields: currency_id, currency_format, time_schedule and other (identical Global Settings).

Order | Set up Order additional fields. Link to Store: store_id = <Store Id> number (for link Store to Order for customer order), currency_id and currency_format for operations.

Product | Set up a lot of (transportation, rent) price fields for complicated calculation of order summary price: route, distance, hourly, time_period, datetime_period, passengers. Information field allow details information about product to Booking form (it's possible to using html tags and Bootstrap4 classes, recommend using single quotes for code).

Product Prices

Product Type with Code 1 belongs to sale of material products (such as, Pizza, Sushi, Bottle of water) by fixed price. And also for tours with fixed prices and price per passenger, service with fixed price, events and meetings with fixed price. Product Type with Code 3 belongs to rent of material products (such as Cars, Skis and Skates, Boats and Yachts) by hourly price. Product Type with Code 2, 4-9 belongs to transportation (trip or delivery) service. Price for transportation service calculates by Code, and depends distance and duration long (excluding Code 9 for which price is always fixed). Price for Code 4, 5 and 7 calculates for 2, 5 or X (X – is a parameter which set up for Global Settings in distance_included, and is an integer value) miles or km (measure, which set up in Global Settings in distance_measurement and is an string value), and all subsequent ones will be calculated at price per distance unit. Price for Code 2, 6, 8 calculates by distance or duration of route.

Every Product for the Booking forms (or for Mobile apps) should be put to Store in Stock in a amount of at least one or more (with Stock Price or Sale Price, which could be empty). Price of Product calculation priority: 1) Sale Price in Stock 2) Price in Stock 3) Product Price.

Product Price for transportation service could be offset by another price (when Product Price is equals 0 or empty) with special parameters: 1) Product > Object details parameter price_per_distance or price_per_minute value (depends Product Type > Code of Product was set). 2) Global Settings parameter price_per_distance or price_per_minute value (depends from Product Type > Code of Product was set).

When booking time for transportation service was founded in a time range than price should be increased for 1) Store > Object details time range parameter surge_price_time_range and parameter surge_price_ratio as multiplier which used for prices multiplied. 2) Global Settings time range parameter surge_price_time_range and parameter surge_price_ratio as multiplier which used for price multiplied.

When calculated transportation price value less then required, it is it's possible to set up a minimum price of service for 1) Product > Object details parameter minimum_fare. 2) Global Settings parameter minimum_fare.

When used cargo transportation service or transport for cargo service it's possible to set up for each calculates an additional distance to garage location through Global Settings string parameter garage_location (format: latitude, longitude), as additional distance to transportation (is a distance to closest point of Pick-up or Drop-off).

Product Price for transportation service could be offset finally by another price which was set in Product > Object details filed parameters: 1) Price calculates by route data with route (format: locations | price | times, for example: 45.395965, 10.884121, 10000 - 41.897721, 12.481058, 50000 | 50.00; Milano - Torino | 100.00) 2) Price calculates by price by distance data with distance (format: distance_range | price, for example: 1000 - 2000 | 2.00; 2000 - 100000 | 1.00)

When chosen transportation types of Product (Product Type > Code = 2,4...9) the Distance parameter distance provide an easy format for smart calculates with different distance parts of trip/delivery. For example, base fare for a trip for $30, and with $2 per km for each next distance which after 12 km, distance = 0 – 1000 | 30.00; 1000-12000 | 0; 12000-100000 | 2.00 (the first km will cost $30, the next one km and up to 12 km are free, and after each next km which after 12 km will cost $2.00 and continue for up to 100 km).

When chosen rental type of Product (Product Type > Code = 3) for rent by hours, it's possible to set up hourly parameter in Product > Object details with: price calculates by hours data with hourly parameter (format: hours_range | price example: 0-2 | 2.50; 2-4 | 2.25; 4-10 | 2.00). Similar with format of hourly, format for time_period, but price will taken from parameter as is, as was set. Thus, it's possible to set up datetime_periodparameter in Product > Object details field parameters: price will taken from price parameter as was set (format: hours_range | price | dates_range, for example: 0-2 | 7.95 | 31.08 – 01.12). For a case for cyclical counting for every day, should be specify a price for 24-hours separately (for example: 0-2 | 2.50; 24 | 12.75).

When was chosen fixed price type of Product (Product Type > Code =1) for tours or service for passengers (participants), it's possible to set up passengers parameter in Product > Object Details with: price calculates by passengers range data (format: passengers range | price, for example: 1-2 | 10.00; 3-4 | 20.00; 5-6 |30.00 and for 3 passengers tour price will be cost 20.00). Passenger parameter could be using for events, meetings services for people count, who will take participation. Every people count corresponds to set a price for a group of participants or passengers.

Final price may be affected by User or Product Discount calculated by Discount Type: 1) Discount in percent 2) Discount in value 3) Increase in percent 4) Increase in value. Validity of Discount may be limited by validity period.

• Transportation product type: Product > Object Details route => Product > Object details distance => Product Stock Sale Price => Product Stock Price => Product Price => Product > Object Details price_per_distance or price_per_minute
• Rental product type: Product > Object Details datetime_period => Product > Object details time_period => Product > Object details hourly

When chosen Transport to Order (and no transportation service Product chosen for Order), then price for transportation service calculates by Transport > Object details parameters: 1) Price calculates by distance with price_per_distance 2) Price calculates by duration with price_per_minute 3) Customer informs for waiting cost with waiting_fee 4) Minimum fare for Order price with minimum_fare 5) Customer informs for maximum passengers count with maximum_passengers 6) Customer informs for maximum baggage count with maximum_baggages 7) Price calculates by route data with route (format: locations | price | times, for example: 45.395965, 10.884121, 10000 - 41.897721, 12.481058, 50000 | 50.00; Milano - Torino | 100.00) 8) Price calculates by price by distance data with distance (format: distance_range | price example: 1000 - 2000 | 2.00; 2000 - 100000 | 1.00)

Route formats

Routes parameter (route) has complicated format supported for a single race from pick-up point to drop-off and for a regular race (for regular races, parameter regular_race of Product > Object details, such as regular_race = 1).

Single race: location or address from, radius, name – location or address to, radius, name | price for race (for example: route = 46.5385777,10.1351296,20000 - 46.4643741,10.3651648,7000 | 80.00)

Regular race: location, radius, address or name | price for one ticket | time of race (example 1: 50.4236908,30.4703816,300,Bus start point | 0.00 | 10:00) location or address from, radius, name – location or address to, radius, name | price for one ticket | time_from – time_to (example 2: route = 46.5385777,10.1351296,20000 - 46.4643741,10.3651648,7000 | 80.00; 45.0734673,7.6055667,5000,Torino – 45.4627124,9.1076924,5000,Milano | 100.00 | 10:00-14:00)

Rental formats

Rental formats parameter has complicated format supported for time (hours) of rentals and date and time (hours and dates) of rentals.

time_period: rent hours from - rent hours to | price for rent (example: 0-4|280; 4-8.5|390; 23.5|390; 24|390 for the time more then 24 hours will be use period from 0-4, 4-8.5 and etc.)

datetime_period: format: rent hours from - rent hours to | price for rent | date from - date to (example: 0-4|210|01.06-30.06; 4-8.5|320|01.06-30.06)

(identical to time_period and with date from - date to)

Tours formats

Passengers format: passengers count from - passengers count to | price for passengers (example: 1-2|10;3-4|20;5-6|30)

Currency Format

Recommended use for currency format of world wide currency:

£ Pound Sterling == &pound;

$ US Dollar == &dollar;

¥ Japanese Yen == &yen;

€ Euro == &euro;

Format of currency format parameter: $ <numbers> (For example: $ 1.00 | 1.00$ | $1,000.00)

Warning! symbol $ has been reserved for place of currency name or symbol (put to currency name as title symbol or abbreviation wanted)

Set up for special Store currency to Object Details "currency_id" (Currency Id) additional field and "currency_format" (Format of currency) values:

currency_id = "1"

currency_format = "$1.00"

Custom Form Fields

Additional the Plugin forms fields it's possible to add with standard WP Plugin Editor (WP Home > Plugins > Plugin Editor). Qualified developer choosing the Plugin form in /client/forms/ folder to change any module (the Plugin form). All additional fields saving to Comments filed (of Booking form) in format: <field's label: field's value> (For Radio field saving label only).

Custom CSS File

For private style customization uses a special CSS file (for custom styles) of the Plugin booking, payment and widget forms. New styles implementation through changing the code in the file by path /admin/css/style.css (for the Plugin's forms HTML tags and classes). The Booking Forms plugin using Bootstrap4 framework (Framework home page and documentation: https://getbootstrap.com ). Could be specially defined other private CSS style file in WordPress administration console Plugin Home > AdminPanel > Users and Features > Settings > style_script. Set up the style_script parameter by value with path to private CSS file.

Languages and Translations

The Plugin did not used standard WordPress translations methods and functions, due to new method for easy and fast add new any language and translate through Google Translation API. Using the Plugin Translations for generate new language for the system in a few clicks and minutes: Plugin Home > Users and Features > Translations.

There are 2 translation (JSON format) files of the Plugin: “Plugin Settings, Mailings, Gateways” (Administrative part) and “Client Forms” (Client forms part). Choose both for add new Plugin Language and Translate (from base English to new one).

When adding new Language required Code of language and Locale name. Warning! Code and Locale uses for Google API services and for other purpose. Translation's delimiter using for Google Translation API. Warning! In a case, when auto-translation are not fully right, recommend using manual editing or change delimiter for other (for example: @, #, $, %).

Notifications Templates

Notifications through email SMTP are sending to customers (drivers, managers) and to administrator of the system as letters. For make a letter uses template for event which has been fired. Following notifications templates (for events) are installed to the Plugin:

Qualified customers of the Plugin could generated a custom templated with direct calling each table field, such as for example: Order Id or Order Address it's possible to getting with code

Order Status Template

Order Invoice Template

In this article are posted mostly important options of the Plugin and Forms which most often used and require separate consideration.

Forms Parameters

It's possible to use (Plugin Home > Settings > Plugin Forms) for definitions and restrictions parameters of Booking forms: Distance Measurement, Minimum Distance, Maximum Distance, Date Format, Time Format,  Map Zoom, Country, Order Tax,  Acceptance Regions and Theme colors. For using custom messages for Minimum Distance,  Maximum Distance, Acceptance Regions and Order Available Ontime  mismatch in the Booking forms, enter custom strings to importing warning Messages  (Plugin Home > Settings > Messages). More parameters and messages available Plugin Home > Admin Panel > Users & Features > Settings.

Email Notifications

It's possible to use (Plugin Home > Mailings) Mailings for Email notifications in the Booking forms for notify about events: Password Recovery, New Order, Order Status changed, Order Invoice, Coupon, Discount, Payment Confirmation. Email notification of the Plugin could be sent to Event owner (Order owner, Password recovery owner) and to Administrator's email address. Warning! Very important use recommended by Your hosting provider SMTP settings. Specify parameters for using: SMTP hostname (use prefix ssl:// or tls:// for security purposes, such as ssl://smtphostname.com:465), SMTP username, SMTP password. It's possible to define text of notify messages for each of events and set up the events (on|off) which used for notification.

Payment gateways

It's possible to use (Plugin Home > Gateways) Payment gateways in the Plugin: PayPal, Stripe, LiqPay, Braintree. You can use Cognalys provider for phone number verify (for mobile app). PayPal and LiqPay require callback functions for payment result backend notify. Specify callback's URL for LiqPay and create URL with PayPal Webhook Id on PayPal administration console for developers (https://developer.paypal.com). Specify administration credentials for work with callback notify: Administrator username for callback function. Use type of payment Sanbox for gateway debug, and Production for work in payment mode. For creation gateways keys and other parametes use next links (for create account and for create keys and debug use developer's link) and follow the instructions on the website:

• PayPal official website https://www.paypal.com for developers https://developer.paypal.com

• Stripe official website https://stripe.com for developers https://stripe.com/docs/development (other one is https://stripe.dev)

• LiqPay official website https://www.liqpay.ua

• Braintree official website https://www.braintreepayments.com for developers https://developers.braintreepayments.com

Tax for Customers

It's possible to use (Plugin Home > Gateways) Tax for customers in the Plugin: Client, Driver, Manager. Tax for customers is Your side fee for using Your system for Clients, Drivers and Managers (of Stores). You can use Taxfor customers for: each Order, per Month and per Day (in value or percent from Order price). Sum of funds will be decrease a Prepaid amount of User when orderer, per month or per day. Customer can increase own private Prepaid amount (Account Balance) in the Payments tab of the Cabinet form or in the Wallet Payment form.

Make a Product

Highly recommended using rule for new Products creation (* required) : 1. Manufacture > 2. Product * > 3. Product param part > 4. Product type part * > 5. Stock *. Set up Currency, Product param (if you need add-on parameters or services to Product and attach to Product by Product param part) for bookings.

Mostly Used Booking Parameters

You can use add-on options in Plugin Home > Settings for Booking Forms and Widgets:

• Distance Measurement (miles/kilometers)
• Date and Time Format (day - month – year, hours – minutes)
• Country and Map Zoom (country on map and zoom)
• Order Tax (calculates Tax for Order)
• Theme Color (color of pages visual objects)
• Acceptance Regions (limited borders for Order)
• Custom Messages (messages for warnings)
• Maximum Order Hourly (maximum hours for Product rental with Product type Value == 3)
• Maximum Passengers Count (maximum passengers for Order)
• Order Price per Minute (additional price per minute for Product type Value == 8)
• Return Price Ratio (multiplication factor to price for customer return trip)
• Surge Price Ratio (multiplication factor to price for some time of day)
• Surge Price Time Range (hours of day when price up)
• Order Time Schedule (hours of day for Service Booking Forms)
• Order Available On-time (working hours of day for Order)
• Distance Included to Tariff (distance for Product type Value == 7)

Activate Uses with WooCommerce

For the direct integration the Plugin with WooCommerce follow these steps:

• Step 1 – Go to WordPress administration console Plugin Home > Settings and Set option WooCommerce products synchronization.
• Step 2 – Go to WordPress administration console Plugin Home > Settings and Set option WooCommerce orders synchronization.
• Step 3 – Save WooCommerce synchronization options for Settings of the Plugin.

Warning!  After saving WooCommerce synchronization options Triggers  for the Plugin database tables and for WooCommerce tables will be created. The Plugin Triggers automatic copy data (from the Plugin to WooCommerce) when Products, Orders objects has been created. After restore database or duplicated data from other server need to restore options for WooCommerce synchronization.

Data Synchronization with WooCommerce

Plugin data Synchronization with WooCommerce in automatic mode by Triggers for the Booking Forms plugin and WooCommerce data tables. When You created products or orders in the Booking Forms plugin platform similar WooCommerce objects created. Products can be edited in the Booking Forms plugin and in WooCommerce with automatic data copying by Triggers. Warning! Pictures does not copy automatic.

Users Synchronization with WordPress

Plugin users Synchronization with WordPress in automatic mode by Triggers for the Plugin and WordPress data tables. When You created users in the Plugin platform similar WooCommerce objects created. Users can be edited in the Plugin and in WooCommerce with automatic data copying by Triggers. Warning! Pictures don't copy automatic. All Users will be created with empty password! Change password after new user was created.

For integrate the Plugin Users with WordPress follow these steps:

• Step 1 – Go to WordPress administration console Plugin Home > Settings and Set option WordPress users synchronization.
• Step 2 – Save WordPress synchronization option for Settings of the Plugin.

Rest API

Rest API (Web API) interface document for connectivity to the Booking Forms plugin backend for Android/iOS mobile apps (provides to the customers by request).