Zevvo File Upload for WooCommerce

UKK

Is this compatible with HPOS?

Yes. Zevvo File Upload is built specifically for WooCommerce’s High-Performance Order Storage (HPOS) and works with both HPOS and legacy (post-based) order storage.

What file types are supported?

The plugin supports JPG, PNG, GIF, WebP, PDF, and ZIP. Each file type can be toggled on or off per product from the product metabox.

Where are files stored?

Files are stored in your WordPress uploads directory at wp-content/uploads/zevvo_uploads/. Filenames are randomized (MD5 hash) for security. The directory is protected with .htaccess rules that prevent PHP execution and directory listing.

Note for Nginx users: .htaccess rules don’t apply on Nginx. Files are still protected by random hashed names, but we recommend configuring your Nginx server block to deny direct access to the zevvo_uploads directory for additional protection.

Can I set a file size limit?

Yes. Each product has its own maximum file size setting (in MB). The default is 10 MB.

How do I view uploaded files?

Go to WooCommerce → Zevvo Uploads in your admin. You’ll see all uploaded files with options to view (with in-admin preview), download, move to trash, or permanently delete.

Are files shown in order emails?

Yes. Image uploads appear as thumbnail previews and documents (PDF, ZIP) appear as file icons in WooCommerce order confirmation emails sent to both customers and admins.

What happens to files when an order is cancelled?

Files remain in the system and stay attached to the order. You can manually delete them from the admin dashboard.

Does this work with variable products?

Yes. File upload settings are configured on the parent product and apply to all variations.

Can customers upload multiple files?

Yes. You can allow 1 to 5 files per product. The upload field displays a counter showing how many files have been selected out of the allowed maximum.

Can I make the upload field required?

Yes. Check the Required Field option in the product metabox. Customers will not be able to add the product to cart without uploading at least one file.

Is there a file upload limit per order?

No order-level limit. Each product in the cart can have its own independent file upload configuration.

What about theme compatibility?

The plugin works with any properly-coded WooCommerce theme. It uses standard WooCommerce hooks for classic themes, and includes Store API integration for block-based cart and checkout.

Can I export uploaded files data?

Yes. Go to WooCommerce → Zevvo Uploads, navigate to the Process Uploads tab, and click the Export CSV button to download all file records as a CSV file.

How does automatic cleanup work?

A daily WordPress cron job removes ”pending” files (uploaded but never attached to an order) that are older than 24 hours. This prevents orphaned files from accumulating on your server. The retention period for attached files is configurable in the plugin settings.

How do I customize file upload behavior with code?

The plugin provides the following filters and actions for developers:

Filters:
* zevvo_allowed_file_types — Modify allowed MIME types for a product ($types, $product_id)
* zevvo_max_upload_size — Modify the maximum file size in MB ($size_mb, $product_id)
* zevvo_max_files_count — Modify the maximum number of files ($max_files, $product_id)
* zevvo_session_abuse_limit — Change the per-session global upload ceiling ($limit)

Actions:
* zevvo_validate_upload — Run custom validation before a file is saved ($file, $post_id)

See the docs/DEVELOPER-HOOKS.md file in the plugin directory for usage examples.

Is this GDPR compliant?

Yes. Pending (unattached) files are automatically deleted after 24 hours. Attached files are stored only as long as needed for order processing, and you can configure automatic deletion after a set number of days in the plugin settings.

Does it work with Gutenberg blocks?

Yes. The plugin includes a Gutenberg block for product pages and is fully compatible with the WooCommerce block-based cart and checkout via the Store API integration.

What if I need help?

Use the WordPress.org support forum for this plugin.