[email protected]
 0,00 0

Cart

No products in the cart.

SWB Documentation

Welcome to the complete documentation for SWB - Sell Window Blinds, the ultimate WooCommerce plugin for selling made-to-measure window blinds online.

What is SWB?

SWB transforms your WooCommerce store into a professional blinds retail operation. It handles dimension-based pricing, product configuration, supplier integration, production management, and business analytics - everything you need to sell made-to-measure blinds online.

SWB provides a comprehensive suite of features organized into three plans:

Standard Plan

  • Price Grids
  • Option Price Grids
  • Bulk Assignment
  • Product Configurator
  • Stock Items
  • Child Safety Rules
  • UI Designer

Pro Plan

  • Everything in Standard
  • Product Formulas
  • Order Export
  • Export Logs
  • Supplier Status Sync

Enterprise Plan

  • Everything in Pro
  • Remake Orders
  • Analytics Dashboard
  • Work Sheet
  • Label Designer
  • Fabric Optimizer

Requirements

Before installing SWB, ensure your server meets these requirements:

Requirement Minimum Version Recommended
WordPress 5.8 6.0+
WooCommerce 5.0 8.0+
PHP 7.4 8.1+
MySQL 5.7 8.0+
Memory Limit 128MB 256MB+

WooCommerce HPOS

SWB is fully compatible with WooCommerce High-Performance Order Storage (HPOS). No additional configuration is required.

Installation

Follow these steps to install SWB on your WordPress site:

Step 1: Download the Plugin

After purchasing, download the plugin ZIP file from your account at SellWindowBlinds.Online.

Step 2: Upload to WordPress

1

Go to Plugins

In your WordPress admin, navigate to Plugins → Add New

2

Upload Plugin

Click Upload Plugin at the top of the page

3

Select ZIP File

Click Choose File and select the downloaded swb-sell-window-blinds.zip file

4

Install Now

Click Install Now and wait for the installation to complete

5

Activate

Click Activate Plugin to enable SWB

Step 3: Database Setup

Upon activation, SWB automatically creates the required database tables. You'll see a success message confirming the setup.

Installation Complete

You should now see the SWB menu in your WordPress admin sidebar. Next, activate your license to unlock all features.

License Activation

Activate your license to enable automatic updates and access all features included in your plan.

Activating Your License

1

Navigate to License Settings

Go to SWB → License in your WordPress admin

2

Enter License Key

Enter the license key from your purchase confirmation email

3

Activate

Click Activate License to verify and enable your license

License Per Site

Each license key is valid for one WordPress installation. If you need to move your license to a different site, deactivate it first, then reactivate on the new site.

Get your first made-to-measure blind product live in 10 steps:

1

Create a Price Grid

Go to SWB → Price Grids → Add New. Create a grid with your width values as columns and drop values as rows. Enter prices for each dimension combination.

2

Set Up Stock Items

Go to SWB → Stock Items. Add your fabrics with stock codes, colours, and images.

3

Configure Product Parameters

Go to SWB → Product Configurator. Create parameters like "Fabric", "Control Side", "Mounting Type" with their options.

4

Create a WooCommerce Product

Go to Products → Add New. Create a simple product (e.g., "Roller Blind").

5

Assign Price Grid to Product

In the product editor, find the SWB Settings tab. Select your price grid from the dropdown.

6

Customize Frontend Appearance

Go to SWB → UI Designer. Adjust colours, fonts, and layouts to match your brand.

7

Set Up Child Safety Rules (Optional)

Go to SWB → Child Safety. Create rules for automatic chain length calculations.

8

Configure Order Export (Pro)

Go to SWB → Order Export. Set up suppliers and export formats.

9

Test Your Setup

View your product on the frontend. Enter dimensions, select options, and verify the price calculates correctly.

10

Place a Test Order

Complete a test purchase to verify the entire workflow from order to export.

Price Grids

Price Grids are the foundation of SWB's dimension-based pricing system. They allow you to define prices for any width × drop combination.

Understanding Price Grids

A price grid is a two-dimensional table where:

  • Columns represent width values (in mm)
  • Rows represent drop values (in mm)
  • Cells contain the price for that dimension combination

