Customize error messages for upload form fields

Tutorial created by Ray Borduin, WebAssist

Categories: Data Bridge, Dreamweaver, PHP

2 ratings | Sign in to rate this tutorial | View comments

next section

What do you need to start?

1. Dreamweaver CS4 or higher.
   
2. Site defined in Dreamweaver - Watch video tutorial: Setting up a site in Dreamweaver.
   
3. Data Bridge (alternately, Digital File Pro) installed and activated in Dreamweaver.
   
4. PHP page containing digital file upload capability. For assistance, view this tutorial: Apply file upload or download.

next section

Add error messages

Digital File Pro displays error messages that are useful whether you wish to provide user friendly alerts after uploads fail or to show error messages for debugging your upload functionality.

1. Open the PHP page that contains your Digital File Pro upload behavior.
   
   
2. Open the Bindings panel from Window > Bindings.
   
   
3. Locate the binding that relates to your upload behavior, Upload Files.
   
   
   
   
   
4. In this example, the FileField name was named uploadFile when the form was previously applied to the page.
   
   
   
   
   
5. Expand this entry to reveal the various bindings that are available.
   
   
   
   
   
   Digital File Pro includes a number of bindings that you can add to your page in this location. This document focuses on the Error Message option.
   
   
6. Click and drag the Error Message binding to a location on your page that you would like the error message to display.
   
   
   
   
   
7. Once inserted, a snippet of PHP will be added to your page.
   
   
   

Customize error message binding

Depending on the error that occurs, the binding that you have added to your page will display an error message. Each error message can be customized by modifying the code. In addition, each error message has its own number that needs locating in order to create the custom code.

Locate the error codes:

1. From the Dreamweaver Files panel, in the webassist folder, expand the file manipulation folder, and double-click to open helperphp.php.
   
   
   
   
   
2. In the helperphp.php file, scroll down to locate the following line of code.
   
   
   
   
   
3. From this list, locate the code for the error message you want to customize. In this example, we are going to show customizing the code that will display if the upload was successful (code = 1).
   
   
   

Customize the error messages:

1. Return to your PHP page.
   
   
2. Select the PHP binding that you added to your page previously.
   
   
3. Choose the Split button to enter Design and Code view.
   
   
   
   
   
4. In Code view, notice the following line of code.
   
   

   <?php echo $WA_DFP_UploadStatus["WA_UploadResult1"]["errorMessage"]; ?>

   
   
5. In this line of code, replace echo with if (. Change errorMessage to statusCode as shown in the following line of code.
   
   

   <?php if ($WA_DFP_UploadStatus["WA_UploadResult1"]["statusCode"]; ?>

   
   
   
6. Replace ; ?> with == 1) { ?>Upload successful!<?php } ?> as shown in the following line of code.
   
   

   <?php if ($WA_DFP_UploadStatus["WA_UploadResult1"]["statusCode"] == 1) { ?>Upload successful!
     <?php } ?>

   
   
7. Your final code for this error message should appear as follows.
   
   
   

Now whenever a file is uploaded successfully, Upload successful! will display on your page.

Reviews and comments

Comments will be sent to the author of this tutorial and may not be answered immediately. For general help from WebAssist, please visit technical support.

2 ratings | Sign in to rate this tutorial