CX Cart File Uploads

# CX Cart File Uploads

A lightweight WooCommerce extension that allows customers to upload one or more files for individual cart items directly from the cart page.

Uploaded files are stored outside the WordPress Media Library, linked to the corresponding order item during checkout, and can optionally be attached to WooCommerce emails.

Features

• Upload multiple files per cart item
• AJAX-powered uploads and file removal
• Files stored outside the Media Library
• Automatic file transfer from cart to order
• File links visible in WooCommerce admin orders
• Optional email attachments for order notifications
• Automatic cleanup when cart items or orders are deleted
• Simple and lightweight architecture

Requirements

• WordPress 6.0+
• WooCommerce 7.0+
• PHP 7.4+

Installation

1. Upload the plugin folder to:

   wp-content/plugins/

2. Activate the plugin from the WordPress admin panel.

3. The upload field can be displayed using:

   do_action(
       'cx_cart_upload_field_here',
       $cart_item,
       $cart_item_key
   );

File Storage

Uploaded files are stored inside:

wp-content/uploads/cart-files/

After checkout, files are automatically moved to:

wp-content/uploads/order-files/{ORDER_ID}/

Files are not added to the WordPress Media Library.

Hooks

Display Upload Field

do_action(
    'cx_cart_upload_field_here',
    $cart_item,
    $cart_item_key
);

Folder Structure

cx-cart-file-uploads/
│
├── assets/
│   ├── css/
│   └── js/
│
├── includes/
│   ├── class-plugin.php
│   ├── class-assets.php
│   ├── class-file-manager.php
│   ├── class-upload-handler.php
│   ├── class-cart-ui.php
│   ├── class-order-handler.php
│   └── class-email-handler.php
│
└── templates/
    └── upload-field.php

Notes

• Uploaded files remain associated with the order item after checkout.
• Files are automatically removed when the related order is deleted.
• Uploaded files can be attached to selected WooCommerce email notifications.
• The plugin does not modify the WordPress Media Library.