When a customer enters dimensions, SWB rounds to the nearest grid values and returns the corresponding price.

Creating a Price Grid

1

Navigate to Price Grids

Go to SWB → Price Grids in your WordPress admin

2

Add New Grid

Click Add New at the top of the page

3

Enter Grid Details

  • Title: Give your grid a descriptive name (e.g., "Roller Blind - Solar Range")
  • Lead Time: Manufacturing days for this grid (optional)
  • Discount %: Percentage discount to apply (optional)
4

Configure Grid Dimensions

  • Starting Width: First column value (e.g., 600mm)
  • Width Increment: Step between columns (e.g., 100mm)
  • Number of Columns: How many width values
  • Starting Drop: First row value (e.g., 600mm)
  • Drop Increment: Step between rows (e.g., 100mm)
  • Number of Rows: How many drop values
5

Generate Grid

Click Generate Grid to create the empty grid structure

6

Enter Prices

Click each cell and enter the price for that dimension combination. Use the keyboard shortcuts for efficiency.

7

Save Grid

Click Publish or Update to save your price grid

Visual Grid Editor

The visual grid editor provides a spreadsheet-like interface with powerful features:

Keyboard Shortcuts

Shortcut Action
Ctrl + C Copy selected cells
Ctrl + V Paste copied cells
Ctrl + Z Undo last action
Ctrl + Y Redo last undone action
Tab Move to next cell
Enter Move to cell below
Arrow Keys Navigate between cells

Drag to Fill

Select a cell or range of cells, then drag the fill handle (small square at bottom-right corner) to automatically fill adjacent cells with the same value or pattern.

Context Menu

Right-click on any cell to access:

  • Insert row above/below
  • Insert column left/right
  • Delete row/column
  • Copy/Paste
  • Clear contents

Importing Price Grids

Import existing price lists from CSV files:

1

Prepare Your CSV

Format your CSV with width values as the first row (headers) and drop values as the first column:

,600,700,800,900,1000
600,45.00,48.00,51.00,54.00,57.00
700,48.00,51.00,54.00,57.00,60.00
800,51.00,54.00,57.00,60.00,63.00
                    
                    
                
2

Import

Click Import CSV and select your file. The grid will be populated automatically.

Exporting Price Grids

Export your grids for backup or editing:

  • CSV Export: Downloads a spreadsheet-compatible file
  • JSON Export: Downloads a complete backup including all settings

Assigning Grids to Products

After creating a price grid, assign it to WooCommerce products:

  1. Edit any WooCommerce product
  2. Scroll to the Product Data section
  3. Click the SWB Settings tab
  4. Select your price grid from the Price Grid dropdown
  5. Save the product

Pro Tip: Multiple Grids

Create different price grids for different fabric ranges or product types. A "Premium Blackout" range might have different pricing than a "Budget Daylight" range.

Option Price Grids

Option Price Grids allow you to apply dimension-based pricing to product options, not just the base product.

When to Use Option Price Grids

Use option price grids when an add-on's price depends on the blind's dimensions. Common examples:

  • Motorization costs that scale with blind size
  • Premium fabric upgrades priced by area
  • Blackout lining that varies by size
  • Installation services based on dimensions

Creating an Option Price Grid

1

Navigate to Option Price Grids

Go to SWB → Option Price Grids

2

Add New

Click Add New and enter a title (e.g., "Motorization Upgrade")

3

Configure & Enter Prices

Use the same visual editor as main price grids to set dimension-based prices

4

Link to Option

Go to SWB → Product Configurator, edit the relevant option, and select this grid under Price Grid

Fixed vs Grid Pricing

Options can use either fixed price adjustments (e.g., +£15 for chain upgrade) or grid-based pricing. Choose grid pricing when the option's value scales with the product's dimensions.

Bulk Assignment

Bulk Assignment lets you assign price grids to multiple products simultaneously, saving hours of manual configuration.

Using Bulk Assignment

1

Navigate to Bulk Assignment

Go to SWB → Bulk Assignment

2

Select Price Grid

Choose the price grid you want to assign from the dropdown

3

Select Products

