# Page Breaker (Pro feature)

{% embed url="<https://youtu.be/CZrBrzr9xio>" %}

The **Page Breaker** element is a Pro feature of the Cost Calculator Builder plugin that allows you to create step-by-step (multistep) calculators. Instead of showing everything at once, this element helps break down the calculator into multiple pages, making it easier for users to navigate the steps.&#x20;

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FvYNkMkJSIDLPjdliX6LD%2Fimage.png?alt=media&#x26;token=aabda381-826e-4340-bc90-b5a3a099f2d0" alt=""><figcaption><p>The look of the multistep calculator</p></figcaption></figure>

## Page Breaker Element Settings

After adding the Page Breaker element to your calculator, at the top of the calculator you will get Page Breaker Element Settings:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FzCpW9mg48LCPrAbDjEZs%2Fimage.png?alt=media&#x26;token=dd3bcfa6-f525-44c7-89d1-f2dfcdad4af8" alt=""><figcaption></figcaption></figure>

### Element tab

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FGrPvQqmzIP6FaNwlwHIU%2Fimage.png?alt=media&#x26;token=a9eb3a80-13fe-499b-9204-f709210ba501" alt=""><figcaption></figcaption></figure>

* **Navigation Style** - select the style of the navigation
* **Hide page title in navigation** - enable the setting to hide the title of the pages in your step-by-step calculator

{% hint style="success" %}
You can see how it will look using the **Style Preview** section of the **Element** settings tab.
{% endhint %}

Here are the available **Navigation Styles:**

