3. Using Cost Calculator

INTRODUCTION

Cost Calculator options

After Cost Calculator is installed and activated, you should see Cost Calculator custom post type on your dashboard.
http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/05/Screenshot_1.jpg

From the latest plugin update, Cost Calculator can be edited as a custom post type.

In order to create new calculator, click on Add New option. Should you want to edit one of the existing calculators, you need to import demo content. Instructions on how to install demo content can be found in Installing Demo section.

Once you click on ‘Add New’ option, you will see box with big ‘+’ button. Click on it to add Cost Calculator element.

http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/11/Screenshot_1-1.jpg

Cost Calculator has several commands, such as:

  • Add – add new element to the Cost Calculator.
  • Edit – edit Cost Calculator settings such as accent color, currency, set PayPal, etc.
  • Duplicate – duplicate an element or entire calculator.
  • Copy – copy an element or entire calculator.
  • Copy + – copy several elements one after the other.
  • Paste – paste previously copied element / calculator.
  • Delete – delete an element or entire calculator.

http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/11/Screenshot_2-1.jpg

SECTION 01

Cost Calculator Settings

If you edit Cost Calculator element (pencil icon), you will see dialog with several options.

General Settings


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/08/cc-general.jpg

Accent Color – Select accent color with color option.

Total Title – Enter optional title for total.

Total Format – Select the format in which your total will display.

Number of Decimals in Total – Select the number of decimals total will have.

Currency  Enter currency symbol or code.

Currency After Total – Shows currency after result of calculation.

Space Between Currency and Total – Select if you want to show space between currency and total.


Contact-Form


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/09/calculator-settings-contact-form.jpg

Display Next Button and Contact Form – once the field is checked, ‘Next’ button and contact form will be visible. If you only want Total bar to be displayed, deselect this field.

Next Button Text – enter the text that will display on ‘Next’ button.

Contact Form Initially Visible (Remove Next Button) – check if you want contact form to be visible below total bar. This will remove ‘Next’ button.

Contact Form 7 Id – Select from the dropdown list Contact Form 7 which will be used instead of default form. Make sure to include [hidden bt-cc-data] shortcode in your Form section, and [bt-cc-data] shortcode to Mail section. For more info, go to: Contact Form 7.

Admin Email – Field where you can enter email to which calculator data will be submitted.

Email Subject – Present subject of the email.

Send Email to Client – Once it is checked copy of quote will be sent to client email (if client has entered email in contact form).

Email confirmation – Checkbox for sending email to client to show client email confirmation checkbox at the bottom of the contact form.

Optional URL for confirmation – If URL is added to the field, users will be redirected to that page, once they submit the form.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/08/cc-form-1.jpg

Show Date/Time Inputs – Select if date and time fields will display in contact form or not.

Date Input Title – Enter optional title for Preferred Service Date.

Date Input Format – Enter desired date format.

Time Input Title – Enter optional title for Preferred Service Time.

Time Input Start and Time Input End – Define interval for Preferred Service Time select box.

Time Input Format – Define the time format for timepicker (24-hour or 12-hour).

Mandatory data (Name, Email, Phone, Address, Message, Preferred Date and Time) – Can be selected by Mandatory checkboxes.


reCAPTCHA


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/05/cc-recaptcha.jpg

reCAPTCHA Site  and reCAPTCHA Secret key – If you want to use get reCAPTCHA Site key and reCAPTCHA Secret key.


PayPal


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/05/cc-paypal.jpg

PayPal – If you want to use PayPal you must fill in Your PayPal account email address, Shopping cart name and Currency code. If PayPal email is entered you will see PayPal button used to forward data to PayPal and make a payment. If you use multiply container with PayPal, value of first item is used as unit price and name of first item is used as item name, other values are multiplied and the product is used as quantity. Slider offset is ignored if PayPal is active.

If you have Cost Calculator group element included in your calculator make sure to enter PayPal Label in Cost Calculator Group edit panel. If you don’t add label, the group will not be included in PayPal payment.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/09/cc-doku..jpg

Design


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/05/cc-design.jpg