Use the tabs to filter by:

  • Products: Select individual products
  • Categories: Select entire product categories
  • Stock Items: Assign based on fabric/stock item
4

Apply Assignment

Click Assign Grid to apply. A progress bar shows the update status.

Alternative: WooCommerce Bulk Actions

You can also use WooCommerce's built-in bulk actions:

  1. Go to Products → All Products
  2. Select products using the checkboxes
  3. Choose Assign SWB Price Grid from the Bulk Actions dropdown
  4. Click Apply
  5. Select the grid and confirm

Product Configurator

The Product Configurator lets you create custom parameters and options that customers can select when ordering blinds.

Understanding the Structure

Product Codes

e.g., ROL, VER, VEN

Parameters

e.g., Fabric, Control Side

Options

e.g., Solar White, Left/Right

Creating Product Codes

Product codes are internal identifiers used for supplier routing and organization:

1

Navigate to Product Codes

Go to SWB → Product Configurator → Product Codes

2

Add New Code

Enter the code (e.g., "ROL") and description (e.g., "Roller Blinds")

3

Assign Categories

Select which WooCommerce categories this code applies to

Creating Parameters

Parameters are the configurable attributes customers can select:

1

Navigate to Parameters

Go to SWB → Product Configurator → Parameters

2

Add New Parameter

Click Add New

3

Configure Parameter Settings

  • Name: Internal name
  • Display Name: Label shown to customers
  • Type: Dropdown, Text, Number, or Checkbox
  • Required: Whether customer must select
  • Sequence: Display order (lower = first)
  • Show on Website: Whether visible to customers
  • Product Codes: Which product types use this parameter
  • Categories: Which categories use this parameter

Parameter Types

Type Use Case Example
Dropdown Select one from multiple options Fabric selection, Control side
Text Free-form text input Special instructions
Number Numeric input Quantity of blinds
Checkbox Yes/No toggle Include installation

Creating Options

Options are the choices available within each parameter:

1

Navigate to Options

Go to SWB → Product Configurator → Options

2

Add New Option

Click Add New

3

Configure Option Settings

  • Parameter: Which parameter this belongs to
  • Name: Internal name
  • Display Name: Label shown to customers
  • Price Adjustment: Fixed amount to add/subtract
  • Price Grid: Or use dimension-based pricing
  • Image: Visual representation
  • Default: Pre-selected option
  • Discountable: Whether discounts apply
  • Export Field: Field name for supplier exports

Conditional Options (Dependencies)

Show or hide options based on other selections:

1

Edit the Dependent Option

Open the option that should conditionally appear

2

Set Dependency

In the Depends On section, select the parent parameter and required option value

Example: Motorization Options

Create a "Control Type" parameter with options "Chain" and "Motorized". Then create "Motor Brand" options that only appear when "Motorized" is selected.

Adding Images to Options

Visual selection helps customers choose:

  1. Edit the option
  2. Click Set Image in the Image section
  3. Upload or select from Media Library
  4. Save the option

Images appear as swatches in the frontend configurator when UI Designer is set to show option images.

Stock Items

Stock Items represent your fabric inventory with detailed information for production and cutting optimization.

Creating Stock Items

1

Navigate to Stock Items

Go to SWB → Stock Items

2

Add New Stock Item

Click Add New

3

Enter Basic Information

  • Stock Code: Your internal code (e.g., "SOL-WHT-001")
  • Supplier Stock Code: Supplier's code if different
  • Fabric Range: Collection name (e.g., "Solar Reflective")
  • Colour Name: Colour description (e.g., "Pure White")
  • Colour Hex: Colour code for display (e.g., "#FFFFFF")
4

Set Roll Dimensions (for Fabric Optimizer)

  • Roll Length: Length of fabric roll in mm
  • Roll Width: Width of fabric roll in mm
  • Turn Fabric: Enable if pieces can be rotated 90°
5

Add Images

  • Main Image: Primary display image
  • Gallery: Additional images
  • Sample Image: Image for sample orders
6

Assign Categories & Product Codes

Select which product categories and codes can use this stock item

7

Link to Price Grid

Select which price grid applies when this stock item is chosen

Stock Item Fields Reference