{% tabs %}
{% tab title="Circle steps with line" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FFnmAlB67ncgsvmjiDy5o%2Fimage.png?alt=media&#x26;token=fef3c7d8-1507-46c7-b1b3-aa7711bc8556" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Circle Tabs" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FwHDvvXMcehgKwAERUCVL%2Fimage.png?alt=media&#x26;token=612d910b-b4d9-4ce8-b9bb-0018f5492fa4" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Rectangle steps with line" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FHPeAgLvuFqCufOQ6omlk%2Fimage.png?alt=media&#x26;token=eae95e24-e2d2-4fd4-91f5-b22aad1291d9" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Rectangle tabs" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FENympTB4u3gtV53YBqxJ%2Fimage.png?alt=media&#x26;token=2fa9c36b-ade0-4f26-9da2-5f8d8c9f5548" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Progress with circle" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FcPtb4cBoJF0Ft8x8FiCK%2Fimage.png?alt=media&#x26;token=cc83074b-2f8c-485e-9345-d65692897d20" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Progress with bar" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FQpJaIvPGgICnBDjOqOEd%2Fimage.png?alt=media&#x26;token=8971e255-d134-43c1-9e8c-1a6a143b0e80" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Hidden" %}
{% hint style="info" %}
Page navigation will **be entirely hidden.**
{% endhint %}
{% endtab %}
{% endtabs %}

### Settings tab

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FcsBe7XsssUgE3Ysrv3bQ%2Fimage.png?alt=media&#x26;token=aead4f98-25cc-45a7-8779-f4b14153ee1b" alt=""><figcaption></figcaption></figure>

* **Show summary block on the last page of the multi-step calculator** - The setting will be applied only when a calculator is built with a Page breaker
* **Show total summary -** There will be a button on the bottom of each step for users to click and open a popup with Summary
* **Total field element** - choose the total field formula(s) to be displayed at the bottom of every page when the **Show Total Summary** option is <mark style="color:green;">**on**</mark>

{% tabs %}
{% tab title="Total Summary separated" %}
**Show summary block on the last page of the multi-step calculator** is <mark style="color:red;">**OFF**</mark>

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FaOm5BtdWT6qt0xELZHLA%2Fimage.png?alt=media&#x26;token=f3b881b4-86f0-4c18-8822-08b8c09da140" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Total Summary on last page" %}
**Show summary block on the last page of the multi-step calculator** is <mark style="color:green;">**ON**</mark>

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FKqzQB4kYAoVD8O2jgvyw%2Fimage.png?alt=media&#x26;token=e1190f75-faa4-46da-bb19-58dd6a6aa79c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FHv8DuPLr7LMYZEg9hsOI%2Fimage.png?alt=media&#x26;token=ab839b52-0825-471e-bcb7-b047bb0df47a" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Total Summary on every page" %}
**Show summary block on the last page of the multi-step calculator** and **Show total summary** settings are <mark style="color:green;">**ON**</mark>

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FlXyQuTDcBfvu6kDYczxT%2Fimage.png?alt=media&#x26;token=41526fa5-6377-4e2c-a470-2f55f903d006" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Ensure you have chosen totals to display on the Total Field Element setting.
{% endhint %}

If you click on the **Show Summary,** the Total Summary of your order will be opened in a pop-up:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FwgGTSQXshpRQ29bbpbLQ%2Fimage.png?alt=media&#x26;token=c6786c05-736e-4739-9e62-3fb9367d0637" alt=""><figcaption></figcaption></figure>

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2F9UzE3rpDCZMd8mxJbNyM%2Fimage.png?alt=media&#x26;token=b987d405-cc8b-4805-918e-686f30ba791f" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## Page Settings

Once you add a page breaker to your calculator, the calculator will be divided into two pages at the location where you placed the element. You can then add additional page breaker elements to create more pages.

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FjWit5D1d22TcT58l7b4N%2Fimage.png?alt=media&#x26;token=579e6028-e6d5-462e-9ae3-692bbb082c59" alt=""><figcaption></figcaption></figure>

***

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FUY7Zneyb8dB2Ybv3D1zO%2Fimage.png?alt=media&#x26;token=4fdd3a83-be27-4681-afe4-af86b31bc371" alt=""><figcaption></figcaption></figure>

* **Page Name -** enter a title for the page for easy identification
* **“Previous” Button Label -** customize the text for the button that users will click to go back to the previous page (e.g., "Back").
* **“Next” Button Label -** customize the text for the button that users will click to proceed to the next page (e.g., "Next").
* **Page Box Style -** choose the style for the page box. Available options include **Full Width**, which expands the page breaker to the full width of the form, and **2 Columns** which will split the page into two columns

{% tabs %}
{% tab title="Full Width" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FlgfQQ2YTaego9OqBE92x%2Fimage.png?alt=media&#x26;token=473b7abc-6473-4531-950d-3e167567ca86" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="2 Columns" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FrZev6vb6lLFUyjZ7qLTu%2Fimage.png?alt=media&#x26;token=9c0c9ba3-a1ef-49f9-a472-b998987ef46f" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Conditions

The Conditional Logic feature in the multi-step calculator allows you to create dynamic, responsive forms and calculators that adapt based on user inputs. This feature lets you define specific conditions under which the calculator will skip to a different page or jump to a particular step. By doing so, you can create a more streamlined and efficient user experience, ensuring that users only interact with the parts of the calculator that are relevant to them.

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2Ffax8XtTo24twudbQfj1q%2Fimage.png?alt=media&#x26;token=0b9cfb4b-dbf8-43ab-88f3-6c622514d901" alt=""><figcaption></figcaption></figure>

* Choose one of the **All** or **Any** options first.&#x20;
  * All - the action will be performed only if all conditions are true
  * Any - the action will be performed if one (any) of the conditions is true
* **Element** - choose the element which condition will be applied
* **Condition** - choose the condition option ([varies](https://docs.stylemixthemes.com/cost-calculator-builder/conditional-system/condition-options) by element)&#x20;
* **Value** - indicate the value of the condition
* **Add new** - use the button to add a new condition
* **Action** - select the action that will be executed once the condition is true
  * **Skip next page** - skips the next page in a sequence
  * **Do not skip next page** - button 'next' will be disabled, so the user can not skip the page
  * **Jump to** - directly jump to the selected page

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FW7FpxFOLsw3srwOopINK%2FStyleMix.gif?alt=media&#x26;token=032371eb-ae47-4409-9d2e-e683ec6349fd" alt=""><figcaption><p>Example usage of Condition</p></figcaption></figure>

{% hint style="success" %}
After configuring the settings, do not forget to click the **Save** button to apply the changes.
{% endhint %}

{% hint style="danger" %} <mark style="color:red;">**IMPORTANT**</mark>\
After **deleting** an element that had an Action configured in the Page, you must **re-save** the Page. Otherwise, the **Next** button **won't work** on the front end.
{% endhint %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FdV0H1Unq2AziXR6xWPC8%2Fimage.png?alt=media&#x26;token=0ed6d306-1dfd-4989-9e1d-f1767ad87d21" alt=""><figcaption><p>Opening the Page Settings</p></figcaption></figure>

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FKlM8BtzQ31kTQe1fV83t%2Fimage.png?alt=media&#x26;token=c4f8b1ac-1497-43f9-a8d7-5db5eeb225bf" alt=""><figcaption><p>Saving the Page Settings</p></figcaption></figure>

## Example Usage of Page Breaker

This element is particularly useful in scenarios like booking processes, where users need to fill out multiple stages of information, such as order details, personal details, and confirmation steps. By breaking these into separate pages, you can create a logical flow that guides users smoothly through each step. Now, let's see how to upgrade the Pizza Ordering calculator using these principles.

1. Use t**he drag & drop** feature to add the **Page Breaker** element to the place where you want to separate the elements:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FKEeCIeUyw74KqVUX3Mub%2Fimage.png?alt=media&#x26;token=dad4b2f3-dfd1-4eaf-a914-093642b730b5" alt=""><figcaption></figcaption></figure>

2. We will divide this calculator into three pages: **Pizzas, Drinks**, and **Delivery**. After the first step, we have two pages. Now, we will add another Page Break then move the **Delivery Location**, **Select the Branch Geolocation fields** and **Total** to it:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FcZVms3jb9vLWPaIYE8E0%2Fimage.png?alt=media&#x26;token=347cde35-6131-4eff-a361-0e156e6a1053" alt=""><figcaption></figcaption></figure>

3. We will customize the Page Breaker Settings:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FSBrYPoQkHy0Jbj17ZXY5%2Fimage.png?alt=media&#x26;token=fbd83b3b-611b-449d-bf1f-cbf5bd2d1e37" alt=""><figcaption></figcaption></figure>

4. Customize the navigation style according to your needs from the **Element tab**, then move to the **Settings tab** and enable both two settings *(so our total summary will be displayed at the end of the calculator as a separate page)*, indicate the total formula to show:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2F4mhdHjDk8WHNl3azrjeM%2Fimage.png?alt=media&#x26;token=32c53133-1a3d-4d80-9df0-21fcbf4327e5" alt=""><figcaption></figcaption></figure>

5. Change the page names accordingly one by one:

* Page #1 -> **Pizzas**
* Page #2 -> **Drinks**
* Page #3 -> **Delivery**

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2F1qhwH6dqJyt7mKCMBkhh%2Fimage.png?alt=media&#x26;token=c661ab95-3c3f-4729-b619-0debf49008f5" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
You can also modify the **Back and Next** button labels and **Page Box Style** according to your needs.
{% endhint %}

6. Let's add one checkbox field to the first - Pizza page, and add an option called 'I don't want drinks':

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FlBjAVIlwmi8OQl8Hdv10%2Fimage.png?alt=media&#x26;token=85234897-abfe-495d-bec3-a5ae3d0bca46" alt=""><figcaption></figcaption></figure>

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2F3knh0AU7NGozyteHNgDY%2Fimage.png?alt=media&#x26;token=7e87087c-5e71-453a-bedf-b4cece7d1dbd" alt=""><figcaption></figcaption></figure>

7. In the **Pizzas** page settings, add a condition. Set these parameters accordingly:

* **Element**: "I don't want drinks"
* **Condition**: 'Is selected (option)'
* **Value**: 'I don't want drinks'
* **Action**: 'Jump to' (alternatively you can also select 'Skip next page')
* **Page**: 'Delivery'

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FgB2eOWxtT99tcc1o2M7M%2Fimage.png?alt=media&#x26;token=515a6799-60f1-4e8b-a861-8d28bba523f3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
With these settings, once the user **checks** the "I don't want drinks" option, the calculator automatically moves to the delivery page (or skips the next - Drinks page).
{% endhint %}

Here is the result:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FJ2oQmvihtVPlCR8DcQEK%2Fimage.png?alt=media&#x26;token=f25d723e-bdeb-4247-8d7f-5ec715c5ff49" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Later you can upgrade this calculator using the[ **Repeater field**](https://docs.stylemixthemes.com/cost-calculator-builder/calculator-elements/repeater-pro-feature) according to your needs.&#x20;
{% endhint %}

Good job, you have done it successfully!
