Warranty Cart

FAQ

How do I set up my first warranty product?

1. Open Products → Add New (regular WooCommerce product).
2. Title, description, and price in EUR. Tick Virtual so the order auto-completes.
3. Click the Warranty tab in the Product data box.
4. Set Status: Enabled, Type: Main warranty, Duration: 1, Duration unit: years, and fill in Coverage details.
5. Publish.
6. Create one or more Additional service products the same way, but set Type: Additional service and pick the main warranty under Associated warranty.
7. Drop [warranty_cart] onto any page. Done.

How do I display warranty products?

Use the [warranty_cart] shortcode on any page or post. The shortcode accepts one attribute, layout:

[warranty_cart layout="grid"] or `[warranty_cart layout="list"]`

To scope which products show (category, custom meta, etc.) use the warranty_cart_shortcode_products_query filter. See the shortcode reference.

What payment methods are supported?

The plugin integrates with external WooCommerce payment plugins:
– WooCommerce PayPal Payments (v2.0.0+)
– WooCommerce Gateway Stripe (v7.0.0+)

The plugin does not handle payment processing directly – it only tracks warranty purchases made through these external plugins.

How do I configure payment gateways?

1. Install and activate at least one supported payment plugin
2. Go to WooCommerce > Settings > Payments
3. Configure the payment plugin(s) with your API credentials
4. The warranty plugin will automatically detect and integrate with active payment plugins

Why does the plugin require external payment plugins?

This approach provides several benefits:
– Uses official, well-maintained payment plugins
– Leverages existing payment infrastructure
– Reduces security risks by not handling payment data
– Allows stores to use their preferred payment setup
– Easier maintenance and updates

Can I add more payment methods?

Yes! The plugin uses an integration architecture. Support for additional payment plugins can be added by creating new integration classes that extend the AbstractIntegration class.

How do I access the admin dashboard?

After installation, click the top-level Warranty Cart menu in your WordPress admin sidebar (shield icon). This provides access to all warranty management features: dashboard, warranty product catalog, warranty records, orders, reports, settings, and tools. See the admin dashboard reference for a full tour.

What are the different admin sections for?

• Dashboard: Overview with sales metrics, recent orders, and popular warranties
• Warranties: Create and manage warranty products and bundles
• Orders: View and manage warranty orders with customer details
• Reports: Analytics with charts showing sales performance and trends
• Settings: Configure email templates, checkout fields, and plugin options
• Tools: Import/export data, system diagnostics, and maintenance tools

How do warranty certificates work?

The plugin automatically generates PDF certificates for purchased warranties using DomPDF. They are attached to the order completion email and can be re-downloaded from Warranty Cart → Orders. PDFs are stored under wp-content/uploads/warranties/. Toggle the feature on or off under Warranty Cart → Settings → Enable PDF certificates.

When are warranty records created?

When a WooCommerce order containing one or more warranty products reaches the Completed status. The plugin listens for completion events from WooCommerce, the WooCommerce PayPal Payments plugin, and the WooCommerce Gateway Stripe plugin. Each warranty product in the order produces a row in wp_warranty_cart_warranties with status active and an expiration_date calculated from the duration.

How are the reminder and expiration emails scheduled?

Two daily WP-Cron events handle the lifecycle:

• warranty_cart_check_expirations — marks active warranties as expired on or after their expiration_date and sends the Warranty Expired email.
• warranty_cart_send_reminders — emails customers N days before expiration (default 30, filterable via the warranty_cart_reminder_days filter).

If your host disables WP-Cron, set up a real system cron job (every 5–15 minutes hitting wp-cron.php) and add define('DISABLE_WP_CRON', true); to wp-config.php.

How do I import warranty products in bulk?

Go to Warranty Cart → Tools, download the sample CSV, fill it in, and upload via the Import CSV card. Each row creates a WooCommerce product with the Warranty tab pre-filled.

I activated the plugin but emails or PDFs aren’t sending — what now?

Common fixes:

• Make sure Warranty Cart → Settings → Enable email notifications and Enable PDF certificates are on.
• wp_mail() is unreliable on default WordPress installs. Install an SMTP plugin (WP Mail SMTP, FluentSMTP) and connect a real transactional provider.
• DomPDF needs the PHP gd or imagick extension and ~128 MB memory.
• Ensure wp-content/uploads/warranties/ exists and is writable by your web server user.

The full troubleshooting guide is at https://thewpsquad.com/docs/warranty-cart/troubleshooting/troubleshooting.md.

Is the plugin secure?

Yes, security is a top priority:
– All inputs are sanitized and validated
– AJAX requests use WordPress nonces
– Integrates with secure, official payment plugins
– Sensitive data is never logged or stored
– No direct payment processing reduces security surface
– File uploads are validated and restricted to safe types