Developer Support

Display Enquiry Ban IP Actions & Filters

Display Enquiry

You can display all contact form submission data on front end side of website to place the short codes.

You can place these short codes in any page OR use to "do_shortcode" function to execute from php files.

Ex. do_shortcode( ‘[acf7db form_id='30f46fb']’ );

Note: If you want to use the short code, please purchase the User Access Manager add-on to enable it.

You can use below options in short codes:

Parameter Description Example
FORM ID

You can add form id to display the form data.

[acf7db form_id='30f46fb']

You need to add multiple form ids to display multiple form data.

[acf7db form_id='30f46fb,30f47yz']

Note:- If you don't pass id in it or keep empty than output will have all forms data.

SHOW

You need to add the columns names with form ids to display on front end side.

This will display only 1 column for form 30f46fb data, and all columns for form 30f47yz data.

[acf7db form_id='30f46fb,30f47yz' show='30f46fb.your-name']

You can also add multiple columns to display multiple form data.

This will display only 1 column for form 30f46fb and form 30f47yz data.

[acf7db form_id='30f46fb,30f47yz' show='30f46fb.your-name, 30f47yz.your-email']
HIDE

You can specify particular columns which you won't like to display.

It means that to display all columns except 1 column ("your-name") for form 30f46fb data, and all columns for form 30f47yz data.

[acf7db form_id='30f46fb,30f47yz' hide='30f46fb.your-name']

You can also add multiple columns to don't display multiple form data.

This will display all columns except 1 column ("your-name") for form 30f46fb data, and all columns except 1 column ("your-email") for form 30f47yz data.

[acf7db form_id='30f46fb,30f47yz' hide='30f46fb.your-name, 30f47yz.your-email']
SEARCH

You can search by keyword.

It will display all submitted data with value like "test@gmail.com".

[acf7db form_id='30f46fb,30f47yz' search='test@gmail.com']
DATE

You can search by date using date parameters.

It is required to pass "start-end date". If any one date will be mentioned then it doesn't work.

It's means that to display all submitted data with submit time in between "01/09/2017" and "01/10/2018" .

[acf7db form_id='30f46fb,30f47yz' start-date="01/09/2017" end-date="01/10/2018"]

Note:- This parameter will have effect if start date and end date both given with proper format. Both date should be in "dd/mm/yyyy" format.

ID

You can add id to the table tag of output data.

This will add id to the table.

[acf7db form_id='30f46fb,30f47yz' id='my-table-id']

Note:- This parameter will have effect only when format "Table" is given.

CLASS

You can add classes to the table tag of output data.

This will add classes to the table.

[acf7db form_id='30f46fb,30f47yz' class='form-table-class1 form-table-class2']

Note:- This parameter will have effect only when format "Table" is given.

STYLE

You can add style to the table tag of output data.

This will add style to the table.

[acf7db form_id='30f46fb,30f47yz' style='max-width=400px;']

Note:- This parameter will have effect only when format "Table" is given. Style will be added as inline style.

HEADER

You can add custom header which will be displayed as title for every table. Headers must be used with form id to to affect the output data.

This will display "Form Header Text 1" as title for form 30f46fb data. Form 30f47yz data title will be form name.

[acf7db form_id='30f46fb,30f47yz' header='30f46fb.Form Header Text 1']

You can add multiple columns which will be displayed for multiple form data.

This will display "Form Header Text 1" as title for form 30f46fb data and "Form Header Text 2" as title for Form 30f47yz data.

[acf7db form_id='30f46fb,30f47yz' header='30f46fb.Form Header Text 1, 30f47yz.Form Header Text 2']

Note:- This parameter will have effect only when format "Table" is given. If header is not passed than it will use form title.

DISPLAY

You can select the output type from following types :

This will output the short code as a table structure.

[acf7db form_id='30f46fb,30f47yz' display='table']

This will output the short code as a data count only.

[acf7db form_id='30f46fb,30f47yz' display='count']

Ban IP

You can use below short code to skip saving of IP address :

Skip Saving Of IP Address

[cf7-db-display-ip]

OR
do_shortcode( ‘[cf7-db-display-ip]’ );

Note
You need to add this code in function file to skip saving IP address.

Actions & Filters

Here a list of actions and filters added is given.

You can use below hooks as per your requirement at your own risk.

Actions

vsz_cf7_display_settings_btn

Parameters : $fid

You can change "Display Settings" using this action.

add_action("vsz_cf7_display_settings_btn","vsz_cf7_display_settings_btn_callback",10, 1);
function vsz_cf7_display_settings_btn_callback($fid){

   // Your custom coding here

}
vsz_cf7_after_datesection_btn

Parameters : $fid

Using this action,you can add custom coding after date section in listing screen.

add_action("vsz_cf7_after_datesection_btn","vsz_cf7_after_datesection_btn_callback",10, 1);
function vsz_cf7_after_datesection_btn_callback($fid){

   // Your custom coding here

}
vsz_cf7_after_bulkaction_btn

Parameters : $fid

Using this action,you can add custom coding after bulk action section in listing screen.

add_action("vsz_cf7_after_bulkaction_btn","vsz_cf7_after_bulkaction_btn_callback",10, 1);
function vsz_cf7_after_bulkaction_btn_callback($fid){

   // Your custom coding here

}
vsz_cf7_admin_after_heading_field

Parameters : -

Using this action,you can display table header in edit column.

add_action("vsz_cf7_admin_after_heading_field","vsz_cf7_admin_after_heading_field_callback",10);
function vsz_cf7_admin_after_heading_field_callback(){

   // Your custom coding here

}
vsz_cf7_admin_after_body_field

Parameters : $fid, $row_id

Using this action, you can add custom coding before edit icon.