Field Description Used In
Stock Code Unique identifier for inventory Orders, Exports, Analytics
Supplier Code Supplier's product code Supplier Exports
Fabric Range Collection/range name Frontend, Analytics
Colour Name Human-readable colour Frontend, Orders
Colour Hex CSS colour code Frontend swatches
Roll Length Roll length in mm Fabric Optimizer
Roll Width Roll width in mm Fabric Optimizer
Turn Fabric Allow 90° rotation Fabric Optimizer

Linking Stock Items to Options

Stock items typically link to "Fabric" parameter options. When creating fabric options, select the corresponding stock item to enable inventory tracking and analytics.

Child Safety Rules

Automatically calculate chain lengths to comply with child safety regulations in different regions.

Understanding Child Safety Requirements

Many countries require cord and chain loops on blinds to be limited in length to prevent child strangulation hazards. SWB automates these calculations based on your defined rules.

Creating Child Safety Rules

1

Navigate to Child Safety

Go to SWB → Child Safety Rules

2

Add New Rule

Click Add New Rule

3

Configure Rule

  • Rule Name: Descriptive name (e.g., "UK Standard")
  • Description: Internal notes about this rule
  • Country/Region: UK, Ireland, US, Australia, EU, or All
  • Priority: Higher number = evaluated first
  • Status: Enabled or Disabled
4

Set Dimension Ranges (Optional)

  • Min/Max Width: Apply only to blinds within width range
  • Min/Max Drop: Apply only to blinds within drop range
5

Enter Formula

Create the calculation formula using variables and operators

Formula Syntax

Available Variables

Variable Description
Width Blind width in mm
Drop Blind drop in mm

Available Operators & Functions

Operator/Function Description Example
+ Addition Drop + 100
- Subtraction Drop - 200
* Multiplication Drop * 0.9
/ Division Drop / 2
Round() Round to nearest integer Round(Drop - 200)
Floor() Round down Floor(Drop / 100) * 100
Ceiling() Round up Ceiling(Drop / 100) * 100
MIN() Minimum of values MIN(Drop - 200, 1500)
MAX() Maximum of values MAX(Drop - 200, 500)

Example Formulas

// UK Standard: Chain = Drop minus 200mm, minimum 500mm
MAX(Drop - 200, 500)

// Round to nearest 100mm
Round((Drop - 200) / 100) * 100

// Maximum 2/3 of drop
MIN(Drop * 0.67, 1500)
                    
                    
                

How Rules Are Applied

  1. Customer places an order
  2. SWB checks if product has "Child Safety" enabled
  3. Rules are evaluated by priority (highest first)
  4. First matching rule (by region and dimension range) is applied
  5. Calculated chain length is stored in order metadata
  6. Value is included in supplier exports

Enabling Child Safety on Products

  1. Edit the WooCommerce product
  2. Go to the SWB Settings tab
  3. Check Enable Child Safety
  4. Save the product

UI Designer

Customize the appearance of your frontend configurator with 150+ styling options - no coding required.

Accessing UI Designer

Go to SWB → UI Designer to access the visual customization interface.

Customization Sections

Container Settings

  • Background Color: Main container background
  • Border Color: Container border
  • Border Width: Border thickness in pixels
  • Border Radius: Corner rounding
  • Box Shadow: Drop shadow effect
  • Padding: Internal spacing
  • Max Width: Maximum container width
  • Alignment: Left, Center, or Right

Price Display

  • Position: Top or Bottom of configurator
  • Prefix: Text before price (e.g., "From:")
  • Font Size: Price text size
  • Font Weight: Normal, Bold, etc.
  • Color: Price text color
  • Show Description: Display price explanation

Unit Selector

  • Style: Pill, Radio, Buttons, or Dropdown
  • Layout: Inline or Stacked
  • Allowed Units: mm, cm, inches, feet
  • Default Unit: Pre-selected unit
  • Active Color: Selected unit highlight

Dimension Inputs

  • Layout: Side by Side or Stacked
  • Label Position: Above, Inline, or Floating
  • Width Label: Custom label text
  • Drop Label: Custom label text
  • Input Style: Modern, Classic, or Minimal
  • Focus Color: Highlight when typing

