Customer Helper Functions

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

function add_customer($customer) {.....}

Supported hooks

Filter name: before_add_customer Description: This filter would be executed before add customer into the database in add_customer helper. Usage:

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

add_filter( ‘before_add_customer’, ‘before_add_customer_callback_fun’, 10, 1 );

function before_add_customer_callback_fun($customer) {
 // code
}

Filter name: should_add_customer Description: This filter would be executed before add customer into database in add_customer helper. Usage:

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

add_filter( ‘should_add_customer’, ‘should_add_customer_callback_fun’, 10, 1 );

function should_add_customer_callback_fun($customer) {
    // code
}

hook name: pre.add.customer Description: This hook would be executed before add customer into the database in add_customer helper. Usage:

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

add_action('pre.add.customer', 'pre_add_customer_callback_fun', 10, 1);

function pre_add_customer_callback_fun($customer) {
    // code
}

hook name: post.add.customer Description: This hook would be executed after add customer into the database in add_customer helper. Usage:

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

add_action('post.add.customer', 'post_add_customer_callback_fun', 10, 1);

function post_add_customer_callback_fun($customer) {
    // code
}

Usage

// for use customer helper you need to add this helper on controller or
// you can autoload this helper.

$this->load->helper('includes/customer');

// add a new customer in customer table. And add customer's primary card details. 
$customer_id = add_customer($customer);

Request Parameters

Parameters in array format includes following attributes:

ParamTypeRequiredDefaultDescription

customer_name

Character

Yes

Null

The customer name of a specific customer.

address

Character

Null

The address for specific customer.

city

Character

Null

The city for a specific customer.

region

Character

Null

The region for a specific customer.

country

Character

Null

The country for a specific customer.

postal_code

Character

Null

The postal_code for a specific customer.

phone

Character

Null

The phone number of a specific customer.

fax

Character

Null

The fax for a specific customer.

email

Character

Null

The email id of specific customer.

company_id

Integer

Yes

Null

The company_id for specific customer.

customer_notes

Character

Null

The customer_notes for a specific customer.

phone2

Character

Null

The phone2 second number of a specific customer.

address2

Character

Null

The address2 second address of a specific customer.

customer_type

Character

Null

The customer_type for a specific customer.

is_primary

Integer

Yes

1

The is_primary if active then customer card add as a primary card for a specific customer.

card_name

Character

Yes

Null

The card_name for a specific customer card details.

cc_number

Character

Yes

Null

The cc_number of the card for customer card details.

cvc

Character

Yes

Null

The cvc of the card for customer card details.

cc_expiry_month

Character

Yes

Null

The cc_expiry_month of the card for customer card details.

cc_expiry_year

Character

Yes

Null

The cc_expiry_year of the card for customer card details.

Response

Response includes the following attributes:
if data have been added successfully it would return the key of specific customer id.
return $customer_id;
if data does not add it will return null.

function get_customer($customer_id) {....}

Supported hooks

Filter name: before_get_customer Description: This filter would be executed before retrieving customer details from database in get_customer helper. Usage:

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

add_filter( ‘before_get_customer’, ‘before_get_customer_callback_fun’, 10, 1 );

function before_get_customer_callback_fun($customer_id) {
 // code
}

Filter name: should_get_customer Description: This filter would be executed before retrieving customer details from database in get_customer helper. Usage:

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

add_filter( ‘should_get_customer’, ‘should_get_customer_callback_fun’, 10, 1 );

function should_get_customer_callback_fun($customer_id) {
    // code
}

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

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

add_action('pre.get.customer', 'pre_get_customer_callback_fun', 10, 1);

function pre_get_customer_callback_fun($customer_id) {
    // code
}

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

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

add_action('post.get.customer', 'post_get_customer_callback_fun', 10, 1);

function post_get_customer_callback_fun($customer_id) {
    // code
}

Usage

// Retrieves customer data based on a customer_id.
$customer_data = get_customer($customer_id);

Request Parameters

ParamTypeRequiredDefaultDescription

$customer_id

Integer

Yes

Null

The primary id of the customer corresponds to the customer table

Response

// Successfully response giving you array of customer data.
Array
(
    [customer_id] => 21
    [customer_name] => vishal solanki
    [address] => 162 banganga
    [city] => indore
    [region] => 
    [country] => india
    [postal_code] => 452007
    [phone] => 45435656657
    [fax] => 
    [email] => 
    [company_id] => 1
    [customer_notes] => 
    [is_deleted] => 0
    [customer_type] => 
    [cc_number] => 
    [cc_expiry_month] => 
    [cc_expiry_year] => 
    [stripe_customer_id] => 
    [customer_type_id] => 1
    [address2] => 
    [phone2] => 36546667667
    [cc_tokenex_token] => 
    [cc_cvc_encrypted] => 
    [customer_fields] => Array
        (
        )

)

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

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

Supported hooks

Filter name: before_get_customers Description: This filter would be executed before retrieving customer details from database in get_customers helper. Usage:

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

add_filter( ‘before_get_customers’, ‘before_get_customers_callback_fun’, 10, 1 );

function before_get_customers_callback_fun($filter) {
 // code
}

Filter name: should_get_customers Description: This filter would be executed before retrieving customer details from database in get_customers helper. Usage:

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

add_filter( ‘should_get_customers’, ‘should_get_customers_callback_fun’, 10, 1 );

function should_get_customers_callback_fun($filter) {
    // code
}

