CalcBuilder Tutorial

A calculator has to be attached to a menu item or a module to appear on the site. A menu item is required for a stand-alone page — opening the raw component URL without one causes a routing error.

Menu item

1. Menus → [your menu] → Add New Menu Item, set the Title.
2. Select the Menu Item Type → Calc Builder → Calc Builder.



3. Open the Options tab and choose your calculator in the Calculator field. (This step is essential — without it the page errors.)



4. Optionally pick a result animation.
5. Save & Close.

Module

1. Content → Site Modules → New → CalcBuilder.



2. Give it a Title, choose a template Position.
3. In Calculator list pick the calculator to show.



4. Set Menu Assignment and Save & Close.

In the demo the Tip Calculator is published both as its own page and as a sidebar-right module on the home page.

Module inside an article

A module does not have to sit in a template position — you can drop it into the body of any article (or custom HTML module) with a load-module tag. This is handy for a landing page that is mostly text with one calculator in the middle.

1. Create the CalcBuilder module as above, pick the calculator, set Status to Published and leave Position empty. Note its numeric ID (shown in the module list).
2. Make sure the Content – Load Modules plugin is enabled (System → Plugins).
3. Edit the article and type {loadmoduleid N} where the calculator should appear (N = the module ID). Use the Toggle editor / code view so the braces are not escaped.
4. Save. The plugin swaps the tag for the module output when the page is viewed.

Prefer {loadmoduleid N} (by ID) over {loadposition xyz} for a one-off — it targets exactly that module and keeps working if you rename it.