Rates Helper Functions

The helper you can use to create, delete, get and update rates.

function add_rates($rates) {.....}

Supported hooks

Filter name: before_add_rates Description: This filter would be executed before add rate into the database in add_rates helper. Usage:

// The filter callback function is based on the filter.

add_filter( ‘before_add_rates’, ‘before_add_rates_callback_fun’, 10, 1 );

function before_add_rates_callback_fun($rates) {
 // code
}

Filter name: should_add_rates Description: This filter would be executed before add rate into database in add_rates helper. Usage:

// The filter callback function is based on the filter.

add_filter( ‘should_add_rates’, ‘should_add_rates_callback_fun’, 10, 1 );

function should_add_rates_callback_fun($rates) {
    // code
}

hook name: pre.add.rates Description: This hook would be executed before add rate into the database in add_rates helper. Usage:

// The filter callback function is based on the filter.

add_action('pre.add.rates', 'pre_add_rates_callback_fun', 10, 1);

function pre_add_rates_callback_fun($rates) {
    // code
}

hook name: post.add.rates Description: This hook would be executed after add rate into the database in add_rates helper. Usage:

// The filter callback function is based on the filter.

add_action('post.add.rates', 'post_add_rates_callback_fun', 10, 1);

function post_add_rates_callback_fun($rates) {
    // code
}

Usage

// for use rates helper you need to add this helper on controller or
// you can autoload this helper.
$this->load->helper('includes/rates');

// add a new rate in rates table.
$rate_id = add_rates($rates);

Request Parameters

Parameters in array format includes following attributes:

Param	Type	Required	Default	Description
rate_plan_id	Integer	Yes	Null	The rate_plan_id of rate plan table for specific rate.
base_rate	Integer		Null	The base_rate for a specific rate.
adult_1_rate	Decimal Integer		Null	The adult_1_rate for a specific rate.
adult_2_rate	Decimal Integer		Null	The adult_2_rate for a specific rate.
adult_3_rate	Decimal Integer		Null	The adult_3_rate for a specific rate.
adult_4_rate	Decimal Integer		Null	The adult_4_rate for a specific rate.
minimum_length_of_stay	Integer		Null	The additional_adult_rate for a specific rate.
closed_to_arrival	Integer		Null	The closed_to_arrival for a specific rate.
additional_child_rate	Decimal Integer		Null	The additional_child_rate for a specific rate.
maximum_length_of_stay	Integer		Null	The maximum_length_of_stay for specific rate.
closed_to_departure	Integer		Null	The closed_to_departure for a specific rate.
can_be_sold_online	Integer		Null	The can_be_sold_online for a specific rate.
additional_adult_rate	Decimal Integer		Null	The additional_child_rate for a specific rate.

Response

Response include following attributes:
if data have added successfully it would return the key of specific rate id.

retrun $rate_id;

if data does not add it will return null.

function get_rate($rate_id) {....}

Supported hooks

Filter name: before_get_rate Description: This filter would be executed before retrieving rate details from database in get_rate helper. Usage:

// The filter callback function is based on the filter.

add_filter( ‘before_get_rate’, ‘before_get_rate_callback_fun’, 10, 1 );

function before_get_rate_callback_fun($rate_id) {
 // code
}

Filter name: should_get_rate Description: This filter would be executed before retrieving rate details from database in get_rate helper. Usage:

// The filter callback function is based on the filter.

add_filter( ‘should_get_rate’, ‘should_get_rate_callback_fun’, 10, 1 );

function should_get_rate_callback_fun($rate_id) {
    // code
}

hook name: pre.get.rate Description: This hook would be executed before retrieving rate details from database in get_rate helper. Usage:

// The filter callback function is based on the filter.

add_action('pre.get.rate', 'pre_get_rate_callback_fun', 10, 1);

function pre_get_rate_callback_fun($rate_id) {
    // code
}

hook name: post.get.rate Description: This hook would be executed after retrieving rate details from database in get_rate helper. Usage:

// The filter callback function is based on the filter.

add_action('post.get.rate', 'post_get_rate_callback_fun', 10, 1);

