QUICK START GUIDE

So, Booking Plugin will help you easy to create a booking platform for Trip and Delivery into WordPress website, Mobile apps or blog. The booking platform provides a lot of booking widgets, order forms, order sent and payment forms.

Plugin Installation

To install Booking Plugin, download it from the https://3bit.app website after purchase. Once it has been downloaded unzip the file and upload the 3bit.zip file to your WordPress website either through the user interface or by unzipping it and using an FTP. Warning! Please ensure WooCommerce is installed before you using Booking Plugin Settings for WooCommerce synchronisation! It will not work without it. If you want to update Booking Plugin with any of the future updates that will be published you will Export data to restore file in the Plugin Settings. Then delete the old version of the Plugin from your website (this will delete your Plugin data). After this, upload the new version of the Plugin to your website and activate it.  Import data in the Plugin Settings from file for restore. Use Plugin Update key for automatic update the Plugin from the Update server.

Database Codepage

Ensure you have selected the correct codepage for the backend database. To do this go to Hosting administration console, such as cPanel.  Start phpMyAdmin tool and set UTF-8 codepage for the database schema. If You will work with not only latin languages. If you use UTF-8 for the database schema follow these steps: (Recommendation for database Collation with UTF-8 codepage):

• Step 1 – Before WordPress install to Your database backend, set the Database Collation to UTF-8 (such as: utf8_general_ci or utf8mb4_unicode_ci).
• Step 2 – Before Booking Plugin install to WordPress CMS set the Server Connection Collation to UTF-8 (such as: utf8_general_ci or utf8mb4_unicode_ci).

Plugin Timezone

Ensure you have selected the correct time zone you are in. To do this go to WordPress administration console Plugin Home > AdminPanel > Users&Features > Settings > Set the time_zone value as UTC offset (such as, +02:00).

Displaying the Booking Form

To display the Booking Plugin booking, payment and widget forms, use the shortcodeCallCustomForm see details in the article for Shortcodes.

PLUGIN SHORTCODE

Shortcode of Booking Plugin for WordPress

is CallCustomForm, with the help of a lot of parameters

Example: [ CallCustomFormpage_name=cabinet.html tab_number=2 username=admin password=admin map_provider=google language=ENGLISH]

Parameters of the Shortcode page_name – name of Custom form (always required); tab_number – number of tab on Cabinet form; order_id – number id of order on Cabinet form; username – default Login credentials; password - default Login credentials; map_provider – plugin 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 – use Language on form (one of values; /admin/json/messages.json in field “name” of messages array, such as "name" : "ENGLISH", english by default); callback (or order_callback for Booking forms) – Callback page href for Login, Register or Booking forms (call as location.href in javascript); widget_callback (or callback) – Widget form Callback page href for call form page after widget on main page (call as location.href in javascript); input_data – input data (Id numbers of products) for use in Booking form or Widget form;

Forms
Trip booking	[ CallCustomForm page_name=forms/bookings/trip_booking.html]
Product booking	[ CallCustomForm page_name=forms/bookings/product_booking.html]
Tour booking	[ CallCustomForm page_name=forms/bookings/tour_booking.html]
Ride booking	[ CallCustomForm page_name=forms/bookings/ride_booking.html]
Order sent	[ CallCustomForm page_name=forms/bookings/order_sent.html]
Airport booking	[ CallCustomForm page_name=forms/bookings/airport_booking.html]
Service booking	[ CallCustomForm page_name=forms/bookings/service_booking.html]

Payment
Payment Form	[ CallCustomForm page_name=forms/payments/order_payment.html]
Wallet Payment	[ CallCustomForm page_name=forms/payments/wallet_payment.html]

Widgets
Product Widget	[ CallCustomForm page_name=forms/widgets/product_widget.html callback=link to page]
Manufacture Widget	[ CallCustomForm page_name=forms/widgets/manufacture_widget.html callback=link to page]
Trip Widget	[ CallCustomForm page_name=forms/widgets/trip_widget.html callback=link to page]
Product type Widget	[ CallCustomForm page_name=forms/widgets/product_type_widget.html callback=link to page]
Home Widget	Coming soon...
Tour Widget	[ CallCustomForm page_name=forms/widgets/tour_widget.html callback=link to page]
Cars Widget	[ CallCustomForm page_name=forms/widgets/cars_widget.html callback=link to page]
Map Widget	Coming soon...
Delivery Widget	[ CallCustomForm page_name=forms/widgets/delivery_widget.html callback=link to page]
City Widget	[ CallCustomForm page_name=forms/widgets/city_widget.html callback=link to page]
Tabs Widget	[ CallCustomForm page_name=forms/widgets/tabs_widget.html widget_callback=link tab 1 to page 1 order_callback= link tab 2 to page 2]
Trip Booking Widget	[ CallCustomForm page_name=forms/widgets/trip_booking_widget.html callback=link to page]