hook name: pre.get.customers Description: This hook would be executed before retrieving customer details from database in get_customers helper. Usage:

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

add_action('pre.get.customers', 'pre_get_customers_callback_fun', 10, 1);

function pre_get_customers_callback_fun($filter) {
    // code
}

hook name: post.get.customers Description: This hook would be executed after retrieving customer details from database in get_customers helper. Usage:

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

add_action('post.get.customers', 'post_get_customers_callback_fun', 10, 1);

function post_get_customers_callback_fun($filter) {
    // code
}

Usage

// Retrieves customer data based on a filter array.
$customer_data = get_customers($filter);

Request Parameters

parameter array filter required for payment details.

ParamTypeRequiredDefaultDescription

customer_name

Character

Yes

Null

The customer name for a specific customer details.

customer_id

Integer

Yes

Null

The customer_id for a specific customer.

company_id

Integer

Yes

Null

The company_id for a specific customer.

email

Character

Yes

Null

The email for a specific customer.

Response

// $response array includes following attributes:
// $response['customer_name'] : the customer_name of specific customer.
// $response['address'] : the address for specific customer .
// $response['city'] : the is_percentage for specific customer.
// $response['region'] : the region for specific customer.
// $response['country'] : the country for specific customer.
// $response['postal_code'] : the postal_code for specific customer.
// $response['phone'] : the phone for specific customer.
// $response['fax'] : the fax for specific  customer.
// $response['email'] : the email for specific customer.
// $response['customer_notes'] : the customer_notes for specific customer.
// $response['customer_type'] : the customer_type for specific customer.
// $response['address2'] : the customer_notes for specific customer.
// $response['phone2'] : the customer_notes for specific customer.
// $response['is_primary'] : the is_primary for specific customer card details.
// $response['card_name'] : the card_name for specific customer card details.
// $response['cc_number'] : the cc_number for specific customer card details.
// $response['cvc'] : the cvc for specific customer card details.
// $response['cc_expiry_month'] : the cc_expiry_month for specific customer card details.
// $response['cc_expiry_year'] : the cc_expiry_year for specific customer card details.
// and many more attributes for table customer and join with customer card details .

// Successfully response giving you array of customer data.

Array
(
    [0] => Array
        (
            [customer_id] => 21
            [customer_name] => vishal solanki
            [address] => 162 banganga
            [city] => indore
            [region] => 
            [country] => india
            [postal_code] => 452007
            [phone] => 45435656657
            [fax] => 
            [email] => 
            [company_id] => 1
            [customer_notes] => 
            [is_deleted] => 0
            [customer_type] => 
            [cc_number] => 
            [cc_expiry_month] => 
            [cc_expiry_year] => 
            [stripe_customer_id] => 
            [customer_type_id] => 1
            [address2] => 
            [phone2] => 36546667667
            [cc_tokenex_token] => 
            [cc_cvc_encrypted] => 
            [id] => 6
            [is_primary] => 1
            [evc_card_status] => 
            [card_name] => 
            [is_card_deleted] => 0
            [customer_meta_data] => 
        )

)

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

function update_customers($customer, $customer_id) {....}

Usage

//update customer data based on a update data and customer id.
 update_customer($customer, $customer_id);

Supported hooks

Filter name: before_update_customer Description: This filter would be executed before update customer into the database in update_customer helper. Usage:

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

add_filter( ‘before_update_customer’, ‘before_update_customer_callback_fun’, 10, 1 );

function before_update_customer_callback_fun($customer, $customer_id) {
 // code
}

Filter name: should_update_customer 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_customer’, ‘should_update_customer_callback_fun’, 10, 1 );

function should_update_customer_callback_fun($customer, $customer_id) {
    // code
}

hook name: pre.update.customer Description: This hook would be executed before update customer into the database in update_customer helper. Usage:

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

add_action('pre.update.customer', 'pre_update_customer_callback_fun', 10, 1);

function pre_update_customer_callback_fun($customer, $customer_id) {
    //code
}

hook name: post.update.customer Description: This hook would be executed after update customer into the database in update_customer helper. Usage:

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

add_action('post.update.customer', 'post_update_customer_callback_fun', 10, 1);

function post_update_customer_callback_fun($customer, $customer_id) {
    // code
}

Request Parameters

Request required customer_id and array format data includes following attributes:

ParamTypeRequiredDefaultDescription

customer_name

Character

Yes

Null

The customer name of a specific customer.

address

Character

Null

The address for specific customer.

city

Character

Null

The city for a specific customer.

region

Character

Null

The region for a specific customer.

country

Character

Null

The country for a specific customer.

postal_code

Character

Null

The postal_code for a specific customer.

phone

Character

Null

The phone number of a specific customer.

fax

Character

Null

The fax for a specific customer.

email

Character

Null

The email id of specific customer.

customer_notes

Character

Null

The customer_notes for a specific customer.

phone2

Character

Null

The phone2 second number of a specific customer.

address2

Character

Null

The address2 second address of a specific customer.

customer_type

Character

Null

The customer_type for a specific customer.

Response

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

function delete_customer($customer_id) {.....}

Usage

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

 delete_customer($customer_id);

Request Parameters

ParamTypeRequiredDefaultDescription

$customer_id

Integer

Yes

Null

The id of the customer corresponds to the customer table

Response

Response return mixed Either true or null if customer data is deleted then true 
else null.
PreviousCompany Helper FunctionsNextBooking Helper Functions

Last updated