CityTours - Hotel & Tour Booking Wordpress Theme


Thanks for your purchasing this theme. If you have any questions that are beyond the scope of this help file, please feel free to email us.

Getting Started

To install this theme you must have a working version of WordPress already installed on your server. If you have not determined hosting we recommend you to use a2hosting which faster 20X than the others.
If you need help installing WordPress, follow the instructions in WordPress Codex or you can watch the Instructional Video created by Woo Themes. Below are all the useful links for WordPress information.

 

 

Theme Installation

WordPress Installation

Follow the steps below to install via WordPress.

Step 1 – Navigate to Appearance > Themes.

Step 2 – Click Add New and hit the Upload Theme button.

Step 3 – Navigate to find the "citytours.zip" file on your computer and click "Install Now"

Step 4 – Once uploaded, activate the theme. Go to Appearance > Themes and activate it.

Step 5 – Then you will see a notification message to activate the recommended plugins: CTBooking, Revolution Slider, SliderPro and Contact Form 7. Follow the steps to install and activate each plugin.

Step 6 – You will see a notification message to change permalink setting to post name. Please do this.

wpinstall
Common Install Error: Are You Sure You Want To Do This?

If you get the "Are You Sure You Want To Do This" message when installing citytours.zip file via WordPress, it means you have an upload file size limit. Install the theme via FTP if this happens, or call your hosting company and ask them to increase the limit.

FTP Installation

Follow the steps below to install via FTP.

Step 1 – Log into your hosting space via an FTP software

Step 2 – Unzip the citytours.zip file and ONLY use the extracted CityTours theme folder

Step 3 – Upload the extracted CityTours theme folder into wp-content > themes folder

Step 4 – Activate the newly installed theme. Go to Appearance > Themes and activate it.

Step 5 – Then you will see a notification message to activate the recommended plugins: Revolution Slider, Layer Slider, MailChimp For WP and Contact Form 7. Follow the steps to install and activate each plugin.

Step 6 – You will see a notification message to change permalink setting to post name. Please do this.

ftpinstall

Please check Theme Installation Guide on Wodpress Codex for more detail.

Demo Data

CityTours provides demo data and you can import this.

How to import CityTours demo data

Step 1 – Install and activate required plugins such as CTBooking, Revolution Slider, SliderPro, Redux, Meta-box, etc in CityTours -> Tools menu.

Step 2 – Check System Status and confirm all is ok in CityTours -> Tools menu..

Step 3 – Import demo in CityTours -> Tools menu.

 

There are certain things a WordPress import can not do, so after uploading the demo data make sure you do the following:

  • Go to Settings > Permalinks and configure your permalinks structure (Select Post name).
  • Go to Hotels > Vacancies and create new vacancies.

 

Video Tutorial to install CityTours theme

 

Common Issues & Questions
1. Demo Import Fails or Times Out

Whenever that happens its due to low server memory or execution time, and your host should definitely be willing to adjust that, they have it very low if the content will not import. For example you should get a error message "Maximum execution time of 60 seconds exceeded". Contact your host and explain the issue, they should raise it for you. If you can change php.ini file( like bluehost or if you setup this on your local) please set
max_execution_time=600;
memory_limit=128M;

You can change the setting by editing htaccess or wp-config.php. Please check this article for more detail.

2. Demo Content Duplicated

When you import our demo content it can take several minutes depending on the speed of your server. Each time the button is clicked it will import the content, so if it is clicked twice it will import everything two times. There are two ways to get rid of duplicate content.

  • Method 1: WP Reset Plugin – This plugin is the fastest way to get rid of content. However, it will remove all content from your database and leave the default theme activated. It does not remove plugins, but will deactivate them and remove all pages, posts, menus, sliders, widget data, theme options, etc. Basically it removes all the content that you imported from our theme. Only do this if you are able to start over. Click Here To Download.
  • Method 2: Manual Removal – This method will take longer and simply involves manual removing of duplicate items. For example, go to the pages and delete and duplicate items one by one. Same thing for post, sliders, hotels, etc.

Setting Up Required Pages

