Compatibility

This page outlines SpecCart’s compatibility with WordPress, WooCommerce, themes, browsers, and other plugins.

System Requirements

WordPress

Version	Status
6.4+	Fully supported
6.0 - 6.3	Supported (minimum: 6.0)
Below 6.0	Not supported

Keep WordPress Updated

For security and performance, always run the latest stable version of WordPress. SpecCart is tested against each new WordPress release.

WooCommerce

Version	Status
8.0+	Fully supported and recommended
7.0 - 7.9	Supported (minimum: 7.0)
Below 7.0	Not supported

WooCommerce Features:

• High-Performance Order Storage (HPOS) - Fully supported
• Custom Order Tables - Fully supported
• Product types - Simple and Variable products supported

WooCommerce Required

SpecCart requires WooCommerce to be installed and active. The plugin will not activate without WooCommerce.

PHP

Version	Status
8.3	Recommended
8.2	Fully supported
8.1	Minimum supported version
8.0 and below	Not supported

Required PHP Extensions:

• json - For configuration and API data
• mbstring - For multi-byte strings
• gd or imagick - For image processing
• fileinfo - For file upload validation

PHP 8.1 Minimum

SpecCart requires PHP 8.1 or higher. If your hosting provider runs an older PHP version, contact them to upgrade. Most modern hosts support PHP 8.1+.

Server Resources

Minimum:

• PHP Memory Limit: 128MB
• Max Upload Size: 5MB
• Max Execution Time: 30 seconds

Recommended:

• PHP Memory Limit: 256MB
• Max Upload Size: 20MB
• Max Execution Time: 60 seconds

Browser Compatibility

Customer-Facing Configurator

The lens configurator works in all modern browsers:

Browser	Minimum Version	Notes
Chrome	90+	Recommended
Edge	90+	Chromium-based only
Firefox	88+	Fully supported
Safari	14+	Desktop and iOS
Safari Mobile	iOS 14+	Fully supported
Chrome Mobile	Android 10+	Fully supported
Internet Explorer	Not supported	IE is not supported

Mobile First Design

The configurator is built mobile-first and fully responsive. It works seamlessly on smartphones and tablets.

Admin Interface

The SpecCart admin panel requires:

Browser	Minimum Version
Chrome	90+
Edge	90+
Firefox	88+
Safari	14+

Admin features use modern JavaScript and may not work correctly in older browsers.

Theme Compatibility

General Compatibility

SpecCart is designed to work with any well-coded WooCommerce theme. The plugin:

• Integrates with standard WooCommerce templates
• Uses WooCommerce hooks for product pages
• Provides override-able template files
• Uses scoped CSS to avoid conflicts

Known Compatible Themes

SpecCart works well with popular WooCommerce themes including:

• Storefront - WooCommerce’s official theme
• Astra - Popular multipurpose theme
• GeneratePress - Lightweight and fast
• OceanWP - Feature-rich WooCommerce theme
• Kadence - Modern block-based theme
• Flatsome - Popular WooCommerce theme
• Twenty Twenty-Four - WordPress default theme

Theme Considerations

Themes that heavily modify WooCommerce templates may need minor adjustments:

• Custom product page layouts
• Modified cart/checkout templates
• JavaScript that modifies product data

What to check:

1. Test the configurator on a product page
2. Add a configured product to cart and verify lens data appears
3. Complete checkout and verify the order includes lens configuration

Testing with Default Theme

If you experience display issues, temporarily switch to a default WordPress theme (like Twenty Twenty-Four). If the configurator works there, the issue is theme-specific.

Page Builders

SpecCart works with popular page builders when used for product pages:

• Elementor - Use WooCommerce widgets
• Bricks Builder - Use WooCommerce elements
• Beaver Builder - Use WooCommerce modules
• Divi - Use WooCommerce modules

Important: The configurator requires the WooCommerce product data to be available. If you build completely custom product layouts, ensure product hooks are preserved.

Plugin Compatibility

Known Compatible Plugins

SpecCart is tested with and compatible with:

WooCommerce Extensions:

• WooCommerce Subscriptions
• WooCommerce Bookings
• WooCommerce Product Add-Ons (with considerations)
• WooCommerce PDF Invoices & Packing Slips

Performance & Caching:

• WP Rocket
• W3 Total Cache
• WP Super Cache
• Autoptimize
• Cloudflare (CDN)

Email & SMTP:

• WP Mail SMTP
• Post SMTP
• SendGrid
• Mailgun

Security:

• Wordfence Security
• Sucuri Security
• iThemes Security

SEO:

• Yoast SEO
• Rank Math
• All in One SEO

Known Conflicts

Some plugins may conflict with SpecCart:

