Form Wizard Tutorial

navaldesign · #1 05-08-2008, 06:14 PM

Please also read carefully the TEXT below this video!

The major enhancement in the new Form wizard, which also applies to all BlueVoda forms independently from the way they have been built, is the Built In Form Processor. This form processor eliminates the need to copy / paste php code and manually create a processing page. The processing script is automatically embedded in your own form page, and it will process your form info correctly. It takes down to practically zero copy / paste mistakes that have caused lots of frustration to many users.
This script has been created with the contribution of DBTechnosystems and has the following enhancements, in comparison to the one used in the BV forms up to this moment:

1. It will automatically take care of file uploads
2. It will take care of Multiple choice Listboxes / Comboboxes
3. It will detect injection attempts and deny processing
4. It will report these errors if found
5. It allows you to specify the Upload folder and the max filesize
6. It will add a random prefix to the file uploaded, to avoid hackers uploading and running malicious files

Please note that these are essential features, for a more complete script that will provide much more both in terms of security and in terms of features, please visit the Advanced BlueVoda Form Processor thread.

Creating an Error page

The new BV 10.1 built in form processor was developed by DB Technosystems.com. We have now embedded a simple error reporting system. To be able to report the errors, you need to correctly build an error page.

As we have designed the script, this is an extremely easy task: Create a page as you normally would. Leave some free space for the text of the error message. Then, place in your page the following simple text: ##error##
As you see it in the following example:

If an error is found in your form, the error page will show up. The text ##error## will be replaced by the actual error message. You can format the text as you like (Font type, size, color and position, alignment etc) . Make sure to make it LARGE enough (as you can see above) so that there is enough space for it.

Now, insert an ADVANCED button in your page. Double click it, Make it OnClick, and select onClick action: Go to the Previous Page. This button will enable your visitor to go back in your form and edit his input before submitting again.

Multiple Choice Listboxes / Comboboxes

Some times you need such fields. In Addition, there are some tomes that even checkboxes for the SAME choice, need to have multiple answers (values).

In order for the built in processor to correctly process these fields, there is only one requirement: the file names of these multiple choice fields MUST have at the end, [] (square brackets). In example, a field "How did you find us" should be "How did you find us[]" in order for the processor to be able to correctly process it. Of course, you also need to check the "Allow Multiple Selections" checkbox in the field Properties dialog box.

Uploading files.

The new processor allows you to upload files. Normally, the default settings allow a maximum filesize of 1 Mb and the files will be uploaded in a subfolder that is AUTOMATICALLY created, which is named "uploads".

However, it is possible to change the folder name as described in the following steps.

You may also want to change the default maximum filesize, from 1 Mb (1024 Kb) to a lower or higher number.

BOTH these tasks are achieved through HIDDEN FIELDS.

Double click your form, and in the lower part, in the Hidden Fields section, add these two fields:

filesize (all lowercase) and upload_folder (all lowercase).

The filesize MUST be typed in Kbytes.

Please look at the example picture here below:

Important Notes!

1. There are some limitations to the field naming: the visitor's email address field, MUST be named "email", all lowercase, exactly as you see it, so that the script will correctly recognize it. Otherwise, the sender's email address will default to your own email address. This is done because many ISPs will block emails if no sender email address is included in the mail.
2. Your Submit button name MUST be "submit", and your "reset" button MUST be named "reset". If you name them anything else, you will recieve those values in the mail along with the others.
3. Please note that when you use the built in form processor, the page NEEDS to be published as php instead of html. If you have created the form from scratch with the wizard, this is done automatically. So, if your page is named "contact", it will be published as "contact.php". So this is what you should include in your menu bars as link to the contact page.

Troubleshooting: If after publishing yout form page, you see lots of code on top of the page, don't worry, it is simple: you have published your page as html instead of php.

Have fun!

VodaHost · #2 06-02-2008, 06:17 PM

Please make sure that you watch all three form tutorials...They will give you a complete understanding of how to build and publish a form.

How to create a form from scratch - tutorial #2
How to create a form from scratch using the form wizard.

