Skip to content
SpecCart Docs

Quick Start

This guide walks you through installing SpecCart, configuring your first lens options, and testing the customer-facing wizard.

1. Install the Plugin

Section titled “1. Install the Plugin”

Option A: Upload ZIP (recommended)

  1. Download the SpecCart .zip file
  2. In your WordPress admin, go to Plugins > Add New
  3. Click Upload Plugin, choose the ZIP file, and click Install Now

Option B: Manual upload

  1. Extract the ZIP file
  2. Upload the speccart folder to wp-content/plugins/

After uploading, install the PHP dependencies if they aren’t already bundled:

Terminal window
cd wp-content/plugins/speccart
composer install --no-dev --optimize-autoloader

2. Activate and Verify

Section titled “2. Activate and Verify”
  1. Go to Plugins in your WordPress admin
  2. Find SpecCart in the list and click Activate

SpecCart requires WooCommerce 7.0+ and PHP 8.1+. If either is missing, the plugin will display a notice and won’t activate.

Once activated, confirm the SpecCart menu appears in your WordPress admin sidebar with these items:

  • Overview — dashboard with statistics and prescription management
  • Settings — global configuration interface

3. Configure Your Settings

Section titled “3. Configure Your Settings”

Navigate to SpecCart > Settings to open the main configuration interface.

General Settings

Section titled “General Settings”

On the General tab, review these key options:

  • Enable Configurator — global on/off switch for the lens wizard
  • Currency Symbol — currency display format (inherits from WooCommerce by default)
  • Tax Handling — how lens prices are taxed
  • Require Prescription — whether customers must provide a prescription
  • Show Prescription Upload — let customers upload prescription images
  • Show Send Later — allow customers to send their prescription after purchase

Click Save Settings when you’re done. Changes take effect immediately.

4. Set Up Lens Types

Section titled “4. Set Up Lens Types”

Go to the Lens Usage tab within Settings. This tab controls lens type options (single vision, bifocal, progressive).

SpecCart creates default lens types on activation:

  • Single Vision ($0) — base option
  • Bifocal ($50)
  • Progressive ($150)

To customize:

  1. Click Edit on any existing lens type or Add Lens Type
  2. Fill in the fields:
    • Name — display name (e.g., “Single Vision”)
    • Description — help text shown to customers
    • Price — additional cost for this lens type
    • Enabled — toggle on to show in wizard
    • Priority — sort order (lower numbers appear first)
  3. Click Save

A typical setup:

Lens TypePrice
Single Vision$0 (base option)
Bifocal$50–80
Progressive Standard$100–150
Progressive Premium$200–300

5. Configure Packages, Colors, and Add-ons

Section titled “5. Configure Packages, Colors, and Add-ons”

While still in Settings, configure the remaining tabs to match your offerings.

SpecCart creates sensible defaults for all options on activation. You can customize them to match your pricing:

Packages tab — bundle coatings and materials into preset packages (e.g., “Basic”, “Premium”, “Ultimate”)

Colours tab — manage tints and color options (e.g., No Tint at $0, Dark Gray at $35–50, Polarized at $60–100)

Add-ons tab — optional extras like cleaning kits, cases, warranties

Each option has the same fields: name, description, price, enabled, and priority. Use the Recommended or Popular flags to guide customers toward your best-value options.

6. Enable the Configurator on a Product

Section titled “6. Enable the Configurator on a Product”
  1. Go to Products and edit any WooCommerce product (or create a new one)
  2. Click the SpecCart tab in the Product Data panel
  3. Under Lens Configurator, select Enable for this product
  4. Click Update (or Publish for new products)

7. Test the Wizard

Section titled “7. Test the Wizard”

Visit the product page on your storefront. You should see the SpecCart lens configurator button. Click it to walk through the wizard:

  1. Lens Usage — select a lens type (single vision, bifocal, progressive)
  2. Varifocal — if progressive was selected, choose progressive options (conditional step)
  3. Colours — choose tint or color options
  4. Packages — select a preset package or customize individually
  5. Summary — review the configuration, add optional add-ons, and enter prescription

The prescription can be entered manually, uploaded as an image, or sent later via email link.

Click Add to Cart and verify:

  • The cart shows the lens configuration details
  • The total price includes all selected options
  • Completing checkout saves the configuration to the order

Check the order in SpecCart > Overview or WooCommerce > Orders to confirm the lens data and prescription status appear correctly. Orders with lens configurations show special indicators for prescription status (verified, pending, received).

Next Steps

Section titled “Next Steps”