To make booking feature to work you need to create some of required pages and set that on Theme Options panel. CityTours has some required & recommended pages such as Cart Page, Checkout Page, Booking Confirmation Page, Dashboard, Custom Login and Terms & Conditions page. There are two options to set these page. 1) After you install theme you can see a message Install Main Pages. You can simply click this button to add and set main pages. 2) Or you can create and set these pages manually. If you import demo data main pages are also imported. Or else you need to create these manually. After that you need set it on Theme Options panel. Bellow is the method how to create and set each required & recommended pages.

  • Hotel Cart Page - You can create a blank page and simply add shortcode [hotel_cart]. After publishing this page set this as Hotel Cart Page on Theme Options/Hotel.
  • Hotel CheckOut Page - You can create a blank page and simply add shortcode [hotel_checkout]. After publishing this page set this as Hotel Cheout Page on Theme Options/Hotel.
  • Hotel Booking Confirmation Page - You can create a blank page and simply add shortcode [hotel_booking_confirmation]. After publishing this page set this as Hotel Booking Confirmation Page on Theme Options/Hotel.
  • Tour Cart Page - You can create a blank page and simply add shortcode [tour_cart]. After publishing this page set this as Tour Cart Page on Theme Options/Tour.
  • Tour CheckOut Page - You can create a blank page and simply add shortcode [tour_checkout]. After publishing this page set this as Tour Cheout Page on Theme Options/Tour.
  • Tour Booking Confirmation Page - You can create a blank page and simply add shortcode [tour_booking_confirmation]. After publishing this page set this as Tour Booking Confirmation Page on Theme Options/Tour.
  • Wishlist Page - You can create create a blank page and set it as Wishlist Page on Theme Options/Booking Settings. If you don't need wishlist feature you don't need to do this.
  • Login Page - If you want to use custom login page please create a page with Login Page Template and set it as Login Page on Theme Options/page/post Settings. If you don't set this setting default wp-login page will work

 

 

Theme Options

You can customize site layout and settings by configuring theme options. To begin configuring theme options, go to Appearance > Theme Options. There are 10 tabs right now.

Basic Settings Tab

Basic settings tab allows you to manage copyright text on footer, your email address, phone number, Modal login and Page preload bar setting

  • Copyright Text - You can manage copyright text on footer by this field.
  • E-Mail Address and Phone Number field - You can manage contact info by this field.
  • Modal Login - If you set this field it will be enabled modal login/signup. So when you click login/signup button a modal will be up.
  • Page preload bar - If you set this option page preload bar will be shown between page changing.
options-general

Styling Options Tab

Styling Options tab allows you to manage logo, favicon, site skin, header style and layouts.

  • Logo - You can upload and set site logo.
  • Favicon - You can manage your favicon. Please make sure you choose an 16x16 ico image for your favicon.
  • Site Skin - CityTours has 4 site skins and you can change your site appearance by changing site skin.
  • Header Style - CityTours support 2 header styles and it gives a new unique personality.
  • Layouts - CityTours provides 3 layouts - left sidebar, right sidebar and no sidebar
options-style

Page/Post Settings Tab

Page/Post Settings tab allows you to set Login Page and Custom 404 Page.

  • Login Page - You can select a page as custom login page. To make a custom login page layout you need to create a page with Login Page template.
  • Page to Redirect to on Login - Once user logged in he/she will be redirected to the page set by this field. If you leave this field blank user will be redirected to the page that user visited before login.
  • 404 page - You can set custom 404 page. If you leave this field blank default 404 layout will be used.
options-main-setting

Blog Settings Tab

Blog Settings tab allows you to set some settings for blog.

options-blog-setting

Booking Settings Tab

Booking Settings tab allows you to set wishlist page and date format.

  • Date Format - You can choose date format for booking pages.
  • Wishlist Page - You can select wishlist page. If you leave this field blank wishlist button won't be showed on header bar.

Currency Settings Tab

Currency Settings tab allows you to set default site currency, available currencies and currency format settings.

  • Default Currency - You can set a currency as default. All price values in admin panel will use this as currency. And users who haven't set their currency will use this.
  • Available Currencies - You can select site currencies by this field. And you can add the currencies on Currencies admin panel.
  • Currency Symbol Position, Decimal Precision and Thousand Separate, Decimal Separate - You can format price field by these 3 fields.
currency-setting

Hotel Tab

