Skip to main content
How-to

Migrating off the Mr Teas theme

Overview​

The Mr Teas StoreFront theme is being retired. If your StoreFront runs Mr Teas, UltraCart has turned off Payment Form Script Monitor on your account until you switch to a currently supported theme, and you need to migrate to keep your checkout pages monitored.

You do not need a developer for this. Every theme in the current Theme Gallery is Visual Builder enabled, so you build your pages with a drag-and-drop editor instead of editing template code.

Why Payment Form Script Monitor was turned off​

Payment Form Script Monitor (PFSM), found under Main Menu → Storefronts → (select your StoreFront) → Advanced, automatically detects your checkout pages and monitors the scripts on them for PCI compliance validation.

Mr Teas is built on jQuery 1.x, which uses eval() to run script text while the page loads. Current security requirements do not allow eval() on a page that handles payment, and PFSM cannot reliably validate a page that depends on it. UltraCart therefore turned PFSM off on every account running a theme published before January 1, 2023. Mr Teas is one of those themes.

warning

While you remain on Mr Teas, PFSM stays off and your checkout pages are not automatically monitored for PCI script compliance. If you are not sure whether this affects your checkout, contact UltraCart Support with your account ID.

Before you start​

  • Your live site is not affected while you work. Installing a new theme and previewing it does not change what your customers see. Only activating the theme does that.
  • Set aside extra time if you customized Mr Teas heavily. Custom templates, injected scripts, and non-standard page layouts have to be rebuilt in the new theme. Contact UltraCart Support if you want help scoping that work first.
  • Know where your content lives. Make a list of the custom blocks you want to keep, such as trust logos, testimonials, and footer content, so nothing gets missed when you rebuild.

Migrate to a supported theme​

  1. Log in to your UltraCart account.
  2. Navigate to Main Menu → Storefronts → (select your StoreFront) → Appearance → Themes.
  3. Click the Theme Gallery tab.
  4. Pick the theme whose look is closest to your current site and click Add Theme, then confirm the install. Elements, Hero, Poppy, Natural VB, Native, Jewel, and Lifty are all current, Visual Builder enabled options.
  5. Click Preview to see the new theme. Your customers still see your existing site at this point.
  6. Rebuild your key pages in the Visual Builder: home, product, and any checkout customizations. Re-add the custom content blocks you listed earlier.
  7. When the preview looks right, activate the new theme to make it live. See Select a different theme for the activation steps.

If you would rather work from a copy of your current site than a blank theme, duplicate your StoreFront first and experiment on the copy.

Verify your StoreFront after migration​

Before you call the migration done:

  • Place a test order through checkout on the new theme and confirm it completes normally.
  • Confirm your tracking still fires, such as Google Analytics and Facebook Pixel. Tracking is configured per StoreFront under Privacy & Tracking rather than per theme, so it carries over, but check anything you rebuilt as a custom script injection.
  • View your site on a phone. Visual Builder themes are responsive by default, but custom content blocks are worth checking individually.
  • Contact UltraCart Support to have PFSM turned back on now that the legacy theme is gone.

Troubleshooting​

Symptoms: You want to replace Mr Teas but cannot tell which Theme Gallery entries are safe choices.

Solution: Pick any theme in the gallery based on look and feel. Every theme currently in the gallery is Visual Builder enabled and free of the jQuery eval() problem that affects Mr Teas, so there is nothing extra to verify. Contact UltraCart Support if you want help matching a theme to your current layout.

Custom Mr Teas content or scripts have no obvious equivalent​

Symptoms: Custom page layouts, injected scripts, or non-standard templates from Mr Teas do not map onto anything in the Visual Builder.

Root Cause: Visual Builder themes use drag-and-drop elements, a different content model from the template-based system Mr Teas uses.

Solution: Contact UltraCart Support with the specific pages and customizations involved so the work can be scoped, and escalated to engineering if that is needed.

Checkout looks or behaves differently after the switch​

Symptoms: The checkout flow, its fields, or its styling changed after you activated the new theme.

Root Cause: Checkout templates belong to the theme, so changing themes changes how checkout is presented. The underlying checkout logic is the same.

Solution: Adjust the checkout customization in the new theme's Visual Builder. Contact UltraCart Support if checkout is not completing.

Was this page helpful?