# WordPress Plugin

URL: https://smartcut.dev/docs/wordpress-plugin

> SmartCut WordPress WooCommerce plugin documentation

The SmartCut WordPress plugin integrates cutting optimization directly into your WooCommerce store, enabling cut-to-size e-commerce functionality.

## Essentials

Before getting started, ensure these foundational requirements are met:

1. **Add your domain** to your SmartCut account (24-hour activation period, or contact support for expedited activation)
2. **Install WooCommerce plugin** on your WordPress site
3. **Use the Storefront theme** (the official WooCommerce theme)
4. **Minimize plugin installations** - keep additional plugins to a minimum
5. **Avoid page builder tools** until compatibility is thoroughly verified
6. **Skip caching plugins** that may alter JavaScript loading order
7. **Enable automatic plugin updates** to stay current with the latest features

:::caution[Important]
Most issues encountered are related to the points above. Following these guidelines will ensure smooth operation.
:::

## Installation

1. Download the latest `smartcut.zip` from [Github](https://github.com/jgmedialtd/smartcut-wp-plugin/releases/latest/)
2. In WordPress admin, navigate to **Plugins** > **Add New** > **Upload Plugin**
3. Upload the `smartcut.zip` file
4. Activate the plugin

### Local Server Testing

For local development, use `localhost` as the hostname rather than custom domains or IP addresses to enable proper domain validation.

## Product Category Setup

Create a dedicated product category to identify cut-to-size items:

1. Create a new product category in WooCommerce
2. Navigate to **SmartCut** > **General settings**
3. Configure the category for cut-to-size products
4. Apply this category to all relevant products

:::tip
Complete this step before other configuration tasks to streamline your setup.
:::

## Product Templates

The SmartCut admin menu offers template generation featuring example products:

1. Navigate to **SmartCut** > **Templates**
2. Select a template that matches your business structure
3. Customize the template to your needs
4. Ensure the category slug aligns with your saved settings

## Global and Product Settings

Settings operate in a hierarchy: **Product settings override Global settings**.

Implement global settings strategically to reduce administrative overhead when updates are needed across your store.

## Pricing Strategies

SmartCut supports multiple pricing approaches:

- **Full sheet pricing** - Price based on complete sheets
- **Part area-based pricing** - Calculate price by part area
- **Cut length pricing** - Price based on linear cutting
- **Full sheet plus cut length** - Combined pricing model
- **Full sheet plus number of parts** - Price by sheet and part count
- **Additional surcharge options** - Custom pricing adjustments

## Product Structure

### Attribute Configuration

WooCommerce product attributes manage variable options. Follow these guidelines:

#### Simple Products with Fixed Stock

- Use **length** and **width** attributes (millimeters or inches)
- Optional **thickness** attribute (required for beam saws)

#### Variable Products with Multiple Thicknesses

- Use **thickness** attribute separated by pipes: `8 | 12 | 16`
- Omit units

#### Variable Products with Multiple Sizes

- Use **size** format: `2440×1220`
- Multiple options: `2440×1220 | 1000×1000`
- Do not combine with length/width attributes

#### Variable Products with Full-Size Purchase Option

- Add "Cut-to-size" as a text option
- Example: `2440×1220 | 1000×1000 | Cut-to-size`

:::danger[Critical]
Do not add units to dimensions or sizes. The plugin will handle unit conversion based on your store settings.
:::

## Edge Banding and Finishes

These "extras" are managed via standard WooCommerce products linked to cut-to-size offerings. They can be hidden from customers by setting them as **Private**.

### Naming Constraints

:::caution
Extras names must only contain numbers, letters, underscores, hyphens & brackets. No other special characters are allowed.
:::

### Pricing Specifications

- **Banding**: Priced by meter or foot
- **Finishes**: Priced by square meter or square foot

### Simple Extra Products

Use simple products when presenting a single list of choices. Each option requires its own product with controlled pricing. Product slugs identify extras in orders, PDFs, and CSV files.

### Variable Extra Products

Introduced in version 3.1, variable extras allow breaking up choices (e.g., separate color and thickness selection):

1. Add attributes to the extra product
2. Generate variations
3. Set prices accordingly

:::caution[Restriction]
When using variable extra products, add only one product slug at a time to avoid errors.
:::

## CSV Import for Parts

When **Settings** > **Cut list configuration** > **Enable CSV import** is enabled, users can import parts via CSV.

1. Download the example template from the support documentation
2. Ensure the template is available on your site

:::danger[Critical Requirement]
Units used in the import must match your store-wide units set in **Settings** > **Cut list configuration**
:::

CSV columns include:
- Length
- Width
- Quantity
- Rotation
- Name

All columns are optional and can be removed as needed.

## Translation

Translation occurs in two stages:

### 1. Cut List Widget
Manual translation via provided Google Doc

### 2. Store Text
Use WooCommerce-compatible translation plugins:
- **Loco Translate** (officially supported)
- Other compatible WooCommerce translation plugins

## Troubleshooting

### Cut List Interface Not Displaying

Verify the following checklist:

- ✅ SmartCut plugin installed and activated
- ✅ Domain added to SmartCut account with proper www designation
- ✅ Cut-to-size category created and applied to products
- ✅ Product pricing configured (simple products or variations)
- ✅ Product stock status set appropriately
- ✅ Storefront theme in use
- ✅ Minimal plugin interference
- ✅ Caching properly configured
- ✅ Browser cache cleared

### Server Connection Issues

**For local servers:** Use `localhost` as the hostname.

**For live URLs:**
- Confirm domain registration in your SmartCut account
- Allow 24 hours for activation
- Contact support for expedited processing if needed

Common error message: *"We are having trouble connecting to the server"*

This typically indicates:
- Localhost configuration issues, or
- Incomplete domain setup

### Version Downgrade

If you need to revert to a previous version:

1. Access your SmartCut account dashboard
2. Navigate to the plugin downloads section
3. Select and download the desired version of `smartcut.zip`
4. Upload via WordPress **Plugins** menu

## Support

The platform is designed for self-service setup using provided templates as references.

For assistance:
- **Email**: hello@cutrevolution.com
- **API Updates**: [API Changelog](/docs/updates)
- **Custom Development**: Available at standard hourly rates

---

**Current Plugin Version:** 4.3.9
**Platform:** Built for WooCommerce