Hotel tab allows you to manage settings about Hotel

  • Disable Hotel - You can disable hotel feature by this check box.
  • Hotel Cart Page & Hotel Checkout Page & Hotel Booking Confirmation Page - These fields are required fields and you have to create and set each page. Please use [hotel_cart], [hotel_checkout] and [hotel_booking_confirmation] shortcodes to make each page
  • Invoice Page - This is optional page and if you set this field there will be added invoice button on booking confirmation page.
  • Term & Conditions Page - This is optional page and if you set this field there will be added an agreement field on checkout page.
  • Hotel Review On/Off & Hotel Review Fields - You can enable/disable hotel review feature and set review fields.
  • Price Filter Steps - The option is for price filter steps. For example you can set 50,80,100 to make 4 steps - 0~50, 50~80, 80~100, 100+..
  • Hotels per page - You can set hotels number to show in a page on Hotel search or archive pages. Default values is 12.
  • Email Setting Fields - You can enable/disable/edit notification messages to customer and admin for each booking by these fields.

    You can use pre-defined tags for message title and message body. Please check below list.

    • [home_url]
    • [site_name]
    • [logo_url]
    • [hotel_name]
    • [hotel_url]
    • [hotel_thumbnail]
    • [hotel_address]
    • [hotel_email]
    • [hotel_phone]
    • [booking_rooms]
    • [booking_services]
    • [booking_no]
    • [booking_pincode]
    • [booking_from_date]
    • [booking_to_date]
    • [booking_nights]
    • [booking_adults]
    • [booking_kids]
    • [booking_total_price]
    • [booking_deposit_paid]
    • [booking_deposit_price]
    • [customer_first_name]
    • [customer_last_name]
    • [customer_email]
    • [customer_country_code]
    • [customer_phone]
    • [customer_address1]
    • [customer_address2]
    • [customer_city]
    • [customer_zip]
    • [customer_country]
    • [customer_special_requirements]
    If you have any question or suggestion about this list please feel free to contact us.

options-hotel options-hotel

Tour Tab

Tour tab allows you to manage settings about Tour. Most of all fields are same with Hotel tab such as Disable Tour, Tour Booking Page, Tour Booking Confirmation Page, Terms & Conditions Page, Tours per page, Price Filters and email setting fields

  • Tour Cart Page & Tour Checkout Page & Tour Booking Confirmation Page - These fields are required fields and you have to create and set each page. Please use [tour_cart] and [tour_checkout] and [tour_booking_confirmation] shortcodes to make each page
  • Email Setting Fields - You can enable/disable/edit notification messages to admin and property owner for each booking by these fields.

    You can use pre-defined tags for message title and message body. Please check below list.

    • [home_url]
    • [site_name]
    • [logo_url]
    • [tour_name]
    • [tour_url]
    • [tour_thumbnail]
    • [tour_address]
    • [tour_email]
    • [tour_phone]
    • [booking_services]
    • [booking_no]
    • [booking_pincode]
    • [booking_date]
    • [booking_adults]
    • [booking_kids]
    • [booking_total_price]
    • [booking_deposit_paid]
    • [booking_deposit_price]
    • [customer_first_name]
    • [customer_last_name]
    • [customer_email]
    • [customer_country_code]
    • [customer_phone]
    • [customer_address1]
    • [customer_address2]
    • [customer_city]
    • [customer_zip]
    • [customer_country]
    • [customer_special_requirements]
    If you have any question or suggestion about this list please feel free to contact us.

options-hotel options-hotel

Payment Integration Tab

Payment Integration Tab allows you to manage settings about Payment Integration such as paypal setting

  • PayPal Integration - Paypal Integration Enable/Disable
  • Sandbox Mode - You can enable Sandbox mode for testing. Please don't forget to uncheck this field before you launch site.
  • PayPal API Credentials - Our theme uses PayPal ExpressCheckout feature and these fields are necessary. Please check this article to know how to get PayPal API credentials. If you enabled Sandbox Mode, you have to insert Sandbox API Credentials.
options-payment

Translation

