Glossary Item Box

Squirrelcart v6.1.0

File Upload Options

Security

Incredibly Important!

Files uploaded by your customers are stored in your sc_data/customer_uploads folder. It is highly recommended that you place your sc_data folder in a location that is not web accessible. You can find out how to do this in the topic "Security > sc_data directory". If this is not done, you are open to potential hacking attempts. If you cannot put your sc_data folder in a secure location, we recommend that you do not make use of this feature!

 

Overview

File Upload options allow your customers to associate one or more image files with a product. This can be used to accept customer provided images for items such as t-shirts, brochures, etc...

Adding a File Upload Option

Follow the instructions below to add a file upload option.

Step 1 - Create the Option

  1. Click the Options menu link
  2. Click . You will see a form like this:

  3. Click to EnlargeClick to Enlarge
  4. Enter a name for the option in the Name field. For this example, enter Your Image.
  5. Set the Type field to File Upload 
  6. If you want to require the customer to upload a file for this option before being allowed to purchase, check the Required field.
  7. By default, the name of the option is shown before the select field as an instruction to the customer. If you would like to use something other than the name of the option as the instruction, enter it in the Instruction field.
  8. If you want the detail page links to appear, check the Detail Page field. This feature is explained in the Detail Page topic.
  9. A File Upload Settings field section will appear, which looks like this:


    These settings only affect this file upload. The fields are defined as follows:

    Allowed File Types: This controls the file types that the customer will be allowed to upload. You can add additional file types by following the instructions in the File Types topic.

    Max File Size: This is the maximum file size that the customer will be able to upload. If your customer's receive errors when trying to upload files that are smaller than this size, it may be due to server based restricions imposed by your web host that we have no control over. If you suspect that is the case, contact your web host for assistance.

    Restrict Image Dims: If the file being uploaded is an image, this setting can be used to restrict the dimensions of the image provided by the customer.
  10. Check the boxes next to the file types you wish to allow for this option
  11. If needed, adjust the Max File Size field.
  12. You can optionally associate a price and weight with a file upload option. When this is done, the price and weight are not added to the total unless the customer uploads a file using the file upload field. This is useful for when you want to charge a fee ONLY when the customer adds their own file to a product. If you wish to add a price or weight for this option, due so in the Price and Weight section seen below:



    The price and weight set here becomes the default whenever you assign this option to a product. It can be overridden on a per product (or category) basis. See the Overriding Option/Choice Defaults topic for details.
  13. Click Save Changes

Step 2 - Assign Option to a Product

The last step is to assign the option to a product. Because this step is the same for all product option types, we've explained it separately in the Assigning to a Product topic.

Adding Additional File Types

You can add additional file types by following the instructions in the File Types topic

Downloading Files for an Order

After a customer has placed an order that includes an uploaded file, you can obtain that file in 3 ways:

Method 1 - as Attachments to the Order Notification Email

When a user places an order, you will receive an automatic email notifying you of the order. By default, files uploaded by users will be delivered as attachments to that email, if the total size of those attachments does not exceed 10 MB.

To adjust the settings for this feature:

  1. View your automatic email settings:
  2. Open the record named Order - Notification to Staff
  3. In the Message Details fieldset, you will find these settings:


    To disable or enable this feature, uncheck or check the Attach Customer Uploads field.

    Use the Total Size Limit to control the total allowed size for all customer uploaded attachments. If this size is exceeded, the files will not be included as attachments but can still be downloaded using one of the other methods listed below.
  4. Click Save Changes

Method 2 - via a Browser

  1. Open the order in your control panel in invoice mode, or open the HTML formatted order email sent to you.
  2. Click the link(s) that appear below each product:
  3. Save the file

Method 3 - via FTP

  1. Connect to your website using your FTP client
  2. Navigate to your sc_data folder
  3. Inside that folder you will see a folder named customer_uploads. Open that folder.
  4. Open the folder corresponding to the customer's order number
  5. Download the file(s) to your computer

File Cleanup

Files uploaded by your customer are not automatically deleted. If disk space is an issue for you, you may delete files uploaded by your customer after you have downloaded them using FTP. The recommend way to do this is to delete the entire folder corresponding to their order number inside your sc_data/customer_uploads folder.

Do NOT delete the customer_uploads folder inside your sc_data folder. Doing so will cause your customer's uploads to fail.

 

 


© 2001-2017 Lighthouse Development. All Rights Reserved.