Code

WooCommerce Upload Files

WooCommerce Upload Files

Note: The plugin, like WordPress, requires a minimum 5.5 PHP version.

LIVE DEMO (please report if it is not working)

url: https://www.codecanyon.eu/wcuf/wp-admin/
user: demo
pass: demo

user: demo1
pass: demo

user: demo2
pass: demo

How to automatically update the plugin

To receive automatic updates just install and configure the Envato updater plugin: httpss://goo.gl/pkJS33 .The official guide that explains how to configure it can be found in the following link: httpss://envato.com/market-plugin .

WCUF

DOCUMENTATION

HOW DOES IT WORK?

The customer will be able to upload one or more files from the Product page, Order Detail page and/or during the Checkout process according to the purchased items …all done using visual progress bars! All the uploads will be bounded to the order and optionally to specific products

Shop admin will find these uploads directly on the backend Order detail page or as an optional feature they can be sent to the shop admin email address.

Note: The plugin supports only native WooCommerce product types (simple and variable), it doesn’t have any support for custom product types implemented by 3rd paty plugins.

HOW TO CONFIGURE

It’s very simple! To configure a new upload field go to Upload files Configurator menu and add a new Upload field.
Once created, the admin has just to configure in which page the field has to be displayed (Product, Cart, Checkout, Order details) and configure its “visibility” according to the filtering criteria (enabled/disabled for specific products, categories or for every item).
This will create one upload field for every matching product (and optionally also for every single variant according to some restrictions in case of Product page) displayed in the selected pages!
Furthermore, for a more deep customization, is also possible to specify some other options like:
  1. Field title
  2. HTML/CSS description
  3. HTML/CSS text showed after the upload has been completed (it’s also possible to use some special shortcodes to display file list with image/audio preview)
  4. max uploadable file size
  5. max and min images width, height and DPI (works only if uploaded files are jpg/png. DPI data is read from image EXIF. If it has not a valid EXIF data the upload won’t be permitted)
  6. allowed file types
  7. email notifications
  8. enable multiple files upload per single field
  9. …and much more!

DROPBOX SUPPORT

WCUF now allows you to save uploaded files on your DropBox account!

Once enabled the special option on the plugin Options menu, whenever an order is placed at the checkout (or when the customer saves the uploads in the Order page), all the temporary uploaded files will be moved from server to your DropBox account!

The plugin will create a folder in your DropBox account under Applications -> WooCommerce Upload Files -> site_name -> {order_id} where files will be saved. In case the upload are bounded to prouct, you will find an additional sub directory product_id-variation_id.

In case of connection errors with DropBox…do not worry! Files will be normally kept on local server and you will be normally able to manage them via the order details page! You will receive a notification email reporting errors details.

NOTE: Keep in mind that temporary files are still saved on your local server, they will be deleted once moved to DropBox. Make sure that max_execution_time (script max execution time) PHP setting is properly configured, otherwise File move process from server to DropBox may fail in case of big file handling.

Upload unlimited number of files without file size restriction

WooCommerce Upload files allows you to upload unlimited number of files, without any file size restriction. Thanks to its innovative chunk upload technology, it can upload any file without restriction.

EMAIL NOTIFICATION & ATTACHMENTS

As Shop Admin, do you want to be notified whenever an user uploads a file and you want to receive the download link directly via email? Now you can!
For each upload field you can now enable an “Email notification” option.
If you like you can also receive the uploaded files directly in your inbox, thanks to the “Attach uploaded file” option. Furthermore you can also specify multiple recipients email addresses!

NOTE: Some servers have restrictions preventing wp_email() to send attachments bigger than 5mb. If you are experience this kind of problem, you can simply install any SMTP emailer plugin. This kind of plugins will let you to use any external email services (like gmail, outlook, any smtp server) to send emails.

CROP IMAGES BEFORE UPLOADING

The WCUF plugin embeds a crop image editor that allows your customers to crop an image before uploading it.
To enable the embedded editor, the shop admin has just to enable the option in the Image media file section in the upload field configuration tool and set the Cropped image width and Cropped image height values. These values are the sizes that the image will have after cropping process.

PRODUCT PAGE UPLOADS

Optionally, is now possible to upload files also before adding item to the cart! (in this case some features are not avaiable)

Shop admin can configure the upload fields to be visible directly on the Product page!
In this way your customers can upload a file (or multiple files according to the “multiple files for single field” option) directly from the product page.