CityTours is ready to localization. If you are not familiar with translating Wordpress themes, we recommend you read this codex page: http://codex.wordpress.org/Translating_WordPress or http://premium.wpmudev.org/blog/how-to-translate-a-wordpress-theme/

  • Step 1: Edit the .po file with POEdit
  • Step 2: Save file with your language name it, for example: de_DE.po.
  • Step 3: Edit wp-config.php located in the root folder of wordpress and define the WPLANG prefix with your language name which should be similar to the translation file name.
  • Step 4: Then go to your server via FTP, navigate to the theme folder and find the languages folder, its located at wp-content > themes > CityTours > languages
  • Step 5: Upload the language files in the languages folder.

 

Hotels

Hotel - Custom Post Type

Hotel is a custom post type and so you can manage it like post. Hotel has several metaboxes like below.

Details Metabox

Bellow are main fields in Details Metabox.

  • District - You can set a district for each hotel. Hotel type is a taxonomy and you can manage the list on Hotel > District page.
  • Facilities - You can set several facilities for each hotel. Facilities is a taxonomy and you can manage it on Hotel > Facilities page
  • Minimum Stay Info - This field will be used for check availability and search. If user pick date interval under this value this hotel will be excluded from search list. You can leave this field to blank if the hotel doesn't have minimum stay data
  • AVG/NIGHT Price - This field is not used for calculation, but it will be used as a presentation price and also will be used on search and sorting.
  • Security Deposit(%) - To enable Security Deposit feature you need to enable payment integration in Theme Options panel. You can leave this field blank if security deposit is not needed for this hotel. And you can insert value 100 if you want customers to pay whole amount of money while booking.
  • Hotel Brief - The content in this field will be worked as a brief.
  • Address & Location - You can write hotel address in Address field. If you set address correctly, location will be automatically calculated and you can see that on map visually.
  • Feature This Hotel - If you set this field this hotel will be added to Featured Hotel List.
  • Slider Content - You can add slider shortcode to this field.
Additional Services

You can add additional service option to each hotel by this metabox.

District - Custom Taxonomy

District is a custom taxonomy and so you can manage it like category

Facilities - Custom Taxonomy

Facilities is a custom taxonomy and you can manage it like tag. Each facility has Amenity Icon and you can select it from icon list. Or you can select and use custom facility image.

Room Types - Custom Post Type

Room Types is a custom post type and you can manage it like post. Room Types has some metabox fields such as Hotel, Max Adults, Max Children, Room Facilities, etc. Max Adults and Max Children field values will be used for search and check availability.

Vacancies

Once you have created hotel and room type you can enter vacancies for this hotel & room type. To create vacancies please click Add New button on Hotels > Vacancies page. You can pick hotel and room type. It has a handy feature - if you pick an hotel, room types that belongs to this hotel will be listed in Room Type field. Please fill the form fields and click Save Vacancies button. You can create multiple vacancies for an hotel room type. Please remember that if you want to discount an hotel price please create a vacancies with discounted value and date range.

options-general

options-general

Orders

Once you create vacancies, visitors to your website will be able to make bookings. If they finish booking the order data will be added to database and you can see and manage it on Hotels > Orders page.

options-general

options-general

Tours

Tour - Custom Post Type

Tour is a custom post type and so you can manage it like post. Tour has several metaboxes like below.

Details Metabox

Bellow are main fields in Details Metabox.

  • Type - You can set an tour type for each tour. Tour type is a taxonomy and you can manage the list on Tour > Tour Types page.
  • Tour Repeatability - If you set Repeated, this tour is considered as a repeatable tour and this tour will have date selection field.
  • Maximum People - You can set available seats by this field.
  • Price Per Person - Tour price per person
  • Price Per Child - Tour price per child
  • Tour Brief - The content in this field will be worked as a brief.
  • Address & Phone No & EmailTour address and contact methods
  • Security Deposit(%) - To enable Security Deposit feature you need to enable payment integration in Theme Options panel. You can leave this field blank if security deposit is not needed for this tour. And you can insert value 100 if you want customers to pay whole amount of money while booking.
  • Featured check box field. If you set this field this tour will be added to Featured List.
  • Slider Content - You can add slider shortcode to this field.
  • Schedule Info - You can set schedule info. If you leave this field blank schedule section won't be listed in the tour detail page.
  • Available Days and special prices for the days of week - You can set available days of week and set special prices for the days.
  • Tour Time - You can set tours times for every day.

Tour Types - Custom Taxonomy

Tour Types is a custom taxonomy and so you can manage it like category

Orders