Parameters & Options

  • Style: Pill, Button, Radio, Checkbox, or Card
  • Layout: Inline, Grid, or Stacked
  • Columns: Grid column count
  • Selected Color: Active option highlight
  • Hover Color: Mouse-over effect
  • Checkmark Style: Dot, Check, or None
  • Show Images: Display option images
  • Image Size: Small, Medium, or Large

Buttons

  • Primary Button: "Get Instant Price" / "Add to Cart"
  • Secondary Button: "Order FREE Sample"
  • Colors: Background, text, hover states
  • Border Radius: Button corner rounding
  • Shadow: Button drop shadow
  • Width: Auto, Full, or Fixed

Live Preview

Changes in the UI Designer show a live preview so you can see exactly how your configurator will look before saving.

Reset to Defaults

Click Reset to Defaults to restore all settings to their original values.

Brand Matching

Use your website's primary brand colors for buttons and active states to maintain visual consistency across your store.

Product Formulas

Create custom calculations for pricing adjustments, metadata, and supplier requirements. Pro

Creating Formulas

1

Navigate to Formulas

Go to SWB → Formulas

2

Add New Formula

Click Add New

3

Configure Formula

  • Name: Descriptive name
  • Description: What this formula calculates
  • Type: Product, Option, or Both
  • Output Type: Number or Text
  • Decimal Places: For number output
  • Status: Active or Inactive
4

Enter Formula

Write your calculation using the formula syntax

Formula Variables

Variable Description
Width Blind width in mm
Drop Blind drop in mm
Qty Quantity ordered

Formula Examples

// Calculate fabric area in square meters
(Width * Drop) / 1000000

// Tube length (width + 50mm allowance)
Width + 50

// Price per square meter
((Width * Drop) / 1000000) * 45.00

// Conditional: Large blind surcharge
Case(Width > 2000, 25.00, 0)
                    
                    
                

Formula Types

  • Product Formulas: Apply to the base product calculation
  • Option Formulas: Apply when specific options are selected
  • Both: Apply in all contexts

Order Export

Automatically send orders to suppliers in their required format via FTP, webhook, or email. Pro

Setting Up Suppliers

1

Navigate to Order Export

Go to SWB → Order Export

2

Add New Supplier

Click Add Supplier

3

Configure Supplier Details

  • Supplier Name: Descriptive name
  • Export Type: CSV, XML/EDI, or Webhook
  • Status: Active or Inactive
4

Set Routing Rules

  • Categories: Route by product category
  • Product Codes: Route by SWB product code
5

Configure Delivery Method

Set up FTP credentials, webhook URL, or email settings

Export Formats

CSV Export

Tabular format with one row per order item. Columns include:

  • Order number, date, customer details
  • Product name, SKU, dimensions
  • All parameter selections
  • Prices and totals
  • Child safety calculations
  • Formula results

XML/EDI Export

Structured XML format for EDI integration:

<Order>
  <OrderNumber>1234</OrderNumber>
  <OrderDate>2024-01-15</OrderDate>
  <Customer>...</Customer>
  <Items>
    <Item>
      <ProductCode>ROL</ProductCode>
      <Width>1200</Width>
      <Drop>1800</Drop>
      <FabricCode>SOL-WHT-001</FabricCode>
      ...
    </Item>
  </Items>
</Order>
                    
                    
                

Webhook Export

HTTP POST request with JSON payload to supplier's endpoint. Configure:

  • URL: Supplier's webhook endpoint
  • Authentication: API key or Basic Auth
  • Headers: Custom HTTP headers

FTP Configuration

Setting Description
FTP Host Server address (e.g., ftp.supplier.com)
FTP Username Login username
FTP Password Login password
Folder Path Directory for order files
Acknowledgement Folder Directory for order confirmations
Passive Mode Enable for firewall compatibility

Export Logs

Go to SWB → Export Logs to view all export attempts:

  • Date and time of export
  • Order number and supplier
  • Status (Success/Failed)
  • Error messages for failures
  • Resend button for failed exports

Supplier Status Sync

Receive manufacturing status updates from suppliers automatically. Pro