function post_get_rate_callback_fun($rate_id) {
    // code
}

Usage

// Retrieves rate data based on a rate_id.
$rate_data = get_rate($rate_id);

Request Parameters

Param	Type	Required	Default	Description
$rate_id	integer	yes	null	The id of the rate corresponds to the rate table

Response

// $response array includes following attributes:
// $response['rate_plan_id'] : the rate_plan_id of specific rate.
// $response['base_rate'] : the base_rate for specific rate.
// $response['adult_1_rate'] : the adult_1_rate for specific rate.
// $response['adult_2_rate'] : the adult_2_rate for specific rate.
// $response['adult_3_rate'] : the adult_3_rate for specific rate.
// $response['adult_4_rate'] : the adult_4_rate for specific rate.
// $response['additional_adult_rate'] : the additional_adult_rate for specific rate.
// $response['minimum_length_of_stay'] : the minimum_length_of_stay for specific rate.
// $response['closed_to_arrival'] : the closed_to_arrival  for specific rate.
// $response['closed_to_departure'] : the closed_to_departure for specific rate.
// and many more attributes for table rate with rate table.
 
// Successfully response giving an array of rate data.

  Array
  (
    [rate_id] => 2
    [rate_plan_id] => 2
    [base_rate] => 
    [adult_1_rate] => 
    [adult_2_rate] => 
    [adult_3_rate] => 
    [adult_4_rate] => 
    [additional_adult_rate] => 
    [additional_child_rate] => 
    [is_deleted] => 
    [minimum_length_of_stay] => 
    [maximum_length_of_stay] => 
    [minimum_length_of_stay_arrival] => 
    [maximum_length_of_stay_arrival] => 
    [closed_to_arrival] => 
    [closed_to_departure] => 
    [can_be_sold_online] => 1
   )
   
// If there is no rate data for any rate id provided in input or any error will return null. 

function get_rates($filter) {.....}

Supported hooks

Filter name: before_get_rates Description: This filter would be executed before retrieving rate details from database in get_rates helper. Usage:

// The filter callback function is based on the filter.

add_filter( ‘before_get_rates’, ‘before_get_rates_callback_fun’, 10, 1 );

function before_get_rates_callback_fun($filter) {
 // code
}

Filter name: should_get_rates Description: This filter would be executed before retrieving rate details from database in get_rates helper. Usage:

// The filter callback function is based on the filter.

add_filter( ‘should_get_rates’, ‘should_get_rates_callback_fun’, 10, 1 );

function should_get_rates_callback_fun($filter) {
    // code
}

hook name: pre.get.rates Description: This hook would be executed before retrieving rate details from database in get_rates helper. Usage:

// The filter callback function is based on the filter.

add_action('pre.get.rates', 'pre_get_rates_callback_fun', 10, 1);

function pre_get_rates_callback_fun($filter) {
    // code
}

hook name: post.get.rates Description: This hook would be executed after retrieving rate details from database in get_rates helper. Usage:

// The filter callback function is based on the filter.

add_action('post.get.rates', 'post_get_rates_callback_fun', 10, 1);

function post_get_rates_callback_fun($filter) {
    // code
}

Usage

// Retrieves rate data based on a filter array.
$rate_data = get_rates($filter);

Request Parameters

parameter array filter required for rate details.

Param	Type	Required	Default	Description
rate_id	Integer	Yes	Null	The rate id the primary key for a specific rate table.
rate_plan_id	Integer	Yes	Null	The rate plan id for specific rate.

Response

// $response array includes following attributes:
// $response['rate_plan_id'] : the rate_plan_id of specific rate.
// $response['base_rate'] : the base_rate for specific rate.
// $response['adult_1_rate'] : the adult_1_rate for specific rate.
// $response['adult_2_rate'] : the adult_2_rate for specific rate.
// $response['adult_3_rate'] : the adult_3_rate for specific rate.
// $response['adult_4_rate'] : the adult_4_rate for specific rate.
// $response['additional_adult_rate'] : the additional_adult_rate for specific rate.
// $response['minimum_length_of_stay'] : the minimum_length_of_stay for specific rate.
// $response['closed_to_arrival'] : the closed_to_arrival  for specific rate.
// $response['closed_to_departure'] : the closed_to_departure for specific rate.

