Deco Network WooCommerce Integration

Integrate DecoNetwork product customization with WooCommerce. Customers can customize products via DecoNetwork and add them to their WooCommerce cart. On checkout, orders are committed to DecoNetwork using the Commit Order Password.

Setup

1. Install and activate the plugin.
2. Go to WooCommerce > Deco Network in your WordPress admin.
3. Enter your DecoNetwork Store Secure URL (e.g., https://yourstore.deco-apparel.com).
4. Enter your Commit Order Password (from your DecoNetwork store settings).
5. Save changes.

Usage

• For each WooCommerce product you want to enable for DecoNetwork customization:
  1. Edit the product.
  2. Enable "Deco Network Integration" and enter the DecoNetwork Product ID.
  3. Save the product.
• Customers will see a "Customize with Deco Network" button on the product page.
• After customizing, they are redirected back to your site and can add the customized product to their cart.
• On checkout, the order is committed to DecoNetwork using the Commit Order Password.

Requirements

• WooCommerce
• DecoNetwork Enterprise plan with External Cart API enabled

Support

For help, see the plugin documentation or contact support.

Features

• Simple Redirect Integration: Customers are redirected to Deco Network's customization platform
• Seamless Return Flow: Customers return to your site with customization data
• Cart Integration: Customized products seamlessly added to WooCommerce cart
• Order Management: Customization data saved with orders
• Admin Interface: Easy configuration and management through WordPress admin

Installation

1. Download the plugin ZIP file
2. Go to WordPress Admin → Plugins → Add New
3. Click "Upload Plugin" and choose the ZIP file
4. Click "Install Now" and then "Activate Plugin"

Configuration

1. Deco Network Setup

1. Go to WooCommerce → Deco Network in your WordPress admin
2. Enter your Deco Network Store Secure URL
3. Enter your Commit Order Password
4. Click "Save Changes"
5. Click "Test Connection" to verify your credentials

Note: The Store Secure URL is now configurable in the plugin settings. Use the full URL to your Deco Network store.

2. Product Setup

1. Go to Products → Add New or edit an existing product
2. In the "Product Data" section, check "Enable Deco Network Integration"
3. Enter the Deco Network Product ID from your Deco Network dashboard
4. Save the product
5. The "Customize with Deco Network" button will appear on the product page

How It Works

Customer Journey:

1. Customer visits product page → Sees "Customize with Deco Network" button
2. Customer clicks "Customize" → Redirected to Deco Network's platform
3. Customer customizes product → Uses Deco Network's full customization tools
4. Customer saves customization → Deco Network redirects back to your site
5. Customer returns to your site → Customization data is automatically added to cart
6. Customer completes checkout → Order processed normally through WooCommerce

Technical Flow:

1. Redirect Creation: Plugin creates authenticated redirect URL to Deco Network
2. Session Management: Unique session ID tracks the customization process
3. Data Return: Deco Network redirects back with customization data
4. Cart Integration: Customization data is stored and added to cart
5. Order Processing: Standard WooCommerce checkout with customization details

Benefits

• Full Platform Access: Customers get access to Deco Network's complete tools
• Reliable: No dependency on complex webhook systems
• Secure: Commit Order Password authentication
• Flexible: Works with any Deco Network product
• Mobile Friendly: Works perfectly on all devices

URL Structure

The plugin creates redirect URLs in this format:

https://nocapcustoms.secure-decoration.com/designer/customize?username=YOUR_USERNAME&password=YOUR_PASSWORD&product_id=DECO_PRODUCT_ID&return_url=YOUR_RETURN_URL&session_id=UNIQUE_SESSION_ID

Return URL Format

Deco Network should redirect back to your site with:

https://your-site.com/product-page/?deco_return=1&product_id=123&session_id=deco_abc123_1234567890

Customization Data Format

The plugin expects Deco Network to return customization data in this format:

{
  "design_name": "Custom Design",
  "customizations": [
    {
      "name": "Text",
      "value": "Hello World"
    },
    {
      "name": "Color",
      "value": "Blue"
    }
  ],
  "preview_url": "https://example.com/preview.jpg"
}

Troubleshooting

Common Issues

1. Connection failed: Verify your Deco Network credentials
2. Customize button not appearing: Make sure the product has Deco Network integration enabled
3. Customization not saving: Check that the return URL is correctly formatted
4. Session not found: Verify that WooCommerce sessions are working

Getting Help

• Check the DOCUMENTATION.md file for detailed technical information
• Review WordPress and WooCommerce logs for error details
• Test the connection using the "Test Connection" button

Changelog

Version 1.0.0

• Initial release
• Redirect-based Deco Network integration
• Commit Order Password authentication
• Cart and checkout integration
• Admin interface

License

This plugin is licensed under the GPL v2 or later.

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

Credits

• Built with WordPress and WooCommerce best practices
• Integrates with Deco Network's product customization platform at https://itscustom.secure-decoration.com