NOTE: Upload fields by default are associated to distinct products in cart. So if the user is adding for example Product 1 (quantity 3) and you have created 2 upload fields, the plugin will display only 2 upload fields not 6 (because there is only 1 product in cart with quantity 3, not 3 distinc products).
If you want add the same product multiple times to cart (in this way the plugin will associate distinct upload fields for each item in cart) use the Individual products feature explained next.

In case of variable product page, if the field has been configured to be visible before adding to the cart and checked the Enable one upload field for every single product variation option, it will be showed only once a variation has been selected. More in details: The user has to choose a variation on the product page and once done, the plugin will show the associated upload field.

Furthermore is also possible specify where the uploads fields box have to be displayed (before/after variable options dropdowns, product description, etc.) or using the special [wcuf_product_page_upload_form] you can render the upload form inside any product text area supporting shorcodes!

NOTE: Make sure the theme used is using all the standards woocommerce product page template hooks.
If the [wcuf_product_page_upload_form] is used the standard upload field managment for Product pages MUST been disabled (to do that Options -> Forced disabling upload fields standard managment -> Product pages )

INDIVIDUAL PRODUCTS CONFIGURATOR

Would you like to add same product different times to cart in order to upload distinct files? For example you want to sell Business cards so you would like to allow your customers to add that product multiple times to cart and then upload distinct files for each item? Now you can!
Using the Individual products configurator you have just to select the product and/or the categories you wish to be sold as individual. In this way each time the users adds one of the selected product, the plugin will add to cart as distinct product. In this way the customer will be able di upload diffrent files for each item in cart.

CHECKOUT, CART AND ORDER PAGES UPLOADS

Every upload can be configured to be visible on cart, checkout and orders pages! Check plugin options to eventually change field positioning!

REQUIRED FIELD OPTION

Shop admin can also enable the required option. In this case on the shop page for all the products matching the upload field the Add to cart buttons are disable and replaced by a View button that forces Customer to enter in product page.

In the product page if the field has been configured to be visible before the product is added to the cart, the plugin will try to hide the add to cart button (with some theme not 100% WooCommerce compliant this feature could not work). So the user is forced to upload files before he is able the item to the cart.

Furthermore, on Checkout page, if all not the required uploads have not been performed, the customer will not be able to place the order! The plugin will display a notice letting the Customer know which upload are missing.

In case you have configured the upload field to be showed after the product is added to the cart or if the item was in the cart and the user deletes a required upload, the plugin will try to deny the page leave showing a warning message until all the required files have not been uploaded! (NOTE: some browsers, for security reasons, may not permit this denial).
For a less aggressive requirement check, go to Options and in the Allow user to leave page in case of required field select Yes option. Doing so the user will be prompted only at first page leave with a warning message on the next try he will be able to normally leave the page.

FIELD VISIBILITY ACCORDING TO USER ROLE

Fields can be optionally be visible/unvisible according to the current user role!

FIELD VISIBILITY ACCORDING TO SELECTED PAYMENT METHOD

Fields can be optionally be visible/unvisible only if the order selected payment method is among the selected ones during the field configuration!

NOTE: This field is only available for fields displayed in Order details and Checkout pages.

FIELD POSITIONING

Using the Options menu you can choose where the upload fields have to be positioned in the Product, Cart and Checkout pages! (This is done using the standard WooCommerce hooks, NO custom positioning)

MULTIPLE FILES FOR SINGLE UPLOAD FIELD

By default for every field is possible to upload only a single file, but optionally WCUF gives also the possibility to upload multiple files using a single upload field. In this case is also possible to configure the maximum number of uploadable files and file size.

Once files are uploaded, WCUF will create a .zip file containing all the uploaded files.
Number of uploadable files for a single upload field can also be “bounded” to product quantity in cart or purchased (Option is not avaiable for Product page if the “show upload field before adding an item to the cart” option is enabled), in this way the customer cannot upload more than X files for a field (Where X is the quantity of the item purchased/in cart).

NOTE: Multiple files for single field upload feature requires the PHP feature “ZipArchive” commonly available in most web host services. If not active, this feature will be not available.

MULTIPLE FILES AND QUANTITY SELECTION