// Successfully response giving you array of rate data.
  Array
(
    [0] => Array
        (
            [rate_id] => 3
            [rate_plan_id] => 1
            [base_rate] => 
            [adult_1_rate] => 20.00
            [adult_2_rate] => 40.00
            [adult_3_rate] => 60.00
            [adult_4_rate] => 80.00
            [additional_adult_rate] => 
            [additional_child_rate] => 
            [is_deleted] => 
            [minimum_length_of_stay] => 
            [maximum_length_of_stay] => 
            [minimum_length_of_stay_arrival] => 
            [maximum_length_of_stay_arrival] => 
            [closed_to_arrival] => 0
            [closed_to_departure] => 0
            [can_be_sold_online] => 1
        )
)

// if there is no rate data for filter provided in input or any error will return null.

function update_rates($rates , $rate_id) {....}

Usage

//update rate data based on a update data and rate id.
 update_rates($rates , $rate_id);

Supported hooks

Filter name: before_update_rates Description: This filter would be executed before update rate into the database in update_rates helper. Usage:

// The filter callback function is based on the filter.

add_filter( ‘before_update_rates’, ‘before_update_rates_callback_fun’, 10, 1 );

function before_update_rates_callback_fun($rates , $rate_id) {
 // code
}

Filter name: should_update_rates Description: This filter would be executed before update rate into database in update_rates helper. Usage:

// The filter callback function is based on the filter.

add_filter( ‘should_update_rates’, ‘should_update_rates_callback_fun’, 10, 1 );

function should_update_rates_callback_fun($rates, $rate_id) {
    // code
}

hook name: pre.update.rates Description: This hook would be executed before update rate into the database in update_rates helper. Usage:

// The filter callback function is based on the filter.

add_action('pre.update.rates', 'pre_update_rates_callback_fun', 10, 1);

function pre_update_rates_callback_fun($rates, $rate_id) {
    // code
}

hook name: post.update.rates Description: This hook would be executed after update rate into the database in update_rates helper. Usage:

// The filter callback function is based on the filter.

add_action('post.update.rates', 'post_update_rates_callback_fun', 10, 1);

function post_update_rates_callback_fun($rates, $rate_id) {
    // code
}

Request Parameters

Request required rate_id and array format data includes following attributes:

Param	Type	Required	Default	Description
rate_id	Integer	Yes	Null	The primary key rate id of rate table for specific rate update.
rate_plan_id	Integer	Yes	Null	The rate_plan_id of rate plan table for specific rate.
base_rate	Integer		Null	The base_rate for a specific rate.
adult_1_rate	Decimal Integer		Null	The adult_1_rate for a specific rate.
adult_2_rate	Decimal Integer		Null	The adult_2_rate for a specific rate.
adult_3_rate	Decimal Integer		Null	The adult_3_rate for a specific rate.
adult_4_rate	Decimal Integer		Null	The adult_4_rate for a specific rate.
minimum_length_of_stay	Integer		Null	The additional_adult_rate for a specific rate.
closed_to_arrival	Integer		Null	The closed_to_arrival for a specific rate.
additional_child_rate	Decimal Integer		Null	The additional_child_rate for a specific rate.
maximum_length_of_stay	Integer		Null	The maximum_length_of_stay for specific rate.
closed_to_departure	Integer		Null	The closed_to_departure for a specific rate.
can_be_sold_online	Integer		Null	The can_be_sold_online for a specific rate.
additional_adult_rate	Decimal Integer		Null	The additional_child_rate for a specific rate.

Response

Response return mixed Either true or null if rate data is updated then true else null.

function delete_rate($rate_id) {.....}

Usage

// delete a rate data from the rates table. it's a soft delete process only status will change data still existing in the backend database.

 delete_rate($rate_id);

Request Parameters

Param	Type	Required	Default	Description
$rate_id	integer	yes	null	The id of the rate corresponds to the rate table

Response

Response return mixed Either true or null if rate data is deleted then true 
else null.