Once you create tour, visitors to your website will be able to make bookings. If they finish booking the booking data will be added to database and you can see and manage it on Tours > Orders page. And it is quite similar to hotel order panel.

Currencies

You can add or delete currencies on Currencies page. Please remember that Currency Code must be in currency list of currency converter. Now CityTours is using google currency converter. To use google currency converter CURL must be enabled for your server. You can contact to hosting server regarding this. We will add other currency converters and will add manual insert exchange rate feature also.

Reviews

You can manage customer reviews on Reviews page

options-general

Post & Page

Page Templates

CityTours has 3 custom page templates. Bellow is the page template list

  • Home Page Template - This template has search section and search box on top as default. And this template is full width.
  • Login Page Template - This template is made for custom login page. You can create custom login page by this template. After creating custom login page you have to set it as login page on Theme Options > Main Page Settings tab
  • Page Template Full Width - basic page template with full width layout
Page Layout

CityTours has 4 page layouts. Bellow is the page layout list

  • Default Page Template - If you set this field as default the setting you set in theme options panel will work.
  • No Sidebar, Left and Right - You can change page layout to one you selected.

CityTours Supports useful 33+ shortcodes. Please check below list. Each shortcode has a common attribute class and you can add custom class to the element by this attribute. Also you can add shortcode by clicking buttons on admin panel.

Shortcode Name Function Attribute Available Values Default
row        
column   lg 1~12  
    md 1~12  
    sms 1~12  
    sm 1~12  
    xs 1~12  
    lgoff 1~12  
    mdoff 1~12  
    smsoff 1~12  
    smoff 1~12  
    xsoff 1~12  
    lghide yes  
    mdhide yes  
    smhide yes  
    xshide yes  
    lgclear yes  
    mdclear yes  
    smclear yes  
    xsclear yes  
one_half        
one_third        
one_fourth        
two_third        
three_fourth        
container        
toggles   toggle_type accordion  
toggle   title    
    title    
    active yes,no no
button   link   #
    style outline,white,green  
    size medium,full  
    target _blank,_self,_parent,_top,framename _self
banner   style colored  
blockquote        
checklist   icon arrow,triangle,circle,check,chevron,arrow-square,decimal,upper-roman,lower-latin,upper-latin,check-circle triangle
tooltip   title    
    style '', 'advanced'  
    effect 1,2,3,4  
    position top,right,bottom,left  
review   name    
    rating 1 ~ 5 5
    img_url   5
tabs        
tab   id    
    title    
    active yes,no yes
icon_list        
icon_box   icon_class icon_pack_1 & icon_pack_2  
    style style1,style2,style3  
parallax_block   bg_image    
    width   1400
    height   470
hotel_cart        
hotel_checkout        
hotel_booking_confirmation        
hotels   title    
    type latest,featured,popular,selected latest
    style simple,advanced advanced
    count   6
  district You can set district taxonomy id to filter by type.  
  you can select ids if type=selected post_ids    
tour_cart        
tour_checkout        
tour_booking_confirmation        
tours   title    
    type latest,featured,popular,selected latest
    style advanced,simple advanced
    count   6
  you can select ids if type=selected post_ids    
blog   cat category id  
pricing_table   style style1  
    price    
    title    
    btn_title   Buy Now!
    btn_url    
    btn_target _blank,_self,_parent,_top,framename _blank
    btn_color  
    btn_class    
    ribbon_img_url    
    is_featured yes,no no
timeline_container        
timeline   time    
    duration    
    icon_class    

SCRIPTS

  • Bootstrap framework 3.0 http://getbootstrap.com/
  • Revolution Slider http://codecanyon.net/item/slider-revolution-responsive-jquery-plugin/2580848
  • SliderPro http://codecanyon.net/item/slider-pro-responsive-wordpress-slider-plugin/253501

CSS

If you want to customize css we recommend you to write and override css code on custom.css. And we highly recommend you to create a child theme if you need to customize php files. Regarding customization please take a look http://codex.wordpress.org/Child_Themes.

Support includes installation guidance, bugs fixing, and general problem solving with features explained on the theme’s official sales page. Our email address is soaptheme@gmail.com.
Support does not include:

  • solving problems for plugins not packaged with our framework and themes.
  • plugins integration.
  • adding new features or extending the features currently available.
  • any type of modification or customization.