How to edit a form - tutorial #3
How to edit a form. Covers adding and removing fields to your form such as text boxes, drop down boxes, radio buttons, etc...

JCinNJ · #3 06-06-2008, 05:13 AM

I have watched all 3 tutorials time and time again.

I have read your posts about contact & success page issues

email does not work

I have sent in asking for help but no reply after an hour

My business is suffering because of this and I need to get it running properly.

navaldesign · #4 06-06-2008, 06:14 AM

Please provide a link to your form as well as your thank you and error pages. Without seeing anything, we can't really help you.

Phoenixc · #5 06-08-2008, 02:44 AM

Hi

I set up my application form on my site and all the links work etc, however i tried a few test forms to the email address I used in the set up and I have not received any of them. I checked if the email address i used is wrong but it is fine, when I clicked on the submit button it goes to my thank you page no problems. Any ideas why I am not receiving my forums via email? my site is on www.cbargames.com the application form link is on the top right of the Homepage

regards,

Ciaran

cloh · #6 06-08-2008, 11:08 AM

Hi,
My BlueVoda software does not have the Form Wizard icon. I can see all Form Fields icon, but not the Form Wizard icon. Please advice how to set up this icon. Thanks.
rgds, Loh

navaldesign · #7 06-08-2008, 11:14 AM

Simply download the latest version from http://www.vodasupport.com/index.php...wnloaditemid=1

Phoenixc · #8 06-08-2008, 06:38 PM

Hi

Any idea on how to fix my problem above?

navaldesign · #9 06-08-2008, 09:32 PM

If you are being redirected to the thank you page, it should (i believe) be a problem with the mail being blocked by your ISP or a wrong email address typed in the wizard

Phoenixc · #10 06-09-2008, 11:54 AM

Hi Naval

It is still not working. Im baffled. my application form published as a php. but none of my test forms are being delivered

Phoenixc · #11 06-09-2008, 11:57 AM

I think I will just create it again, I made an error page also but not sure if it affects the form in any way?

frogger6 · #12 06-30-2008, 09:18 AM

I'm having a slight problem:
form is for visitors to send in pictures. I'm getting emails with all the info except the uploaded pics. I used the wizard, so I didn't think I needed to set anything for the uploads.

When I fill out the form myself to test it, I get the success page too fast for the file to be atatching to the email.

navaldesign · #13 06-30-2008, 11:17 AM

The scrip used will not attach the files to the email. It will, however, send you a link with the full path to the upload file. So you either download it with FTP or, in the case of an image, you can click on the link and view the image on your browser, (and from there use Save As to save it on your own computer).

Do you rcieve the path to the uploaded file ?

Can you please provide a link to your form page ?

frogger6 · #14 07-01-2008, 05:58 AM

oh okay, but.... no there was/is no url link in the emails I received.

Here is the page the form is on: http://www.goatofthegame.com/cartoon2.php

thanks for your help!

navaldesign · #15 07-01-2008, 11:08 AM

Your upload field is unnamed! No name means that the script can not save/upload the file and send you the link

Name it anything: Image, file, fileupload, whatever you wish.

frogger6 · #16 07-02-2008, 08:55 AM

isn't my upload field named "upload pic"?
or are you talking about something else?

I tried it again thinking maybe before I didn't have "upload pic" in there, but it still doesn't work. I get the email, but it says this, and this only:

Values submitted from web site form:
Name : shh
Email : toomanyfroggers********.com
Action : Throws R - Pitcher
Body Type : Male - Thin
Comments : yeah
Button1 : submit

thanks for your continued help!

frogger6 · #17 07-02-2008, 09:03 AM

okay..think i figured out what you mean. I did a test form (started from scratch using the template) and saw the name field. I sent myself an email and got the file location on my computer. I'll have to wait and see how that works coming from somone else's computer though.

thanks

navaldesign · #18 07-02-2008, 10:01 AM

As you have seen yourself, the field was unnamed. The label (that is, the text you put beside the field) is not important.

You should also rename your submit button, and name it "submit" (the value is already "submit" but i am talking aboutthe name)