Enter class name(s) in Extra Class Name(s).

Inline style – Add required CSS statements for inline style.


When you are finished with editing your Cost Calculator, copy its shortcode (e.g. [bt_cc id=”116″]) and paste it in Text element on desired page.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/05/cc-shortcode.jpg

SECTION 02

Using Contact Form 7

From the plugin version 1.2.3, Contact Form 7 can be used instead of default Cost Calculator Contact Form. In order to use your form, make sure to include [hidden bt-cc-data] shortcode in Form section. Please have a look at the following screenshot:


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2017/11/cc-contact-form-7.jpg

Also, make sure to add [bt-cc-data] shortcode to Mail section in Contact Form 7 editor.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2017/11/new-contact-form-7-mail.jpg

When you are finished with editing your Contact Form 7, navigate to calculator where you want to add contact form, and select that form from dropdown in Cost Calculator Contact Form 7 Id field.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/07/cf-7.jpg


SECTION 03

Translate Plugin

The procedure is standard – you can find the .pot file in the plugin’s languages folder.

Please use PoEdit to translate the .pot file and create respective .po and .mo fies.

You should upload .po and .mo files created using PoEdit back to plugin’s languages folder.

Please name .po and .mo files for example: bt-cost-calculator-nl_NL.po and bt-cost-calculator-nl_NL.mo (nl_NL is the language code for dutch) and place them in /wp-content/plugins/bt_cost_calculator/languages/. 

For other languages code, please refer to the following link: Internationalization.

You can set the site language of your WordPress installation on Settings > General. WordPress will automatically use the right language files if they exist.


SECTION 04

Exporting Cost Calculator

Here is how to export Cost Calculator from one site to the other.

In order to export the calculator you created from one site, and import it to another one, please follow these steps:

1. Open calculator you want to copy, and click on Copy button.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/06/Screenshot_1.jpg

2. Then, click on the two arrows at the bottom of the screen.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/06/Screenshot_2.jpg

3. On the pop up that appears, click export, and copy the symbols that appear.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/06/Screenshot_3.jpg

4. After that select to add new calculator to the site where you want to copy it. Click on the blue button to add Cost Calculator settings.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/06/Screenshot_4.jpg

5. Then again click on the two arrows on the bottom of the screen, paste the symbols you previously copied, and click ‘Import’ button.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/06/Screenshot_5.jpg

6. Close the pop up, and on the Cost Calculator settings panel click ‘Paste’.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/06/Screenshot_6.jpg

Make sure to save changes and now your calculator should be properly copied.


SECTION 05

FAQ

  • How to use custom CSS statements to style calculator?
  • How to change the e-mail address from WordPress?
  • How to edit clients email?
  • How to update a plugin?
  • Will I lose content when updating the plugin?
  • Remove “Next“ button
  • Contact Form visible by default
  • How do I remove the bar with Total and leave contact form?
  • Adding additional fields to contact form
  • How can I change total format’s display?
  • How to redirect users to another page after submiting message?
  • How to redirect users to another page after the “Next“ button?
How to use custom CSS statements to style calculator?

Custom CSS should be added to your theme’s Custom / Additional CSS field.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/05/cc-css.jpg

Alternatively, you can use third party plugin such as Simple Custom CSS.

How to change the e-mail address from WordPress?

In order to change the sender name, if the visitor and admin are receiving an e-mail from “WordPress”, we suggest you to avoid code customization and to install a third party plugin which will allow this. For example this one: WP Simple Mail Sender.

How to edit clients email?

In order to change the clients email than you should locate the bt_cost_calculator.php file and find function bt_cc_callback() in the code. The email formatting starts from the line:

$message_to_admin = ...
How to update a plugin?

If you have not customized the calculator, please download the latest version and rewrite the old files on the server with the new ones. The calculator files should be in /wp-content/plugins/bt_cost_calculator/ of your WordPress installation.

If you have customized the code, you will need to reapply the changes prior to upload of new version.

Will I lose content when updating the plugin?

With new plugin update you will not loose any content, but it will affect and overwrite any changes in the bt_cost_calculator.php code that you’ve made. The best way is to manually repeat modifications with new update.

