WP Travel Developer documentation is written for all those developers who are willing to make the changes in the existing functionalities of the plugin and integrate the custom requirements on their own. This document includes all the hooks and filters that our developer team has given in order to make the modification process more easy and dynamic.

One of the major pre-requisite for the fruitful outcome of this documentation is a fluent knowledge on PHP programming language and knowledge on technical side of WordPress.

• Developers can use the Action hooks listed below to trigger the custom function in occurrence of certain event.
• Filter hooks can be implemented if developers are willing to modify the functionality of existing functions.
• Please make sure that no any customization work is being carried out in the main plugin file, since, all the code modifications will revert back with the update in the plugin file.
• While making the changes in the codes using the given hooks, make sure your WP Travel version is up to date. While we are constantly working to add and enhance the functionality of the plugin, hooks might have been modified or deprecated. Using deprecated hooks will show no changes even if you are doing the correct work.

The image below gives the Bird’s eye view of the hooks that is present in the single trip page of the trips.

This filter allows you to remove the title of the trip if you don’t want it to display in the single trip page.

Source

File : /templates/content-single-itineraries.php

Example :

function prefix_wp_travel_show_single_page_title( $show ) {
	return false; // This will hide the page title.
}
add_filter( 'wp_travel_show_single_page_title', 'prefix_wp_travel_show_single_page_title'  );

Source

File : /templates/review.php

Example :

function prefix_wp_travel_review_gravatar_size( $size ) {
	return '50'; // Filters grvatar size.
}
add_filter( 'wp_travel_review_gravatar_size', 'prefix_wp_travel_review_gravatar_size' );

Source

File : /inc/form-fields.php

Example :

function wp_travel_billing_form_edit_fields( $checkout_fields ) {

	unset(
		$checkout_fields['traveller_fields']['country']
	);
	return $checkout_fields;
}

add_filter('wp_travel_checkout_fields','wp_travel_billing_form_edit_fields');

Source

File : /inc/currencies.php

Example :

add_filter( 'wp_travel_currency_symbols', function( $currency_symbols ) {
	 $currency_symbols['USD'] = "Your Text";
	return $currency_symbols;
} );

Source

File : /inc/template-functions.php

Example :

function wp_travel_manage_column(){
return 4;
}
add_filter('wp_travel_archive_itineraries_col_per_row','wp_travel_manage_column');

Source

File : /inc/template-functions.php

Example :

function wp_travel_view_mode(){
	return "grid";
}
add_filter('wp_travel_default_view_mode','wp_travel_view_mode');

Source

File : /inc/helpers/helpers-price.php

Example :

function wp_travel_customize_sale_price_display( $s, $c, $d ) {
   
    if ( is_front_page() ) {
        return sprintf( esc_html__('From %1s %2s', 'wp-travel' ), $c , $d );
    }
    return $s;
}
add_filter( 'wp_travel_itinerary_sale_price', 'wp_travel_customize_sale_price_display', 99, 3 );

This filter changes the string.

Source

File : /inc/helpers.php

Example :

function wp_travel_change_string($localized_strings){
	$localized_strings ['bookings']['start_date'] = 'Departure Date';
	$localized_strings ['bookings']['arrival_date'] = 'Departure Date';
	return $localized_strings;

}
add_filter('wp_travel_strings','wp_travel_change_string');

This filter helps to modify the image size of the gallery.

Source

File : /inc/helpers.php

Example :

function wp_travel_thumbnail_size($sizes){
 $sizes['width'] = 250;
 $sizes['height'] = 250;
 return $sizes;

}

add_filter('wp_travel_image_size','wp_travel_thumbnail_size');

function wp_travel_gallery_image_size( $image_size ) {
	return 'wp_travel_thumbnail';
}
add_filter('wp_travel_gallery_image','wp_travel_gallery_image_size');

This filter helps to remove the end date.

Source

File : /inc/helpers.php

Example :

function wp_travel_remove_dates (){
	return false;
}

add_filter('wp_travel_booking_show_end_date','wp_travel_remove_dates');

This filter helps to replace the text ‘Pricing Name’.

Example :

add_filter( 'gettext', 'wp_travel_change_field_names', 20, 3 );

function wp_travel_change_field_names( $translated_text, $text, $domain ) {

    if ( is_singular() ) {

      switch ( $translated_text ) {

      case 'Pricing Name' :

      $translated_text = __( 'your text here', 'wp-travel' );
      break;
      }

    }

return $translated_text;
}

This hook lets you to add the content above the featured image in single trip page. The content are added in a full width container.

Source

File : /templates/archive-itineraries.php

Example :

function prefix_wp_travel_before_main_content() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_before_main_content', 'prefix_wp_travel_before_main_content'  );

This hook lets you to add the content below the Related Trip section in single trip page. The content are added in a full width container.

Source

File : /templates/archive-itineraries.php