How It Works

  1. Supplier receives your order export
  2. As manufacturing progresses, supplier sends status updates
  3. SWB receives updates via webhook
  4. WooCommerce order status is automatically updated
  5. Customer sees progress in their order tracking

Available Statuses

Status Description
Cutting Manufacturing has started, fabric being cut
Assembly Blind is being assembled
QC Complete Quality check passed
Shipped by Supplier Dispatched from manufacturer
Delivered Received by customer

Webhook Endpoint

Provide your supplier with your webhook URL:

https://yourstore.com/wp-json/swb/v1/supplier-status

Webhook Payload Format

{
  "order_number": "1234",
  "status": "Assembly",
  "timestamp": "2024-01-15T10:30:00Z",
  "notes": "Optional supplier notes"
}

Remake Orders

Track and manage product remakes due to defects or errors. Enterprise

Creating a Remake Order

1

Find Original Order

Go to WooCommerce → Orders and open the original order

2

Create Remake

Click Create Remake in the SWB Actions metabox

3

Select Item to Remake

Choose which line item needs to be remade

4

Modify If Needed

  • Adjust dimensions if measured incorrectly
  • Change fabric if defective
  • Update options as needed
5

Record Reason

Enter the reason for the remake (e.g., "Fabric defect", "Wrong size")

6

Create

Click Create Remake Order

Remake Order Numbering

Remakes are numbered with a suffix: Order 217 becomes 217-1, 217-2, etc.

Exports for Remakes

When remake orders are exported to suppliers:

  • Price is set to zero (supplier absorbs cost)
  • IsRemake_="True" flag is included
  • Original order number is referenced
  • Reason is included in notes

Managing Remakes

Go to SWB → Remake Orders to:

  • View all remake orders
  • See original vs. modified details
  • Track export status
  • Delete remakes if created in error

Analytics Dashboard

Business intelligence to understand what sells and optimize your product range. Enterprise

Accessing Analytics

Go to SWB → Analytics to view your dashboard.

Key Metrics

Metric Description
Total Orders Number of orders in period
Total Revenue Sum of order totals
Total Items Sold Number of blinds ordered
Average Order Value Revenue / Orders
Average Per Blind Revenue / Items
Samples Ordered Free sample requests

Sales Breakdowns

By Product Code

See which product types sell best:

  • Product code (ROL, VER, etc.)
  • Items sold
  • Revenue
  • Average per item

By Fabric Code

Identify top-selling fabrics:

  • Stock code
  • Fabric range
  • Colour
  • Items sold and revenue

By Range

Analyze fabric collection performance with visual bar charts.

By Colour

See which colours are most popular.

By Dimensions

Heat map showing popular width × drop combinations. Use this to optimize your price grid coverage.

Date Filtering

  • Quick Filters: Today, Last 7 Days, Last 30 Days
  • Custom Range: Select specific start and end dates

Exporting Data

Click Export CSV to download analytics data for external analysis in Excel or other tools.

Work Sheet

Internal production management system for tracking orders from receipt to completion. Enterprise

Accessing Work Sheet

Go to SWB → Work Sheet to open the production tracking interface.

Views

Orders View

See orders at the order level:

  • Order number and date
  • Customer name
  • Number of items
  • Order status
  • Tags assigned

Blinds View

See individual line items:

  • Order and item reference
  • Product and fabric details
  • Dimensions
  • Item status
  • Manufacturing date

Custom Statuses

Go to SWB → Work Sheet → Statuses to create custom workflow statuses:

1

Add Status

Click Add Status

2

Configure

  • Name: Status name (e.g., "Order Entered")
  • Color: Visual identifier
  • Sort Order: Position in workflow
  • Default: Set as initial status

Tags

Go to SWB → Work Sheet → Tags to create organizational tags:

  • Urgent
  • Express Delivery
  • Quality Check Required
  • Customer Called

Each tag has a custom colour for easy identification.

Updating Orders

  1. Click on an order or item in the Work Sheet
  2. Change status from the dropdown
  3. Add or remove tags
  4. Set manufacturing date if applicable
  5. Changes are saved automatically

Filtering & Sorting

  • Filter by status
  • Filter by tag
  • Filter by date range
  • Sort by any column
  • Search by order number or customer