add_action("vsz_cf7_admin_after_body_field","vsz_cf7_admin_after_body_field_callback",10, 2);
function vsz_cf7_admin_after_body_field_callback($fid,$row_id){

   // Your custom coding here

}
vsz_cf7_after_admin_form

Parameters : $fid

Using this action, you can add custom coding after whole form.

add_action("vsz_cf7_after_admin_form","vsz_cf7_after_admin_form_callback",10, 1);
function vsz_cf7_after_admin_form_callback($fid){

   // Your custom coding here

}
vsz_cf7_before_insert_db

Parameters : $contact_form

Using this action, you can customize form data before insert in data base.

add_action("vsz_cf7_before_insert_db","vsz_cf7_before_insert_db_callback",10,1);
function vsz_cf7_before_insert_db_callback($contact_form){

   // Your custom coding here

}
vsz_cf7_after_insert_db

Parameters : $contact_form, $cf7_id, $data_id

Using this action, you can customize process after insert value in data base.

add_action("vsz_cf7_after_insert_db","vsz_cf7_after_insert_db_callback",10, 3);
function vsz_cf7_after_insert_db_callback($fid,$cf7_id,$data_id){

   // Your custom coding here

}

Filters

vsz_cf7_entry_order_by

Parameters : String

You can change the order of fields using this filter.

add_filter("vsz_cf7_entry_order_by","vsz_cf7_entry_order_by_callback",10,1);
function vsz_cf7_entry_order_by_callback($order){

   // Your custom coding here
   return $order;

}
vsz_cf7_entry_per_page

Parameters : Integer (Default: 10)

You can change the number of entries per page using this filter.

add_filter("vsz_cf7_entry_per_page","vsz_cf7_entry_per_page_callback",10,1);
function vsz_cf7_entry_per_page_callback($num){

   // Your custom coding here
   return $num;

}
vsz_display_character_count

Parameters : Integer (Default: 30)

This filter defines how many characters will be displayed in listing screen. You can change the number of characters displayed using this filter.

add_filter("vsz_display_character_count","vsz_display_character_count_callback",10,1);
function vsz_display_character_count_callback($count){

   // Your custom coding here
   return $count;

}
vsz_cf7_not_editable_fields

Parameters : Array

You can change non editable fields list using this filter.

add_filter("vsz_cf7_not_editable_fields","vsz_cf7_not_editable_fields_callback",10,1);
function vsz_cf7_not_editable_fields_callback($arr){

   // Your custom coding here
   return $arr;

}
vsz_cf7_entry_actions

Parameters : Array

You can add/remove any option for "Bulk Action" in listing screen.

add_filter("vsz_cf7_entry_actions","vsz_cf7_entry_actions_callback",10,1);
function vsz_cf7_entry_actions_callback($arr){

   // Your custom coding here
   return $arr;

}
vsz_cf7_import_date_format

Parameters : -

You can change the date format to import functionality with this filter.

add_filter("vsz_cf7_import_date_format","vsz_cf7_import_date_format_callback",10);
function vsz_cf7_import_date_format_callback(){

   // Your custom coding here
   $format = "Y-m-d";
   return $format;

}
vsz_cf7_unwanted_form_data_submission

Parameters : Array

You can exclude contact form ids using this filter and those form entries won't be inserted in advanced contact form database.

add_filter("vsz_cf7_unwanted_form_data_submission","vsz_cf7_unwanted_form_data_submission_callback",10,1);
function vsz_cf7_unwanted_form_data_submission_callback($arr){

   // Your custom coding here
   return $arr;

}
vsz_cf7_modify_form_before_insert_data

Parameters : $contact_form

You can change the entry data before it saved to database.

add_filter("vsz_cf7_modify_form_before_insert_data","vsz_cf7_modify_form_before_insert_data_callback",10,1);
function vsz_cf7_modify_form_before_insert_data_callback($contact_form){

   // Your custom coding here
   return $contact_form;

}
vsz_cf7_posted_data

Parameters : $posted_data

This filter provided to the users to modify the data.Below is the process that can be performed

1) Add new data to the CF7 Form
2) Can modify the existing form submitted data
3) Can unset or remove the existing form data of CF7

add_filter("vsz_cf7_posted_data","vsz_cf7_posted_data_callback",10,1);
function vsz_cf7_posted_data_callback($posted_data){

   // Your custom coding here
   return $posted_data;

}
vsz_cf7_no_save_fields

Parameters : Array

You can exclude contact form ids using this filter and those form field's entry won't be inserted in advanced contact form database.

add_filter("vsz_cf7_no_save_fields","vsz_cf7_no_save_fields_callback",10,1);
function vsz_cf7_no_save_fields_callback($arr){

   // Your custom coding here
   return $arr;

}
cf7d_entry_value

Parameters : Value,Key

You can modify specific field value using this filter.

add_filter("cf7d_entry_value","cf7d_entry_value_callback",10,2);
function cf7d_entry_value_callback($val,$key){

   // Your custom coding here
   return $val;

}
vsz_cf7_admin_fields

Parameters : Fields, fid

You can modify fields displaying in listing screen using this filter.

add_filter("vsz_cf7_admin_fields","vsz_cf7_admin_fields_callback",10,2);
function vsz_cf7_admin_fields_callback($fields,$fid){

   // Your custom coding here
   return $fields;

}
vsz_cf7_get_current_action

Parameters : $current_action

If you have added additional option in "Bulk Actions", then you need to do custom coding for that additional option over here.

add_filter("vsz_cf7_get_current_action","vsz_cf7_get_current_action_callback",10,1);
function vsz_cf7_get_current_action_callback($current_action){

   // Your custom coding here
   return $current_action;

}