User's Guide
Bookingo Documentation by Travel Marketing, v.1.0
Bookingo is a Online Travel Agency - OTA - dynamic system that allows searches at country hotels, city hotel groups, promotions and more, thanks to its powerful booking engine.
Bookingo - OTA - is divided into two areas:
The way the system works is:
1. Create Cities Inventory
2. Create Hotel inventory
3. Create Inventory to add cities and hotels
This will be use to make reservations on the website..
The system allows the creation of an unlimited number of inventories but only maintains an active inventory at once. Hence its great flexibility and advantage over other systems because the system allows the exchange inventory with just a click.
Only approved approved hotels and cities can be displayed in the portal Bookingo. That means that although it 100 hotels and 50 cities in our database, the system will search only those that appear in the active inventory.
Web site
Administration Panel
Introduction
How it works
Installation
Logging in
Dashboard
Administration Module
Sales Module
Bookings Module
Settings Module
Contact Us
ou must create a Database in mysql and User, follow:
// db connection string variables
Follow your website URL in your Browser:
http://yoursite.com/installer
follow in line instruccions in order to install Bookingo.
Once the system is installed, you can access the administrator by using this route:
http://yourwebsite.com/bk-admin
The default credentials are:
User: admin
Pass: demo123
When you access to Bookingo administrator dashboard you can identify some important things. This dashboard is divided into four sections:
• General Stats
• Microsite Sales
• Latest Check-ins
• Latest Check-outs
It shows five categories of elements and the number of active elements in each category:
• Inventories
• Hotels
• Cities
• Bookings
• Reviews
Additionally, it works as a shortcut to each of these categories. You can make click on the category.
It shows three types of statistics:
• Today Sales
• Sales of the Month
• Sales of the Year
The data has been obtained of all transactions and approved in the transactions module.
It shows 8 closest bookings to date of the current day, shows us the check-in and responsible for the reservation. If you want to see detail reservation you can click on the button GO. Bookings of other date are not shown in this section. To access them you have to go to Bookings module.
It shows 8 closest bookings to the date of the current day, shows us the date of departure and responsible of the reservation. If you want to see detail reservation you can click on the button GO. Bookings of other date are not shown in this section. To access them you have to go to Bookings module.
Below we describe how to create each of these elements.
Section of cities have two options: List of cities and add city. The first thing to do is add City this will be displayed on the website. To display a hotel, we must first have set the city where the hotel is located.
Steps to create a city
1. Select the COUNTRY, if the country is the United States or Canada, a new field will appear to select the state. For other countries the state will not appear.
2. Define the name of the city in the CITY NAME field.
3. Set an initial value (the lowest possible Price for a reservation in that city) and put it as an integer in the field FROM RESERVATION. The price is set in U.S. Dollars
4. Add a photo thumbnail to the city. This is very important because this is what is used to display web portal TOP DESTINATIONS. If you do not add the picture at this time, can not be added later.
In this section we are shown all the cities that we have created in the system, cities have two states: Active and Inactive. To display the cities in the inventory, it must have an Active state. From here we set that cities will be active or inactive.
In the hotels section we have two options: Hotel List and Add Direct Hotel. After configuring the cities, the next thing we must do is define what hotels we manage and display on the website. To display a hotel inventory, we must first have set the city where the hotel is located, and to show a city inventory also we have to define at least one hotel with a room and prices associated with the room.
The correct configuration for an Hotel is:
In this section we are shown all the hotels we have created in the system, the hotels have two states: Active and Inactive. For hotels to be displayed in the inventory we must set the active state. From here we set which hotels will be Active or Inactive. Additionally from here you access the detail of the hotel, from where we can manage rooms and rates.
Steps to create an Hotel
1. In the HOTEL NAME field write the name of the hotel.
2. In the HOTEL DESCRIPTION field write a brief description of the hotel, no more than 100 characters.
3. In the HOTEL INFORMATION field write all hotel information, this information will appear on the detail page of hotel.
4. In the ADDRESS HOTEL field enter the address of the Hotel. It is not necessary to include the city and state as this will in other fields.
5. The HOTEL GENERAL PRICE field is the average price the hotel charges in their rooms, with this price will be positioned in the search results for hotels.
6. In the HOTEL TAX field is defined the amount of tax payable. If left 0.00 means that the hotel doesn’t have tax.
7. In the COUNTRY field select the country where the hotel is located.
8. In the CITY field select the city of the hotel.
9. In the HOTEL ZIP field add the zipcode.
10. In the STARS HOTEL field we can select the value in stars that give to the hotel. This has to do with the type of infrastructure and services offered.
11. In the HOTEL ADULTS MAX field we add integer maximum number of adults that supports the largest hotel room.
12. At HOTEL MAX CHILDREN field we add integer maximum number of children allowed in the biggest hotel room.
13. In the HOTEL GUEST MAX field add the maximum number of guests in the same room regardless of whether they are children or adults.
14. In the HOTEL MAX ROOMS field add the maximum number of rooms that the hotel has.
15. In HOTEL LATITUDE and HOTEL LONGITUDE fields add data of google maps were is locate the hotel.
16. In Hotel Policy Cancel field add the hotel Policy Cancel so the guest can read the terms to cancel.
17. In the HOTEL THUMBS field add the photo thumbnail of hotel you want to appear on the results page for hotels, the image must be: 70 x 70 px.
The Hotel management is made of 5 sections:
• Hotel Overview
In this section you will see all the hotel information that was previously added, you can edit hotel name, description, address, country, city, etc.
• Hotel Rooms
This section is where you manage the different room types from the hotel. Here you create the rooms, set prices, and change the status to active or inactive.
• Hotel Amenities
This section we create and manage the hotel amenities, modify, activate, inactivate or delete them.
• Hotel Photos
In this section we have the photo gallery of the hotel, here we upload all the photos you want to show from the hotel like rooms, restaurant, beds, etc, also we can change the status to active or inactive.
• Hotel Reviews
In this section are the reviews the guests write in the website for the hotels.
Steps to configure the
Hotel Overview
The Hotel Overview includes all the information we use when we created the hotel so it is very useful to update the information there. All we have to do is change the field we want and then submit the form. How to modify the fields are show below:
1. In the HOTEL NAME field write the name of the hotel.
2. In the HOTEL DESCRIPTION field write a brief description of the hotel, no more than 100 characters.
3. In the HOTEL INFORMATION field write all hotel information, this information will appear on the detail page of hotel.
4. In the ADDRESS HOTEL field enter the address of the Hotel. It is not necessary to include the city and state as this will in other fields.
5. The HOTEL GENERAL PRICE field is the average price the hotel charges in their rooms, with this price will be positioned in the search results for hotels.
6. In the HOTEL TAX field is defined the amount of tax payable. If left 0.00 means that the hotel doesn’t have tax.
7. In the COUNTRY field select the country where the hotel is located.
8. In the CITY field select the city of the hotel.
9. In the HOTEL ZIP field add the zipcode.
In this section we create rooms and the different prices are set for each room. The system allows setting different prices according to the number of guests staying per room.
1. Click the Add Room button. This action brings up a form to complete your room details.
2. In the ROOM NAME field we add the name that will identify the room.
3. In ROOM SHORT DESCRIPTION field add a brief description that shows a unique feature of the room.
4. In the ROOM DESCRIPTION field we add all information associated with the room.
5. In the ROOM GUEST CAPACITY field we add the maximum number of guests allowed in the room.
6. In the MAX ADULTS FOR ROOM field we add maximum number of adults allowed in the room.
7. In the MAX KIDS FOR ROOM field we add maximum number of children allowed in the room.
8. In the ROOM INVENTORY field we add maximum number of rooms available of this type for the hotel.
9. Submit the form.
10. Repeat this process every time you want to add a new room type.
Once you've created the room type, you can add it the price. As explained above, a price is set for each guest staying in the room, you have to set prices as follows for the search system to identify the room. For example, if we want the room show up in the search for 3 adults, we need to define the price for 3 adults. Or if you want the room to appear in the search for 2 Adults we should set the price for 2 adults.
The correct procedure to create the room rates is:
First click Manage Prices. You will see a list of prices associated with the room and a form to add price. In the price list we can inactivate, activate or delete a price.
1. In the PRICE DESCRIPTION field we define an identifier for the price, for example. PRICE FOR ONE PERSON.
2. In the PERSON IN THE ROOM field place the number of guests for which we will set a price.
3. In the PRICE ROOM field we add the price of the room when the condition of the pre-defined number of guests are met.
4. We submit the form.
5. Repeat the process by increasing the number of guests up to the maximum number of guests allowed for this room.
Steps to Create Amenities
1. We click on the Add Amenities button.
2. In the AMENITY NAME field we write the description of the amenity.
3. We submit the form.
4. Repeat the process as many times as necessary to add all of the hotel amenities.
If we want to delete, activate or inactivate one amenity we do it from the amenities list of the hotel.
Steps to Add Hotel Photos
1. We click on the Add photos button.
2. We click on the IMAGE field and a dialog box will show to select the photo you want to add.
3. We select the photo and click on the OPEN button.
4. The image is automatically loaded.
5. Repeat the process as many times you want.
If you wish to activate, inactivate or delete the photo we do this in the photo list.
Steps to view Reviews
We go to the reviews section and there is a list of reviews, which we can read reviews that are written on the website for the hotel.
Steps Hotel Owner
The system allows you to configure each hotel owner for report purposes. To set the owner we go to the Owner section where you will find a list of users created on the system.
1. Select a user from the user list.
2. We submit the form.
With this simple step we assign the hotel owner.
The inventory section is composed in three blocks:
• Current Inventory
The current inventory is the one approved on the inventory list that we had created. The system only allows one active inventory at a time and is the one shown in this part. Here is show the list of items, which may be hotels and cities that are active and approved to be on the web portal. From here we can activate, inactivate, create hot deals and top destinations for display on the website, so we can also delete items on the approved inventory.
• Inventory List
Displays the list of all inventories that have been created in the system, both the active and all inactive inventory. One of the wonders of the system is that we can configure several inventories and make a change from one to another with a single click. From here we can make the change in the inventory system.
• Add Inventory
This is where the configuration process inventory begins, and where we create inventories used in our system.
The management module is the most important as it allows to configure Bookingo Web Portal. This is where we define the hotels, rooms, room rates, cities and define the inventory, this will be used to show hotels and cities in the website, so you need to be careful enough. Setup is simple but has an order and you should follow to get things working correctly.
The configuration procedure is as the following:
This section allows you to track inventory, hotels and cities that want our web site to show, so you should pay close attention to each of the blocks. This is the most important operation of the system as it is through this feature that you can perform the following configuration:
a) Creating inventories
b) Inventory Configuration
c) Inventories modification
d) Activation of inventories in the web portal
The correct procedure is as follows:
10. In the HOTEL STARS field we can select the value in stars that give to the hotel. This has to do with the type of infrastructure and services offered.
11. In the HOTEL ADULTS MAX field we add integer maximum number of adults that supports the largest hotel room.
12. At HOTEL MAX CHILDREN field we add integer maximum number of children allowed in the biggest hotel room.
13. In the HOTEL GUEST MAX field add the maximum number of guests in the same room regardless of whether they are children or adults.
14. In the HOTEL MAX ROOMS field add the maximum number of rooms that the hotel has.
15. In HOTEL LATITUDE and HOTEL LONGITUDE fields add data of google maps were is locate the hotel.
16. In HOTEL POLICY CANCEL field add the hotel Policy Cancel so the guest can read the terms to cancel.
17. In the HOTEL THUMBS field add the photo thumbnail of hotel you want to appear on the results page for hotels, the image must be: 70 x 70 px.
Create
the City
1
Create
the Hotel
2
Create
the Inventory
3
Create
the City
1
Create
the Hotel
2
Create
Hotel Rooms
3
Add Price
to the Rooms
4
Create the Inventory
1
Add
Cities
2
Add
Hotels
3
Configure
the Inventory
4
Activate
the Inventory
5
Creating Inventories
STEP 1: Create an inventory
1. The first thing we do is go to the ADD INVENTORY form.
2. In the INVENTORY NAME field we define the name of our new inventory. The name of the inventory is a descriptive identifier for the contents of the inventory, for example, Great Summer Holidays Easter Deals, etc.
Inventory Management
Once you have created an inventory you have to go to the Inventory List section to manage our new inventory, we add cities and hotels. To manage you have to click the Manage button. This leads to inventory management section where we can do 4 things:
• Manage current inventory. Activate, inactivate, configure or delete cities and hotels.
• Add cities to the inventory.
• Add hotels to the inventory.
• Configure the top destinations.
STEP 2: Add cities
1. Go to the section to add city.
2. Click and identify the city that will be added to the inventory.
3. Click the button to add inventory and ready. The city was added to the inventory.
STEP 3: Add Hotels
1. Go to add hotel section.
2. Click and identify the hotel that will be added to the inventory.
3. Click the button to add inventory and ready. The hotel was added to the inventory.
STEP 4: Configure inventory.
In the section of current inventory we have the following options to configure.
• Publish and not publish, which is used to define the hotels that will be and will not be in the web portal.
• Make or remove top destinations, which is used to define the cities to be top destinations in the web portal. Notice that once a city is defined as top destination, you should go to the section top destination to define whether it is a local or national top destination and if is a top global destination
• Add or remove hot deal, which is used to define hotels with special offers.
The steps are simple.
1. We check that all hotels and cities are active.
2. Configure the top local destinations and worldwide.
3. We configure the hotel hot deal.
4. We publish hotels and cities we want to appear on the site.
STEP 5: Activate inventory
We go to Inventory List section and we select our inventory and click on Activate and we are ready. Now our new inventory is displayed in the web portal.
The sales module shows all sales and transactions made in Bookingo. All reservations are associated with a sale and a transaction. When the customer makes a reservation and decide to pay at the hotel, the transaction is created, but the sale is not generated until the transaction is complete. When paying through PayPal, once the transaction is complete, the system generates automatically the sale.
Total Sales
In this section you find all the success transactions list made on the site, also you can view details for each one.
To view details click on the VIEW DETAILS button to access the form.
In this new page you can edit:
1. Transaction ID
2. Guest Name
3. Guest Last Name
4. Phone
5. Email
6. Total Price
7. Payment Status
8. Status Message for the transaction.
Transactions
In this section you find all the transactions list made on the site, also you can view details for each one.
To view details click on the VIEW DETAILS button to access the form, this is the same form described in before.
Reservations module shows all reservations made in local hotels, grouped into four categories. Active reservations, pending reservations, booking records, and canceled reservations.
Something to note is that you can access to the details of the reservation in each of the categories mentioned before. Additionally all sections have a search filter to find the number of reservations inventory, reservation number and the name of the applicant.
Active
In this section are show the list of all reservations completed in the website that are active. Active reservations are for the current date, also you can Cancel the reservation making click on CANCEL button, the client has the option in your website to send a cancellation request, so if the cancellation policy is active for the case the admin must cancel the reservation manually in this section, you will receive an email with the request.
Pending Status
In this section, all reservations are overdue or the check-in date already expired.
Record
In this section is the list for all reservations that have been made in the system. In other words shows the complete history of reservations.
Canceled
This section shows all reservations have been canceled.
In the settings module, we configure the appearance of the web portal, any changes in the look of the site is done from here. Additionally it also allows us to create users and view reservation requests to hotels.
• Add User
• Users
• Users Roles
• Appearance
• Email Template
• Decrypt Email Data
• Payment Gateway
To add a user fill the form with the following data:
• Username
• Password
• Repeat Password
• User Role
Submit the form
Here we can see the full list of all users in the system, you also can view details for each user and you can change role, delete, and edit the user.
Here you can add new user roles, and you can see the list of the current roles, you can also delete the ones you don’t use.
In this section we have 2 tabs:
• General Settings
• Page Settings
Is divided in 5 sections, you can change the appearance for the home, you can add page phone number, choose different colors for the current template, add texture to the header and footer, social media links, page copyright, page email for contact form, change the site logo and favicon, home banner, special offers and hot deals.
• Page logo: the logo must be 300x47px
• Page favicon: the file must be .ico
• Page CSS: you can choose from 6 different colors
• Header & Footer Texture: you can choose from 6 different textures
• Page Phone: the phone number that is displayed on the site
• Page Custom Javascript: this is for add the google analytics or other code
• Page Copyright: the site copyrights
• Page Twitter URL: twitter profile URL
• Page Facebook URL: facebook profile URL
• Page Google+ URL: google+ profile URL
• Page Email: is the mail where you receive you contact form emails, you can add multiple emails separated by commas (,)
• Page from email: is the mail show as the sender when you receive the mail
• Title: the title show in the home banner, is limited to 50 characters
• Text: the description or promotional text show in the home banner, is limited to 100 characters, also you can use html tags like <br>
• Banner: it must be 1170x596px to fit well
• Text: add the promotional text, is limited to 30 characters, you can use html tags
• Image: must be 438x246px
• Link for the Hot Deal: you can add the URL generated when you make a hotel search in the website, when you do the search you are redirected to the hotel list, you only need to copy the URL from that search made but not all the link just part of it, ex:
hotel-list.php?sort=pricelow&typesort=price&destino=California&city_id=8
As you can see the last part is city_id, so after this you don’t need to include the last part of the link.
• Image: must be 190x142px
In this section you see the Page list, those are the complete site page, you can click on MANAGE button to edit the SEO data in the following form.
• Page Title: your site title show in the browser tab
• Page Keywords: your site keyword for web positioning, you separate the words with comma (,)
• Page Meta Description: a short description for positioning purpose
• Page Custom Javascript: you can add a specific java code to the current page, some conversion code, or addwords code
From here you can edit the system default emails sent to the admin and client after a reservation.
Is divided in 3 Tabs
• Email Template
• Email Recipients
• Add Email Recipients
• Admin Default Email: is the email where you receive your reservation notifications
• Website Name: your site name show in the emails
• Reply Email: the email show to your client to reply
• From Email: the email show to your client that was used to send the mail
Modify the default emails
for admin and client
Is the mail you receive and your client when you have a new reservation, this is defined for each one, for admin and for the client, the default email has some PHP variables to send important details like itinerary id, guest name, check-in, check-out, room type, email, phone, etc, to identify the tags is simple, for example all are inside {TAGS}, so be careful when you edit the mails.
• New Reservation Admin Email
• New Reservation Client
• New Reservation Admin when the client use Paypal
• New Reservation Client when the client use Paypal
• Cancellation Email for Admin: this is the mail you receive when a guest request to cancel a reservation, if the reservation policy is meet you need to cancel the reservation manually
• Cancellation Email for Client: the mail you guest receive when he/she send the request to cancel a reservation
In this section you see the list of all the additional admin emails you have added to receive a notification when a reservation is made, also you can edit the emails or inactivate it.
Here you add the additional admin emails to receive the reservation notifications.
From here you can Decrypt the Credit Card Info received in the reservation email when a Client make a reservation for pay at the Hotel, to decrypt this information you need first to setup the default SECURITY KEY and SECURITY SALT located in the file encryptor.php you can find this file at: inc/libraries-bgo/class/encryptor.php
• Security Key: the key you defined in the encryptor.php file
• Security Salt: the salt key you defined in the encryptor.php file
• Text to Decrypt: the encrypted data you receive in the email
• Decrypted Text: the original data
Here you choose the Payment type you accept, for the moment only Paypal and pay on the hotel is available, more gateways coming soon.
You can activate or inactivate a payment gateway from here, if you activate Hotel Gateway you will need to install a SSL in you website in order to work this properly.
The Paypal Gateway is configured here, you need to add you Paypal email address and the currency code.
If you have any question or feedback please contact me via my profile in codecanyon.
No direct emails. No twitter message. Thank you.