Audit Trail

Every change is logged with:

  • What changed
  • Who made the change
  • When it happened

View history by clicking the history icon on any order.

Label Designer

Create custom labels for production with a drag-and-drop visual editor. Enterprise

Accessing Label Designer

Go to SWB → Work Sheet → Labels

Creating a Label Template

1

Create New Template

Click New Template

2

Set Page Size

Choose paper size (A4, A5, etc.) and orientation

3

Drag Fields

Drag fields from the Available Fields panel onto the label canvas

4

Position & Resize

Drag fields to position, use handles to resize

5

Save Template

Give your template a name and save

Available Fields

Customer Fields

  • Customer Name
  • Company
  • Email
  • Phone
  • Address (full or components)

Order Fields

  • Order ID / Number
  • Order Date
  • Order Status
  • Order Total
  • Payment Method
  • Shipping Method
  • Order Notes

Item Fields

  • Product Name
  • Width / Drop
  • Quantity
  • All parameter values
  • Stock Code / Fabric
  • Child Safety Value
  • Formula Results

Printing Labels

  1. Go to Work Sheet
  2. Select orders or items (checkboxes)
  3. Click Print Labels
  4. Select your template
  5. Click Generate PDF
  6. Print the PDF

Fabric Optimizer

Intelligent cutting algorithm to minimize fabric waste and generate cutting sheets. Enterprise

How It Works

The Fabric Optimizer uses a First Fit Decreasing (FFD) bin packing algorithm to calculate optimal piece placement on fabric rolls.

Using the Fabric Optimizer

1

Go to Work Sheet - Blinds View

Navigate to SWB → Work Sheet and switch to Blinds View

2

Select Items

Use checkboxes to select items for cutting. Items are automatically grouped by fabric.

3

Click Optimize Cutting

Choose Optimize Cutting from the bulk actions menu

4

Review Layout

Visual layout shows piece placement. Hover over pieces for details.

5

Generate PDF

Click Generate Cutting Sheet to create a printable PDF

Visual Layout

  • Blue pieces: Normal orientation
  • Orange pieces: Turned 90° (when Turn Fabric is enabled)
  • Hover: Shows order number, customer, dimensions

Statistics

Each cutting optimization shows:

  • Total pieces
  • Roll length used (mm)
  • Total fabric area (m²)
  • Waste percentage
  • Efficiency percentage

Requirements

For the optimizer to work, Stock Items must have:

  • Roll Length: Total length of fabric roll (mm)
  • Roll Width: Width of fabric roll (mm)
  • Turn Fabric: Optional - allow pieces to be rotated

Turn Fabric

Enable "Turn Fabric" on stock items where the pattern allows rotation. This gives the optimizer more flexibility and typically reduces waste by 5-15%.

Frontend Display

How your blind configurator appears and functions for customers.

Configurator Components

The frontend configurator displays on product pages and includes:

  1. Dimension Inputs: Width and Drop fields with unit selector
  2. Parameters: All configured parameters with their options
  3. Price Display: Real-time calculated price
  4. Add to Cart Button: Adds configured product to cart
  5. Sample Button (Optional): Request a free fabric sample

Price Calculation Flow

  1. Customer enters dimensions
  2. Dimensions are converted to mm internally
  3. System rounds to nearest grid values
  4. Base price is retrieved from the assigned price grid
  5. Option adjustments are added (fixed or grid-based)
  6. Formulas are applied
  7. Discounts are applied if enabled
  8. Final price is displayed

Dimension Validation

SWB validates dimensions against your price grid:

  • Minimum width/drop from grid's first column/row
  • Maximum width/drop from grid's last column/row
  • Error messages shown if dimensions are out of range

Unit Conversion

Customers can enter dimensions in their preferred unit:

Unit Conversion to mm
mm 1:1
cm ×10
inches ×25.4
feet ×304.8

Multiple Blinds

Customers can add multiple blinds to cart with different dimensions and options in a single session.

Order Management

How SWB data appears in WooCommerce orders and what you can do with it.

Order Item Display

SWB-configured products show in order items with:

  • Product name
  • Dimensions (Width × Drop)
  • All selected parameters and options
  • Child safety calculations
  • Formula results
  • Stock code / Fabric information