Example :

function prefix_wp_travel_after_main_content() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_after_main_content', 'prefix_wp_travel_after_main_content'  );

This hook lets you to add the content above the featured image in single trip page. The container for thus added content are not in the full width container.

Source

File : /templates/content-single-itineraries.php

Example :

function prefix_wp_travel_before_single_itinerary( $post_id ) {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_before_single_itinerary', 'prefix_wp_travel_before_single_itinerary'  );

This hook is an alternative to the  ‘wp_travel_after_main_content’  hook which allows you to add your custom text  below the “Related Trip” section in single trip page.

Source

File : /templates/content-single-itineraries.php

Example :

function prefix_wp_travel_after_single_itinerary( $post_id ) {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_after_single_itinerary', 'prefix_wp_travel_after_single_itinerary'  );

This hook is an alternative to the ‘wp_travel_before_single_itinerary’ hook which allows you to add your custom text above the featured image in single trip page.

Source

File : /templates/content-single-itineraries.php

Example :

function prefix_wp_travel_before_content_start() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_before_content_start', 'prefix_wp_travel_before_content_start'  );

This hook allows you to add your custom text just above the title of the trip in single trip page.

Source

File : /templates/content-single-itineraries.php

Example :

function prefix_wp_travel_before_single_title( $post_id ) {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_before_single_title', 'prefix_wp_travel_before_single_title'  );

This hook allows you to add your custom text just below the  “Trip Code” i.e at the bottom of the trip meta info section. 

Source

File : /templates/content-single-itineraries.php

Example :

function prefix_wp_travel_single_trip_after_title() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_single_trip_after_title', 'prefix_wp_travel_single_trip_after_title'  );

This hook allows you to add your custom text just below the trip title and above the trip price.

Source

File : /inc/template-functions.php

Example :

function prefix_wp_travel_single_before_trip_price() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_single_before_trip_price', 'prefix_wp_travel_single_before_trip_price'  );

This hook allows you to add your custom content aside the trip price detail section.

Source

File : /inc/template-functions.php

Example :

function prefix_wp_travel_single_trip_after_price() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_single_trip_after_price', 'prefix_wp_travel_single_trip_after_price'  );

This hook allows you to add your custom contents just above the ‘Trip enquiry’ and ‘Book Now’ button and below the trip meta info box in single trip page.

Source

File : /inc/template-functions.php

Introduced on WP Travel version 2.0.4 over wp_travel_single_itinerary_after_trip_meta_list.

Example :

function prefix_wp_travel_single_trip_meta_list() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_single_trip_meta_list', 'prefix_wp_travel_single_trip_meta_list'  );

This hook is an alternative to ‘wp_travel_single_trip_after_title’ hook which allows you to add your custom text at the bottom of the trip meta info box.

Source

File : /inc/template-functions.php

Introduced on WP Travel version 2.0.4 over wp_travel_single_after_booknow.

Example :

function prefix_wp_travel_single_trip_after_booknow() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_single_trip_after_booknow', 'prefix_wp_travel_single_trip_after_booknow);

This hook allows you to add your custom content just above the tabs section of single trip page.

Source

File : /templates/content-single-itineraries.php

Introduced on WP Travel version 2.0.4over wp_travel_after_single_itinerary_header.

Example :

function prefix_wp_travel_single_trip_after_header() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_single_trip_after_header', 'prefix_wp_travel_single_trip_after_header'  );

This hooks allows you to add your custom content in trip overview section

Source

File : /inc/template-functions.php

Example :

function prefix_wp_travel_before_trip_details() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_before_trip_details', 'prefix_wp_travel_before_trip_details'  );

This hook  lets you add the custom content in trip overview content.

Source

File : /inc/template-functions.php

Example :

function prefix_wp_travel_trip_details() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_trip_details', 'prefix_wp_travel_trip_details'  );

This hook is an alternative to ‘wp_travel_before_trip_details’ which lets you add the custom content in the trip overview section.

Source

File : /inc/template-functions.php

Example :

function prefix_wp_travel_after_trip_details() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_after_trip_details', 'prefix_wp_travel_after_trip_details' );

This hook allows you to add the custom content in the trips itinerary page just below the trips listing section.

Source

File : /templates/archive-itineraries.php

Example :

function prefix_wp_travel_archive_listing_sidebar() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_archive_listing_sidebar', 'prefix_wp_travel_archive_listing_sidebar' );

This hook allows you to add your custom content above every individual trips in the trip archive itinerary page.

Source

File : /templates/content-archive-itineraries.php

Example :

function prefix_wp_travel_before_archive_itinerary() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_before_archive_itinerary', 'prefix_wp_travel_before_archive_itinerary' );

This hooks allows you to add the custom content after every trip in the trip archive page.

Source

File : /templates/content-archive-itineraries.php

Example :

function prefix_wp_travel_after_archive_itinerary() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_after_archive_itinerary', 'prefix_wp_travel_after_archive_itinerary' );

This hook allows you to add custom content just above the trips title in archive trip page.

Source

File : /templates/content-archive-itineraries.php

Example :

function prefix_wp_travel_before_archive_content_title() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_before_archive_content_title', 'prefix_wp_travel_before_archive_content_title' );

This hook allows you to add your custom content just below the trips title and above the trips excerpt in trip archive page.

Source

File : /templates/content-archive-itineraries.php

Example :

function prefix_wp_travel_after_archive_title() {
	esc_html_e( 'This is the content added using this hook', 'text-domain' );
}
add_action( 'wp_travel_after_archive_title', 'prefix_wp_travel_after_archive_title' );

This hook allows you to add a custom column in the booking table of WP Travel Dashboard.

Source

File : /templates/account/tab-content/bookings.php

Example :

function prefix_wp_travel_dashboard_booking_table_title_after_detail() {
	echo '<th>New Column</th>'; // Adds new column to the Booking Listings Table on WP Travel Dashboard Page.
}
add_action( 'wp_travel_dashboard_booking_table_title_after_detail', 'prefix_wp_travel_dashboard_booking_table_title_after_detail' );

This hook allows you to add the custom content to the new column created by ‘wp_travel_dashboard_booking_table_title_after_detail’ hook.

Source

File : /templates/account/tab-content/bookings.php

Example :

function prefix_wp_travel_dashboard_booking_table_content_after_detail() {
	echo '<td>data/content</td>'; // Corresponding data to the new columns added.
}
add_action( 'wp_travel_dashboard_booking_table_content_after_detail', 'prefix_wp_travel_dashboard_booking_table_content_after_detail' );

Source

File : /templates/itineraries-list.php

Example :

function prefix_wp_travel_itineraries_after_title( $itinerary ) {
	echo $itinerary['index'];
}
add_action( 'wp_travel_itineraries_after_title', 'prefix_wp_travel_itineraries_after_title' );

This hook allows you to add a text before the review comment.

Source

File : /templates/review.php

Example :

function prefix_wp_travel_review_before_comment_text( $comment ) {
	echo '<p>This text is added before comment text</p>'; //  Adds the content before comments.
}
add_action( 'wp_travel_review_before_comment_text', 'prefix_wp_travel_review_before_comment_text' );

This hook allows you to add a comment just below the review and the gravatar image section.

Source

File : /templates/review.php

Example :

function prefix_wp_travel_review_after_comment_text( $comment ) {
	echo '<p>This paragraph is added after comment text</p>'; //  Adds the content after comments.
}
add_action( 'wp_travel_review_after_comment_text', 'prefix_wp_travel_review_after_comment_text' );

Below given is the list of constants of WP Travel plugin :

• WP_TRAVEL_PLUGIN_FILE
• WP_TRAVEL_ABSPATH
• WP_TRAVEL_PLUGIN_BASENAME
• WP_TRAVEL_PLUGIN_PATH
• WP_TRAVEL_TEMPLATE_PATH
• WP_TRAVEL_VERSION

All the templates file that is within the templates folder of the plugin WP Travel can be overridden.  You can override and modify the template file as per your requirement.

How to override the template file?

Here are the steps that you can follow to override the template file of the plugin.

Step 1: Create the child theme of your current theme.

Step 2: Create the folder “wp-travel” in the child theme.

Step 3: Create the file within the folder “wp-travel” with the same name that you want to override.

Step 4: Finally you can override the file as per your requirement.

Note: The path that you need to follow to override the child theme is mentioned in the header of each template file.

For example, if you want to override the “single-itineraries.php” file then please follow below-given steps.

Step 1: Create the child theme of your current theme.

Step 2: Create the folder “wp-travel” in the child theme.

Step 3: Create the file “single-itineraries.php” within the folder “wp-travel” .

Step 4: Edit the code inside the file “single-itineraries.php” as per your requirement.

Folder and file structure:

File that you need to override:

With the  WP Travel version (1.3.7) , new feature “WP travel dashboard” has been introduced.

For this feature, multiple email template has been added to  the plugin folder which can be override uisng the child theme.

For example, to override the email template “customer-lost-password.php” at first you need to create the child theme.

To know about the process for creating the child theme please refer to below given link:

The very first step after creating the child theme is to create the folder “wp-travel” in your child theme. Inside the folder “wp travel” create another folder “emails“. Now finally create the file “customer-lost-password.php” inside the folder “emails“.

Now copy the content of “customer-lost-password.php” file from parent wp travel plugin folder by going to wp-travel> templates > emails > customer-lost-password.php. After this begin to modify the file as per your requirement through child theme.

Suppose if you want to change the original message that appears in the email for the lost password. You can do so by changing the text through the child theme.

Original file:

After overriding the email template through the child theme.