Testing

This guide covers how to test Frontier Quote functionality to ensure everything is working correctly.

Testing Tools

Frontier Quote provides built-in testing tools to help you preview how your storefront will look to customers from different countries.

Using the Country Simulation Tool

Step 1: Access Testing Page

  1. Open Frontier Quote app
  2. Navigate to Testing page

Step 2: Simulate Country

Testing Tool: Screenshot of country simulation interface
  1. Select a country from the dropdown
  2. Click "Simulate"
  3. A new tab will open with your storefront and the ?fq_country=XX parameter

Step 3: Test Quote Flow

  1. Add products to cart
  2. Go to cart page
  3. Verify "Get a Quote" button appears (if country is in blacklist)
  4. Click "Get a Quote"
  5. Fill out the form
  6. Submit and verify Draft Order is created

URL Parameter Testing

You can manually test by adding ?fq_country=XX to any storefront URL, where XX is the ISO country code.

Examples:

  • https://yourstore.com?fq_country=FR - Simulate France
  • https://yourstore.com/cart?fq_country=DE - Simulate Germany on cart page
  • https://yourstore.com/products/product-name?fq_country=JP - Simulate Japan on product page

Testing Checklist

Button Replacement

  • ✓ Quote button appears on Product Detail Pages
  • ✓ Quote button appears on cart page
  • ✓ Quote button appears in mini-cart
  • ✓ Quote button appears in sticky checkout bars
  • ✓ Checkout button appears for whitelist countries

Popup Form

Quote Form: Screenshot of popup form in action
  • ✓ Popup opens when clicking "Get a Quote"
  • ✓ All required fields are marked
  • ✓ Optional fields appear/disappear based on settings
  • ✓ Form validation works (email format, required fields)
  • ✓ Cart summary displays correctly in popup

Submission

  • ✓ Form submits successfully
  • ✓ Success message displays
  • ✓ Draft Order is created in Shopify admin
  • ✓ Draft Order has correct tags
  • ✓ Draft Order includes all form data in notes
  • ✓ Draft Order has correct customer information
  • ✓ Draft Order has correct shipping address

Notifications

  • ✓ Shopify Flow notification is triggered
  • ✓ Notification includes correct information

Testing Different Scenarios

Whitelist Country

  1. Add a country to whitelist in settings
  2. Simulate that country
  3. Verify checkout button appears (not quote button)

Blacklist Country

  1. Add a country to blacklist in settings
  2. Simulate that country
  3. Verify quote button appears (not checkout)

Empty Cart

  1. Clear cart
  2. Try to access quote form
  3. Verify appropriate error message

Browser Testing

Test in multiple browsers:

  • Chrome
  • Firefox
  • Safari
  • Edge

Mobile Testing

Test on mobile devices or using browser dev tools:

  • iPhone (Safari)
  • Android (Chrome)
  • Tablet devices

Clearing Cache

If testing doesn't reflect changes:

  1. Clear browser cache
  2. Clear localStorage (country detection cache lasts 24 hours)
  3. Hard refresh (Ctrl+Shift+R or Cmd+Shift+R)

Next Steps