In case of multiple files upload for a single upload field, enabling the special option by going in Upload files Configurator -> Options menu and the selecting Yes option on the Enable quantity selection section, For each uploaded file will be enabled an input box that will allow the customer to select a quantity value.
For example, a printing service that is selling a 100×100 print sercvice. A customer is buying 5 items of 100×100 print and he would like to print 3 copies for the first file and 2 for the second. Thanks to the quantity option, he can set as quantity for the first uploaded file as 3 and 2 for the second!

Product cart quantity according the number of uploaded files

Through the Options to enable the special option that will automatically set the product cart quantity according the number of uploaded files (and their quantities in case of multiple files fields)! This feature is particular useful if you want to set special discounts or assign product price according the cart quantity!

If you need a tool for that, give an eye to my WooCommerce Pricing & Discounts! plugin!

Product cart price according to the associated extra costs

Is now possible to dyncamically assign a price to a cart item according to the extra costs associated to its upload fields! For example is now possible to assign a price to a product according to the number of the uploaded files!

EXTRA FEES/DISCOUNT PER UPLOAD WITH SPECIAL “SECONDS OVERCHARGE” FOR MEDIA FILES

WCUF allows to set extra fees for every uploaded file. It works also if the multiple files uploads for single field option has been enabled. The shop admin can choose to overcharge a fixed value or a percentage of the original price (like an additional 20% extra for every uploaded file).
Furthermore is possible to set also an “Overcharge limit” beyond which the customer will no be overcharged for additional uploads and set “Extra cost free” for the first N uploaded files (including quantity).

For audio/video files (most common extension) is also possible overcharge an extra cost per each second (the media file has to have well encoded ID3 info, otherwise the plugin cannot detect the needed info)!

For PDF is now possible to compute extra costs according to the number of pages of the uploaded files. The shop admin can also set how many free pages and the maximum number of extra chargeable pages.
NOTE: The PDF file must be a valid PDF enconded file.

To apply a Discount for each uploaded file you have just to set a negative value in the extra cost value! In this way the plugin will apply a negative fee to the cart to apply the discount!

Checkout sub total percentage discout

For each upload field it is possible to apply a percentage discout to the Checkout sub total if at least one file has been uploaded.

CUSTOMIZABLE BUTTON TEXTS (AND TRANSLATABLE VIA WPML)

Using the Text menu voice is possible to customize button texts used to upload, delete, crop, etc. files.
If your site is using WPML, you can set button texts for each language! You have only to switch language using the WPML language selector and then set texts!

WPML AND UPLOAD FIELDS TEXTS

Upload field titles, descriptions, disclaimer texts, etc. can be translated using the String translation WPML menu and selecting the woocommerce-files-upload-field-text domain!

RESPONSIVE FIELDS DISPLAY

Upload Fields in Cart, Checkout, Order and Shortcode pages are now responsive. They are grouped and displayed in row and row elements width can be setted via option menu. By default the plugin displays one upload field per row.

SHORTCODES

Would you like to show the upload fields form only on a specific page? or maybe would you like to render the upload form in a custom area or in a text area during the checkout proces? Now you can!
WCUF plugin exposes the following shorctodes to be used according your needs:
  1. [wcuf_upload_form]: It will render an upload form with all the upload fields that match the products currently added to the cart in any area supporting shortcode system. It CANNOT be used in the Products, Cart or Checkout pages.
  2. [wcuf_product_page_upload_form]: It will render the Product page upload form in any area supporting shortcode system. It can be uses ONLY in the Product page.
  3. [wcuf_cart_page_upload_form]: It will render the Cart page upload form in any custom area supporting shortcode system. It can be uses ONLY in the Cart page.
  4. [wcuf_checkout_page_upload_form]: It will render the Checkout page upload form in any custom area supporting shortcode system. It can be uses ONLY in the Checkout page.
  5. [wcuf_upload_form_last_order]: It will render an upload form with all the upload fields that match the products bought in the last order for the currently logged user. It CANNOT be used in the Products, Cart or Checkout pages.

The special shorctode for Product, Cart and Checkout pages are useful if you want to show the upload fields in custom area like tabs or text field (both of them must support shortcodes system).

NOTE: In order to use [wcuf_product_page_upload_form], [wcuf_cart_page_upload_form] or [wcuf_checkout_page_upload_form] you must disable the standard upload field managment by going to Options -> Disable upload field standard managment and select the pages in which you are using the shortcode. The shortcodes can be used only one time per page.

My Account page and automatic upload fields display for last order