Order Metadata

All SWB data is stored as order item metadata and is:

  • Visible in admin order view
  • Included in order confirmation emails
  • Available in order exports
  • Accessible via WooCommerce REST API

Editing Orders

While standard WooCommerce order editing is available, we recommend creating remake orders rather than modifying existing order items to maintain accurate records.

Order Notes

SWB adds system notes to orders for:

  • Export status (sent to supplier)
  • Supplier status updates received
  • Remake orders created

Troubleshooting

Solutions to common issues you may encounter.

Configurator Not Showing

Problem:

The configurator doesn't appear on product pages.

Solutions:

  • Verify a price grid is assigned to the product (Product → SWB Settings tab)
  • Check that the price grid is published (not draft)
  • Clear any caching plugins
  • Check for JavaScript errors in browser console (F12)
  • Ensure WooCommerce is active and up to date

Price Not Calculating

Problem:

Entering dimensions doesn't show a price.

Solutions:

  • Check that the price grid has values in all cells
  • Verify dimensions are within the grid's range
  • Look for JavaScript errors in console
  • Test with a different theme to rule out conflicts

Export Failing

Problem:

Orders fail to export to suppliers.

Solutions:

  • Check Export Logs for specific error messages
  • Verify FTP credentials are correct
  • Test FTP connection with an FTP client
  • Ensure the server allows outgoing FTP connections
  • Try enabling Passive Mode in FTP settings
  • Check webhook URL is accessible and returns 200 OK

Parameters Not Showing

Problem:

Created parameters don't appear on frontend.

Solutions:

  • Check "Show on Website" is enabled for the parameter
  • Verify the parameter is assigned to the correct categories
  • Ensure the parameter has at least one option
  • Check the parameter's product codes include the product's code

Child Safety Not Calculating

Problem:

Chain length calculations aren't appearing in orders.

Solutions:

  • Enable "Child Safety" on the product (SWB Settings tab)
  • Create at least one active child safety rule
  • Verify the rule's country/region matches the customer's address
  • Check the rule's dimension ranges include the ordered dimensions

Performance Issues

Problem:

Admin pages or frontend are slow.

Solutions:

  • Increase PHP memory limit to at least 256MB
  • Enable object caching (Redis or Memcached)
  • Use pagination for large lists
  • Optimize database tables (WordPress → Tools → Site Health)

Frequently Asked Questions

Can I use SWB with variable products?

SWB is designed for simple products where the "variations" are dimensions and options configured through SWB. Using standard WooCommerce variable products is not recommended as it would create duplicate configuration systems.

How do I update the plugin?

With an active license, updates appear in WordPress Dashboard → Updates. Click "Update Now" to install. Always backup your site before updating.

Can I have different price grids for different fabrics?

Yes! Create multiple price grids and link them to stock items. When a customer selects a fabric, the associated price grid is used for calculations.

How do I handle international shipping with different currencies?

SWB uses WooCommerce's currency settings. For multi-currency, use a plugin like WooCommerce Multi-Currency. Your price grids should be in your base currency.

Can I export data from SWB?

Yes. Price grids can be exported as CSV or JSON. Analytics data can be exported as CSV. Order data exports include all SWB metadata.

Is SWB compatible with my theme?

SWB is designed to work with any WooCommerce-compatible theme. The UI Designer allows extensive customization to match your theme's styling.

How do I add a "Free Sample" button?

In Product Configurator, create a parameter (e.g., "Sample") with a "Request Free Sample" option. Enable "Sample" in the option settings. The sample option bypasses the price grid and can have its own fixed price (usually £0).

Can multiple staff members use Work Sheet?

Yes. Work Sheet supports multiple users. All changes are logged with the user who made them in the audit trail.

What happens to my data if I deactivate SWB?

All data remains in your database. Price grids, stock items, orders, and analytics are preserved. Reactivating the plugin restores full functionality.

How do I contact support?

Email [email protected] with your license key and a description of your issue. Enterprise customers receive priority support.

eCommerce software to Sell Window Blinds Online & eCommerce WooCommerce to Sell Window Curtains Online