Badges
User Badge	Coming soon...forms/badges/user_badge.html
Last Blog Badge	Coming soon...forms/badges/last_blogs_badge.html
Languages Badge	[ CallCustomForm page_name=forms/badges/languages_badge.html]

Wizards
Store Wizard	Coming soon...forms/wizards/store_wizard.html
Document Wizard	Coming soon...forms/wizards/document_wizard.html

GOOGLE API KEY ISSUES

If you are getting an error message when you are trying to make an order (“Book now” or “Send an Order” 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. 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 Booking Plugin to work, either there are some restrictions on the API key. Please, log into your Google Console and check if the following services are activated:

Google Maps JavaScript API

Google Maps Places API

Google Maps Geocoding API

Google Maps Directions API

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

If you are still getting the same error after the above steps, try to disable the HTTP restrictions completely and check again. If it works after this, there are some issues with the HTTP restrictions you have placed on the Google Maps API key.

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 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 3bit.zip from your computer, the one you downloaded from https://3bit.app.
• Step 4 - Click Install Now to install Booking Plugin.
• Step 5 - After installation is complete, click Activate Plugin to activate Booking Plugin.

MANUAL INSTALLATION

The manual installation of Booking Plugin requires FTP familiarity.

• Step 1 - Connect to your web server with your FTP program.
• Step 2 - Go where your WordPress files are, to the folder wp-content/plugins.
• Step 3 - Upload the folder 3bit from the zip file you downloaded.
• Step 4 - Go to Plugins screen, in WordPress administration console, and find the newly uploaded Booking Plugin in the list.
• Step 5 - Click Activate to activate it.

THE SERVER CRASHED

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

INSTALLATION FAILED

If the Booking 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.

GET PLUGIN UPDATE KEY

Once you ordered Booking Plugin from https://3bit.app, you will receive an email with your order which contains the Plugin Update key. You can also get your Plugin Update key from your account on https://3bit.app. There, you will have the list of all your keys.

ACTIVATE YOUR 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 page.
• Step 3 - Select Plugin Update key input field.
• Step 4 - Enter the Update key and click on “Save” button at the bottom.

UPDATE YOUR PLUGIN

Before to update the Booking Plugin to a new version automatically in WordPress go to administrative console Plugins > 3bit > Update, Export Plugin data (Plugin Home > Settings > Export) to restore SQL file (backup dump) and save style CSS file /admin/css/style.css (if you have changed it).

HOW TO USE CUSTOM CSS STYLE IN PLUGIN

You can use private CSS styles for the Plugin booking, payment and widget forms by changing file /admin/css/style.css for HTML tags or classes. The Booking Plugin using Bootstrap3 framework (Bootstrap4 in future version 1.2). You can specially defined other private CSS style file in WordPress administration console Plugin Home > AdminPanel > Users&Features > Settings > Set the style_script value as filepath to Your private CSS file.

IMPORT AND EXPORT DATA

You can Import (Plugin Home > Settings > Import) old data or backup dump to the Booking Plugin (this is especially important after using website copying utilities, such as Duplicator plugin). Before using website copying utilities, you need to Export data in Settings page of the Booking plugin. Export saving Your data of the Booking plugin in SQL format. You can use SQL file to restore your data by phpMyAdmin tool of Your hosting provider (Import/Export tools for SQL dump). Normal way to restore your data is Import in Settings page of the Booking Plugin (Plugin Home > Settings > Export). Attention! When you are restoring your website by thrid-part plugin, it is highly recommended to restore Plugin's procedures and functions by Restore Plugin routines After WordPress restore (set the switch to ON and save the Settings).

IMPORT AND EXPORT DATA

You can Import (Plugin Home > Settings > Import) old data or backup dump to the Booking Plugin (this is especially important after using website copying utilities, such as Duplicator plugin). Before using website copying utilities, You can do Export data in Settings page of the Booking plugin. Export saving Your data of the Booking plugin in SQL format. You can use SQL file to restore Your data by phpMyAdmin tool of Your hosting provider (Import/Export tools for SQL dump). Normal case to restore Your data is Import in Settings page of the Booking Plugin (Plugin Home > Settings > Export). Attention! When You restored Your website by thrid-part plugin, highly recommended restore Plugin's procedures and functions by Restore Plugin routines After WordPress restore (set the switch to ON and save the Settings).

USING PRIVATE API PARAMETERS

You can use (Plugin Home > Settings > Plugin API Parameters) Private Plugin API parameters (Username, Password) for the Booking Plugin administrative tools. Plugin API url and Plugin API key must be empty (for Your Local database backend). Go to Cabinet administrative page and there youcan change password credentials on the User profile tab (default is 'admin'). To create another administrative credentials, Go to Admin Panel page and open Admin Panel > Users & Features > User and click on '+' button to create one account more. Private API parameters using for the Booking Plugin administrative tools: Admin Panel, Cabinet, Calendar, Map, Order (fast order creation), Transport(fast transport booking) pages.

PLUGIN FORMS PARAMETERS

Plugin Home > Settings > Plugin Forms tab

There are settings for 

Plugin Forms: Distance Measurement, Minimum Distance, Maximum Distance, Date Format, Time Format, Map Zoom, Country, Order Tax, Acceptance Regions and Theme colors.

Yo can apply your own settings for Minimum Distance, Maximum Distance, Acceptance Regions and Order Available Ontime 

To display errors or mismatch in the Plugin Forms, input your own strings to Messages (Plugin Home > Settings > Messages).

More parameters and messages are available Plugin Home > Admin Panel > Users & Features > Settings.

HOW TO USE PLUGIN EMAIL NOTIFICATION

If you want to know in a second what is going on with your website orders. Choose what you want to know asap

You can use (Plugin Home > Mailings) Mailings as Email notifications of the Booking Plugin for multiple events such as :

Password Recovery (for mobile app)

New Order

Order Status changed

Payment Confirmation

Email notification of the Booking Plugin can be sent to Event owner (Order creator, Password recovery creator) and to the Administrator by email address. Warning! It isvery important to use recommended SMTP settings by your hosting provider. Specify parameters for using: SMTP host name (use prefix ssl:// or tls:// for security purposes, such as ssl://smtphostname.com:465), SMTP username, SMTP password. You can write the text of the messages for an event and also, to set up the events you want to know about.

HOW TO USE PLUGIN PAYMENT GATEWAYS

You can use (Plugin Home > Gateways) Payment gateways in the Booking Plugin for: 

PayPal, 

Stripe,

 LiqPay, 

Braintree.

To check the phone number on the mobile app you have Cognalys 

PayPal and LiqPay require callback functions for payment result backend notify. Accordingly,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 to work with callback notify: Administrator username for callback function. If something goes wrong, please use 'Sanbox' for the type of payment and 'Production' for work in payment mode. This way you will have a gateway debug,.

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 https://www.paypal.com for developers https://developer.paypal.com
• Stripe https://stripe.com for developers https://stripe.dev
• LiqPay https://www.liqpay.ua
• Braintree https://www.braintreepayments.com for developers https://developers.braintreepayments.com

HOW TO USE PLUGIN TAX FOR CUSTOMERS

Just in case you want to establish a fee for Drivers, Clients or Managers who are using your system

Go to Plugin Home > Gateways and click on Fee. Switch on or off each given Client /Driver/Manager Fee as you need. There are 3 options for you, accordingly with your business needs. You can charge :

“fee value per order”=get a certain amount for each order

“fee percent per order “= get a percentage from each order

“fee value per month”=ask a subscribe fee monthly

If you want to stay away from users debts switch on the “Use Deactivated user with negative prepaid amount “. As soon as their account goes into negative balance they will be stoped to use your system.

Also, the users can increase their prepaid amount -account balance- in the Payments tab of the Cabinet page

* Fees will not be charged if you are switching off the fee of each type of user

PLUGIN CABINET PAGE

You can 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 (Account Balance)

PLUGIN CALENDAR PAGE

Plugin Home > Calendar

Very useful for preview and control incoming orders from customers group. You can sort information preview for every Order and open Cabinet page for selected order (click on button “Open an Order”). Navigation by control buttons for Day, Week, Month and Today of smart navigation. 

PLUGIN MAP PAGE

You can 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).

PLUGIN ADMIN PANEL PAGE

You can 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 Attr, 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
• Project system information of remote of local installed database backend
• 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)
• Transport type part 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 Attr provides types and attributes parameters of the base objects of the system:

