Installation

Follow these steps to install SpecCart on your WooCommerce store.

Before You Begin

Make sure your server meets the system requirements and that WooCommerce is installed and active.

Installation Methods

Method 1: Upload ZIP File (Recommended)

This is the easiest method for store owners.

1. Download the plugin ZIP file from your purchase receipt or the vendor’s website.

2. Go to your WordPress Admin panel

   • Navigate to Plugins → Add New
   • Click the Upload Plugin button at the top of the page

3. Upload the ZIP file

   • Click Choose File and select the speccart.zip file
   • Click Install Now

4. Wait for installation

   • WordPress will upload and extract the plugin files automatically
   • This may take 10-30 seconds depending on your server speed

Installation Success

You should see “Plugin installed successfully” when the upload completes. If you see an error about file size limits, see the troubleshooting section below.

Method 2: Manual Upload via FTP/cPanel

If the ZIP upload method doesn’t work due to server restrictions, use this method.

1. Download and extract the plugin ZIP file on your computer

2. Connect to your server using FTP (FileZilla, Cyberduck) or your hosting cPanel File Manager

3. Navigate to the plugins directory

   /wp-content/plugins/

4. Upload the entire speccart folder to this directory

   • The final path should be /wp-content/plugins/speccart/

5. Set correct permissions (if needed)

   • Folders: 755
   • Files: 644

File Permissions

Most hosting providers set correct permissions automatically. Only adjust permissions if your hosting provider specifically instructs you to do so.

Activate the Plugin

After installation, activate SpecCart:

1. Go to Plugins → Installed Plugins in WordPress Admin

2. Find SpecCart in the list

3. Click the Activate link

4. Wait for activation to complete

Activation Requirements

If activation fails, you’ll see an error message explaining what’s missing (usually WooCommerce or PHP version). Fix the issue and try activating again.

Verify Installation

After activation, verify SpecCart is working correctly:

1. Check the Admin Menu

You should see a new SpecCart menu in your WordPress admin sidebar (below WooCommerce).

If you see this menu, the plugin is installed correctly.

2. Access the Settings Page

1. Go to SpecCart > Settings
2. You should see the SpecCart configuration interface with navigation tabs

First Time Setup

The Settings page loads the Vue.js admin interface. If the page appears blank, see the troubleshooting section below.

3. Check for Errors

Open your browser’s Developer Console:

• Chrome/Edge: Press F12 or Ctrl+Shift+I (Cmd+Option+I on Mac)
• Firefox: Press F12 or Ctrl+Shift+I (Cmd+Option+I on Mac)
• Safari: Enable Developer menu in Preferences, then press Cmd+Option+I

Look for any JavaScript errors (shown in red). There should be none.

Next Steps

Now that SpecCart is installed, you need to configure it before customers can use it:

1. Configure settings — Set up lens types, packages, colours, and more in Settings → General

2. Set up lens options — Configure lens usage types in Lens Usage and packages in Packages

3. Customize branding — Adjust logo, fonts, and colours in Branding

4. Test the wizard — Add a configured product to your cart to verify everything works

Quick Start Guide

For a faster setup, follow our Quick Start Guide which walks you through the essential configuration steps.

Troubleshooting

Upload Size Limit Error

If you see “The uploaded file exceeds the upload_max_filesize directive in php.ini”, your server’s upload limit is too low.

Solutions:

1. Use Method 2 (Manual Upload) - This bypasses the upload limit

2. Contact your hosting provider - Ask them to increase the upload_max_filesize limit to at least 20MB

3. Edit php.ini (if you have access):

   upload_max_filesize = 20M
   post_max_size = 20M

Plugin Activation Fails

If you see “SpecCart requires WooCommerce to be installed and active”:

1. Go to Plugins → Installed Plugins
2. Activate WooCommerce first
3. Then activate SpecCart

If you see “SpecCart requires PHP 8.1 or higher”:

1. Contact your hosting provider
2. Request an upgrade to PHP 8.1, 8.2, or 8.3
3. After the upgrade, try activating SpecCart again

Settings Page Appears Blank

If the SpecCart Settings page loads but appears blank (no configuration interface):

1. Clear your browser cache - Press Ctrl+F5 (Cmd+Shift+R on Mac) to hard refresh

2. Clear WordPress cache - If using a caching plugin (WP Rocket, W3 Total Cache, etc.), clear all caches

3. Check browser console - Open Developer Tools (F12) and look for JavaScript errors. If you see errors, contact support with the error details.

4. Disable other plugins temporarily - Another plugin may be causing a conflict. Deactivate all other plugins, test SpecCart, then reactivate one by one to identify the conflict.

Missing SpecCart Menu

If you don’t see the SpecCart menu under WooCommerce after activation:

1. Refresh the page - Press F5 or reload the page

2. Check plugin status - Go to Plugins → Installed Plugins and verify SpecCart shows as active

3. Check user permissions - Make sure you’re logged in as an Administrator

4. Clear WordPress caches - If using a caching plugin, clear all caches

Getting Help

If you encounter issues not covered here:

1. Check the FAQ for common questions
2. Review the Troubleshooting Guide
3. Contact support with:
   • WordPress version
   • WooCommerce version
   • PHP version
   • Description of the issue
   • Any error messages (screenshots help)