Dynamic Pricing Plugins:

• Plugins that dynamically modify product prices may conflict with SpecCart’s pricing calculations
• Test thoroughly and verify cart totals are correct
• Contact your developer if you need both

Custom Product Options Plugins:

• Plugins that add custom fields to products may interfere with SpecCart
• Examples: WooCommerce Product Add-Ons (if configured on the same product), custom product configurators
• Avoid using multiple product customization plugins on the same product

Heavy JavaScript Plugins:

• Plugins that inject JavaScript on every page may slow the configurator
• Examples: Live chat widgets, heavy analytics scripts
• Test performance after installing new plugins

Plugin Conflicts

If you suspect a plugin conflict, temporarily deactivate other plugins one-by-one to identify the source. See the Troubleshooting Guide for detailed steps.

Plugins That Require Testing

Always test SpecCart after installing these types of plugins:

• Currency switchers - May affect pricing calculations
• Translation plugins - Verify configurator text is translatable
• Custom checkout plugins - May modify order meta storage
• Inventory management - May conflict with order workflows

WooCommerce Features

High-Performance Order Storage (HPOS)

Fully supported. SpecCart declares HPOS compatibility and stores all order data correctly in custom order tables.

Variable Products

Supported. SpecCart works with variable products (products with size, color, etc. variations). Lens customization is independent of product variations.

Simple Products

Fully supported. SpecCart works best with simple products representing frames.

Other Product Types

• Grouped products - Not supported
• External/Affiliate products - Not supported
• Virtual products - Supported if also marked as Simple or Variable
• Downloadable products - Supported if also marked as Simple or Variable

Product Type Requirements

The SpecCart configurator appears only on Simple and Variable products. Grouped and External products are not supported.

Hosting Compatibility

SpecCart works on all standard WordPress hosting platforms:

Shared Hosting:

• Bluehost, SiteGround, HostGator, DreamHost, etc.
• Ensure you meet the system requirements

Managed WordPress Hosting:

• WP Engine
• Kinsta
• Flywheel
• Cloudways
• Pressable

VPS/Cloud Hosting:

• DigitalOcean
• AWS (with WordPress)
• Google Cloud
• Linode

Local Development:

• DDEV (recommended)
• Local by Flywheel
• XAMPP
• MAMP
• Docker

Managed WordPress Hosting Recommended

For best performance, use managed WordPress hosting with optimized caching, CDN, and server resources. This provides the best customer experience.

Multilingual & Multi-Currency

Translation Support

SpecCart is translation-ready and compatible with:

• WPML - Fully supported
• Polylang - Compatible
• TranslatePress - Compatible
• Loco Translate - For interface translation

All customer-facing text uses WordPress translation functions and can be translated.

Multi-Currency

SpecCart pricing works with multi-currency plugins:

• WooCommerce Multi-Currency - Compatible (test pricing calculations)
• WPML Multi-Currency - Compatible
• Aelia Currency Switcher - Compatible (test thoroughly)

Test Pricing

When using multi-currency plugins, always test that lens upgrade prices are converted correctly in cart and checkout. Some currency switchers only convert base product prices.

Accessibility

SpecCart follows WCAG 2.1 Level AA guidelines:

• Keyboard navigation - Full configurator navigation without mouse
• Screen reader support - All elements properly labeled
• Focus indicators - Clear visual focus states
• Color contrast - Meets AA standards (customizable via Branding settings)

Compatible with:

• NVDA (Windows)
• JAWS (Windows)
• VoiceOver (macOS, iOS)
• TalkBack (Android)

Testing Before Going Live

Before launching SpecCart on a live store:

1. Test complete purchase flow:

   • Configure lenses on a product
   • Add to cart and verify cart shows lens configuration
   • Complete checkout
   • Verify order shows complete lens and prescription data

2. Test all prescription methods:

   • Manual entry
   • File upload
   • Send later (verify email arrives)

3. Test email delivery:

   • Place test orders
   • Verify all emails arrive (order confirmation, prescription requests, reminders)

4. Test on multiple devices:

   • Desktop browsers
   • Mobile browsers (iOS Safari, Chrome Android)
   • Tablet browsers

5. Verify theme compatibility:

   • Check configurator appearance matches your site design
   • Verify cart/checkout display correctly
   • Test responsive design on small screens

Getting Help with Compatibility

If you experience compatibility issues:

1. Check the Troubleshooting Guide
2. Test with plugins disabled to isolate conflicts
3. Test with a default theme to rule out theme issues
4. Contact your developer with specific details about the conflict
5. Check WordPress Site Health for configuration issues

Related Resources

• Requirements - Minimum system requirements
• FAQ - Common questions answered
• Troubleshooting - Solutions to common issues