• Attr attributes parameters names list
• Attr part list of translations for the objects of the system
• 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
• 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 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 part provides details information about Products receipt at Store • Store provides information about points of Service or Products booking • Store part 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 param part add-on parameters or services attached to Products • Product type part 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.

PLUGIN ADMIN PANEL PAGE

You can 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 Attr, 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
• Project system information of remote of local installed database backend
• 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)
• Transport type part 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 Attr provides types and attributes parameters of the base objects of the system:

• Attr attributes parameters names list
• Attr part list of translations for the objects of the system
• 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
• 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 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 part provides details information about Products receipt at Store • Store provides information about points of Service or Products booking • Store part 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 param part add-on parameters or services attached to Products • Product type part 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.

HOW TO USE PLUGIN WITH WOOCOMMERCE

If you want to integrate the Booking 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 Booking Plugin.

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

PLUGIN DATA SYNCHRONIZATION WITH WOOCOMMERCE

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

PLUGIN USERS SYNCHRONIZATION WITH WORDPRESS

Plugin users Synchronization with WordPress in automatic mode by Triggers for the Booking Plugin and WordPress data tables. When You created users in the Booking Plugin platform similar WooCommerce objects created. Users can be edited in the Booking 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. If you want to integrate the Booking Plugin users with WordPress follow these steps:

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