WCUF can optionally show upload fields for the last placed order directly from the My Account page! To enable this feature, you have to enable this display option from the Options general menu.

IMAGE/AUDIO PREVIEW

WCUF allows also to display an image preview (only for standard jpg/png compressed files) and audio preview (mp3/wav files) for the uploaded media files. to do that, you have to use the special shortcode [file_name_with_media_preview] in the “Text showed after the upload is completed” field during the upload field configuration.

Cart and Checkout product table preview

You can optionally display uploaded images preview (only for standard jpg/png compressed files) for each product inside the product table showed on both Cart and Checkout pages!

Additionally, in cart page, product thumbs can be replaced with the uploaded images preview… just enable the special options you need through the options menu!

UPLOADS SUMMARY FEATURE

From the Options menu is possible to allow the display of the uploaded files list in the Cart, Checkout and/or Order details page.

UPLOADS COUNTER

The plugin adds a new column “Upload counter” to the orders table. This will help you to easily track the number of uploads made by the users for each order.

CUSTOMER FEEDBACK TEXT AND DISCLAIMER

Optionally, the shop admin can enable feedback text to bi visible in product, cart, checkout and order details page upload fields and a “Disclaimer” checkbox with text that the user has to check before uploading.

UPLOADS PROGRESS BAR

Give some feedback to your users! During file upload on the order page will be displayed a progress bar.

BULK UPLOADS DELETE

Directly from Orders list, you can delete all the uploads for the selected orders.

WC Multivendor

For WC Multivendor users, uploaded files can be also downloaded from the Vendor frontend order details page!

CHANGE ORDER STATUS

optionally if at least one upload is performed from Order details or the Thank you pages, order status can be automatically changed to the one selected via the options menu! To enable this feature, just use the Options menu!

KEEPS YOUR SERVER CLEAN

On order deletion, every upload is deleted too.



WooCommerce template compliance note

If you are using a theme implementing custom add to cart functions on product page (like adding the product to cart without reloading the page), the WooComerce Upload Files plugin may not work. It has been designed to work on standard product page template so altering its structure or behaviour may cause the plugin to no properly work or unexpected behaviors. If you are using any custom template, restore its standard behaviour before using the plugin.

Action and hooks

  1. wcuf_order_sub_folder_name (filter): triggered when creating order folder containing uploaded files. By default, if files are bounded to product, sub folder have to following name structure {product_id}_{variation_id}. The action allows to customize that name. Use the following signature for the handler: your_function_name($folder_name, $product_id, $variation_id) and hook using the following: add_filter(‘wcuf_order_sub_folder_name’, ‘your_function_name’, 10, 3);

Compability

The plugin has been tested with desktop version of Chrome, FireFox and Edge. To properly work it requires fully HTML5 compliant browsers otherwise it could not work as expected. The plugin requires the browser to be fully working. In case any browser suffer of a particular issue (like a mobile browser that in a particular version is not capable of multiple selecting files due to bug that prevent its native controller to properly work) preventing the plugin to properly work, report to its developer or switch to a full working one. I’m cannot held responsable for third party software issues.

WooCommerce Upload Fields screenshots

PRODUCT PAGE UPLOAD

WCUF
WCUF

[file_name] and [additional_costs] shortcodes in action on “Already uploaded” textfield WCUF

Images preview after upload WCUF

SPECIAL QUANTITY OPTION EXAMPLE (IN CASE OF MULTIPLE FILES UPLOAD FOR SINGLE FIELD)

WCUF

CHECKOUT NOTICE IF TRYING PLACING ORDER WITH REQUIRED UPLOADS

WCUF

ORDER DETAIL PAGE UPLOAD

WCUF

EXTRA FEE PER UPLOAD


FRONTEND PROGRESS BAR & DELETE FILE PROCESS

WCUF
WCUF

UPLOADS COUNTER

WCUF

BULK UPLOADS DELETE

WCUF

INPUT TEXT FIELD ON ORDER DETAILS PAGE

WCUF

EMAIL NOTIFICATION

WCUF

CHANGE LOG

= 42.4 - 08.11.18 =
* Improved the activation process

= 42.3 - 07.11.18 =
* Minor bugfix

= 42.2 - 07.11.18 =
* Fixed a minor issue related to the mandatory option

= 42.1 - 03.11.18 =
* Minor bugfix