Remove “Next“ button

In order to hide ‘Next’ button, deselect the ‘Display Next Button and Contact Form’ field in Cost Calculator Settings.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/05/cc-next-button.jpg
Contact Form visible by default

Since plugin version 2.1.9, it is possible to display contact form below total bar by selecting ‘Contact Form Initially Visible (Remove Next Button)’ field in Cost Calculator settings panel, Contact form tab.

http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/09/cc.jpg
How do I remove the bar with Total and leave contact form?

In order to remove Total bar and leave Next button please add the following css statements to the page:

.btQuoteTotal {
    display: none !important;
}
.btQuoteBooking .btQuoteBookingForm.btActive .btTotalNextWrapper {
    padding-right: 0px;
}
.btQuoteBooking .btContactNext {
    margin: auto;
}
.btQuoteBooking .btQuoteBookingForm .boldBtn {
    float: none;
    margin: auto !important;
}
Adding additional fields to contact form

If you like to add additional fields to contact form part of Cost Calculator, please do the following:

1. Open bt_cost_calculator.php file in the code editor.

2. Locate the following piece of code:

$output .= '<div class="btQuoteItem' . $m_message . ' btQuoteItemFullWidth"><textarea class="btContactMessage btContactField" placeholder="' . __( 'Message', 'bt_plugin' ) . '"></textarea></div>';

and add above it the following:

$output .= '<div class="btQuoteItem' . $m_phone . '"><input type="text" class="myText btContactField" placeholder="' . __( 'myText', 'bt_plugin' ) . '"></div>';

This will create the new field in the form with the placeholder text myText. Change it according to your needs (edit placeholder=”‘ . __( ‘myText’, ‘bt_plugin’ ) statement)

3. Locate the following piece of code in cc.main.js file:

'message' : c.find( '.btContactMessage' ).val()

and add above it the following:

'mytext' : c.find( '.myText' ).val(),

it will ensure that the value of the newly created field gets propagated to backend upon form submission

4. Locate the following piece of code in bt_cost_calculator.php file:

$message = $_POST['message'];

and add above it the following:

$mytext = $_POST['mytext'];

5. Locate the following piece of code in bt_cost_calculator.php file:

if ( $message != '' ) $message_to_admin .= '<div style="padding:.5em;"><b>' . __( 'Message', 'bt_plugin' ) . '</b>: ' . stripslashes( $message ) . '</div>' . "\r\n";

and add above it the following:

if ( $mytext != '' ) $message_to_admin .= '<div style="padding:.5em;"><b>' . __( 'MyText', 'bt_plugin' ) . '</b>: ' . $mytext . '</div>' . "\r\n";

It will include the value of your field into the email body.

How can I change total format’s display?

Since version 2.1.6. total format can be changed in Cost Calculator settings panel.

http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2019/08/total-format.jpg
How to redirect users to another page after submiting message?

In order to redirect users to another page after submitting the form, add the URL to ‘Optional URL for confirmation’ field.


http://documentation.bold-themes.com/cost-calculator/wp-content/uploads/sites/9/2018/05/cc-optional-redirect.jpg
How to redirect users to another page after the “Next“ button?

Please find the following lines in cc.main.js file:

c.find( '.btContactNext' ).click(function() {
                    $( 'html, body' ).delay( 1000 ).animate({
                        scrollTop: ( $( this ).closest( '.btQuoteBooking' ).find( '.btTotalQuoteContactGroup' ).offset().top - 30 )
                    }, 400 );
                    
                    var contact_group = $( this ).closest( '.btQuoteBooking' ).find( '.btTotalQuoteContactGroup' );
                    
                    $( this ).closest( '.btQuoteBooking' ).find( '.btTotalQuoteContactGroup' ).addClass( 'btActive' );
                    $( this ).closest( '.btQuoteBooking' ).find( '.btQuoteBookingForm' ).removeClass( 'btActive' );
                });

and change them with:

c.find( '.btContactNext' ).click(function() {
                    window.location = 'http://www.google.com';
                });

Please edit the url according to your needs.