YourPlugins

Use theme options and legacy themes

Part of Style and frontend.

All docs

Version 3.x uses a modern built-in theme system. For most websites, you should customize the calculator with theme options instead of creating custom PHP theme files.

The recommended workflow is:

  1. open the calculator
  2. go to Preview
  3. choose the theme and adjust the presentation options
  4. test the result before saving

Theme options currently cover the most common styling needs, including:

  • accent color
  • font family
  • font size
  • border radius
  • border color
  • field layout
  • empty price message
Preview matters: in version 3.x, Preview is the fastest way to validate both styling and behavior before testing the real product page. You can also simulate a specific associated product when needed.

About legacy PHP themes

Older versions used PHP theme files, sometimes based on Bootstrap, UIkit, or custom markup. That is no longer the primary rendering model in 3.x.

If you import an old calculator ZIP that referenced a legacy PHP theme, version 3.x maps that theme to the default modern theme instead of restoring the PHP template.

For new projects, the recommended order is:

  1. theme options
  2. scoped custom CSS
  3. developer-level customization with hooks or custom integration code

If you still maintain a legacy PHP theme for historical reasons, keep it under version control and test it carefully after every major plugin update. For legacy-only reference, see Legacy field markup customization.