= 42.0 - 31.10.18 =
* Fixed an issue with file names

= 41.9 - 31.10.18 =
* Minor bugfix on Email component

= 41.8 - 30.10.18 =
* Typo

= 41.7 - 29.10.18 =
* Fixed an issue related to email attachments

= 41.6 - 28.10.18 =
* Minor bugfix

= 41.5 - 25.10.18 =
* Improved Popup display managment

= 41.4 - 18.10.18 =
* Minor bugfix

= 41.3 - 18.10.18 =
* Upload progress bar has rounded borders

= 41.2 - 12.10.18 =
* Typo

= 41.1 - 09.10.18 =
* Minor UI fix

= 41.0 - 09.10.18 =
* Added feedback text to the file preview showed in the emails

= 40.9 - 09.10.18 =
* Added option to show feedback text on summary boxes

= 40.8 - 08.10.18 =
* UI improvements

= 40.7 - 08.10.18 =
* Improved "add to cart" button display managment when switching variation 

= 40.6 - 07.10.18 =
* Fixed an issue due to for some browser file selection could not work after accepting the disclaimer

= 40.5 - 04.10.18 =
* Added new option to display "Totals info displayer" area. It reports the total number of uploaded files and extra costs in product pages 
  and in the summary box area.

= 40.4 - 03.10.18 =
* Backend UI Improvements

= 40.3 - 02.10.18 =
* Fixed an issue with product quantity selector

= 40.2 - 02.10.18 =
* Fixed an issue with product quantity selector

= 40.1 - 01.10.18 =
* Typo

= 40.0 - 27.09.18 =
* Fixed some issues with multiple file crop controller 
* Now in case of image size restriction, images are automatically removed from the files to upload list

= 39.9 - 25.09.18 =
* Typo

= 39.8 - 25.09.18 =
* Fixed an issue that may prevent the proper plugin activation

= 39.7 - 25.09.18 =
* Fixed an issue that may prevent the proper plugin activation

= 39.6 - 25.09.18 =
* Added new activation system: now the plugin can be only activated in two domains and they cannot be unregistered

= 39.5 - 13.09.18 =
* Minor bugfix

= 39.4 - 13.09.18 =
* Crop feature is now available also for multiple files upload field

= 39.3 - 11.09.18 =
* Added a new option to attach uploaded files to "New order" emails sent to the admin

= 39.2 - 10.09.18 =
* Fixed an issue with WPML due to uploaded image previews were not showed in the product cart table

= 39.1 - 30.08.18 =
* Minor bugfix

= 39.0 - 28.08.18 =
* Minor js improvement

= 38.9 - 27.08.18 =
* Minor UX improvement for mandatory fields

= 38.8 - 26.08.18 =
* Minor bugfix relative to some mobile browsers

= 38.7 - 22.08.18 =
* Improved the add to cart UI managment

= 38.6 - 20.08.18 =
* Fixed an issue related to the "sold same product multiple time" and variable product

= 38.5 - 18.08.18 =
* Fixed a minor issue due a warning text was showed for a moment on page loading

= 38.4 - 15.08.18 =
* Fixed an issue relative to the price display in the upload field shortcode

= 38.3 - 10.08.18 =
* Minor bugfix

= 38.2 - 08.08.18 =
* Minor bugfix

= 38.1 - 25.07.18 =
* Minor bugfix

= 38.0 - 21.07.18 =
* Fixed an issue that prevented the upload fields to be properly showed in the Thank you and Order details pages

= 37.9 - 19.07.18 =
* Minor bugfix relative to the custom texts

= 37.8 - 19.07.18 =
* Updated internal libraries

= 37.7 - 16.07.18 =
* Added some CSS classes
* Updated internal libraries

= 37.6 - 16.07.18 =
* Added new customizable texts

= 37.5 - 12.07.18 =
* Fixed an issue that may prevent the plugin to properly activate

= 37.4 - 12.07.18 =
* Fixed an issue with file preview on email

= 37.3 - 10.07.18 =
* Fixed an issue due to on cart if product quantity was updated the upload area was showed no more

= 37.2 - 09.07.18 =
* Fixed an issue due to on variable product page the upload area was not showed

= 37.1 - 09.07.18 =
* UI improvement: on product page the add to cart area is now hidden while an upload is performed

= 37.0 - 30.06.18 =
* CSS improvement

[...]

by
by
by
by
by
by