# Contact Form
{% hint style="info" %}
Important: Developers can use these hooks to customize only the default form.
{% endhint %}
### **ccb\_contact\_form\_style\_class**
This hook allows to change classes of the form itself
**Parameters:**
* **$classes(String)**
* **$settings(Array)**
**Example:**
```php
add_filter(ccb_contact_form_style_class, 'add_form_class', 10, 2);
function add_form_class($classes, $settings){
$classes .= ' my_class'; //replace my_class with the name of your class
return $classes;
}
```
### **ccb\_contact\_form\_submit\_class**
This hook allows you to change the classes of the form itself
**Parameters:**
* **$classes(String)**
* **$settings(Array)**
**Example:**
```php
add_filter(ccb_contact_form_submit_class, 'add_submit_button_class', 10, 2);
function add_submit_button_class($classes, $settings){
if ( $settings['calc_id'] == 22 ) {
$classes[] = 'my-custom-class';
}
return $classes;
}
```
### **ccb\_contact\_form\_submit\_action**
This hook allows you to add HTML code to the submit button.
**Parameters**:
* **$settings(Array)**
**Example:**
```php
add_action('ccb_contact_form_submit_action', 'your_function_name');
function your_function_name($settings){
if($settings['calc_id'] == 240){ //change 240 to your calculator ID!
echo 'custom html code';
}
}
```
### **ccb\_contact\_form\_add\_fields**
This hook adds additional fields to the contact form, when adding an additional field you need to add two hooks **ccb\_contact\_form\_add\_requires**, **ccb\_contact\_form\_add\_text\_form\_fields** and **ccb\_contact\_form\_add\_sendform\_fields** as these parts are mandatory when adding new fields, otherwise when submitting the form an empty value will be passed to the back part.
**Parameters**:
* **$settings(Array)**
**Example:**
```php
add_action('ccb_contact_form_add_fields', 'maby_add_fields', 10, 1);
function maby_add_fields() {
echo '
Custom field title*
';
}
```
### **ccb\_contact\_form\_add\_requires**
This is a hook to add values for fields if the field is mandatory
**Parameters:**
* **$settings(Array)**
**Example:**
```php
add_filter('ccb_contact_form_add_requires', 'add_sendform_requires', 10, 1);
function add_sendform_requires($requires){
$newRequires = array(
'required' => true
);
array_push($requires, $newRequires);
return $requires;
}
```
### **ccb\_contact\_form\_add\_text\_form\_fields**
This is a hook to add text values that are warnings in case the user has not filled in the required fields.
**Parameters:**
* **$settings(Array)**
**Example:**
```php
add_filter('ccb_contact_form_add_text_form_fields', 'add_sendform_required_text_fields', 10, 1);
function add_sendform_required_text_fields($textMessages){
$textMessages['new_message'] = 'New message is required to be filled.';
return $textMessages;
}
```
### **ccb\_contact\_form\_submit\_label**
This is a hook that allows you to change the text of the submit button individually and globally.
**Example:**
```php
function change_submitbtn_label($button_text, $calc_id){
if($calc_id == 252){
$button_text = 'Submit Form';
}
return $button_text;
}
```
### **ccb\_contact\_form\_add\_sendform\_fields**
This is the structure of all fields before submitting to the back end, and is a required part before submitting.
**Parameters:**
* **$settings(Array)**
**Example:**
```php
add_filter('ccb_contact_form_add_sendform_fields', 'add_sendform_fields_to_front', 10, 1);
function add_sendform_fields_to_front($sendformFields){
$newFields = array('name'=> 'new_message', 'required' => true, 'value' => '');
array_push($sendformFields, $newFields);
return $sendformFields;
}
```
### **ccb\_contact\_form\_invalid\_error**
This hook allows you to change the error text when submitting a form
**Parameters:**
* **$text(String)**
**Example:**
```php
add_filter('ccb_contact_form_invalid_error', 'change_form_error_message');
function change_form_error_message(){
return 'Custom error message';
}
```
### **ccb\_contact\_form\_general\_add\_email\_fields**
Add additional fields to receive email notifications in the main calculator settings.
**Example:**
```php
add_action('ccb_contact_form_general_add_email_fields', 'add_receiver_email_fields');
function add_receiver_email_fields(){
echo '
Custom email
';
}
```
### **ccb\_contact\_form\_settings\_add\_email\_fields**
This hook allows you to add recipients through individual calculator settings.
**Example:**
```php
add_action('ccb_contact_form_settings_add_email_fields', 'add_form_receiver_email_fields');
function add_form_receiver_email_fields(){
echo '
Custom email
';
}
```
### **ccb\_email\_subject**
This is a hook to change the subject of an email when sending a calculator form.
**Parameters:**
* **$subject(String)**
* **$calc\_id(Integer)**
**Example:**
```php
add_filter('cbb_email_subject', 'change_email_subject', 10, 2);
function change_email_subject($subject, $calc_id){
if($calc_id == 257){
return 'changed_subject_demo_257';
}
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.stylemixthemes.com/cost-calculator-builder/develeopers-guide/cost-calculator-hooks/contact-form.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.