SWISH/PHP EMAIL FORM from www.SWISH-TUTORIALS.com - INSTRUCTIONS FOR USE

IMPORTANT INFORMATION | CUSTOMIZING THE BACKGROUND FIELDS | SETTING UP THE BUTTONS | CUSTOMIZING THE PHP SCRIPT | NOTES | CONTACT AND CREDITS

* IMPORTANT *

1. Do NOT change the names of the sprites named "mail_form" and "form" - or else the email form will not work.

2. Your web host ABOSULTELY MUST have PHP support

3. You ABSOLUTELY MUST upload the included PHP script and SWF files ("st_emailform.swf", "st_emailformPHP.php", "mailform_submit_button.swf", and "mailform_reset_button.swf") SWF file to the same directory as your main movie and HTML page.

4. The Labels in the provided template file are VERY IMPORTANT ... The buttons rely on these labels, and the form relies on them as well.

5. The background fields are already perfectly lined up in the provided template file -- if you move things around, the input fields will no longer line up. You should only change the colors and outline for the background items, and the font for the text items.

7. The sprite titled "thankyou_message" - is completely optional ... When the user has filled out the form (completely), the main sprite "mail_form" will be sent to the label "success" ... Using this method, you can remove the input fields and display a "Thank You" message to the viewer. You can delete this sprite entirely if you wish.

* Customizing the Background Fields *

1. Open the SWI file

2. Select the Sprite "mail_form" .... Copy it ... then Paste it into your own movie

3. Click on the (+) next to the "mail_form" sprite -- then you can enter the other "customizable" sprites and edit the colors and text.

4. The customizable backgrounds are already lined up and sized perfectly -- it is highly recommended that you DO NOT reposition those objects - or else the loaded mail form's input fields will no longer line up correctly.

5. You can add animations to the customizable areas - just as long as they end up in their original starting positions.

6. You can control when the mail form is displayed by adding PLACE and REMOVE effects for the sprite "mail_form" within the guestbook sprite ... You can add actions to the "guestbook" sprite to handle this control.

7. You can change the input field and status text color of the email form by changing the settings for the PLACE effect on the sprite "form" (which is inside the sprite "mail_form") ... Double-Click on the PLACE effect and change the color in the settings - this will change the color of the loaded email form.

8. READ THE *IMPORTANT* STEPS AT THE TOP OF THIS DOCUMENT :-)

* Setting up the Reset and Submit Buttons *

1. Open the .SWI file and go into the "mail_form" sprite.

2. You will see a sprite for each button: "submit_button", and "reset_button"

3. Inside those sprites are loader sprites - these sprites contain the Load Movie action which loads the actual button (created in Flash 5) ... The Flash 5 buttons are invisible and completely resizable. The loaded button controls the animation in your SWiSH file. When the mouse rolls over the button, it sends the button sprites to the label "rollover" ... When the mouse rolls off the button, it sends the button sprites to the label "rollout". You can customize your button animations using those labels.

4. The buttons also control the Error Messages ... If the Name field is not filled out - the button sends the sprite "error_messages" to the label "no_name" ... If the Email field is not filled out (or filled out incorrectly), it sends the error sprite to the label "no_email" ... If the Message field is not filled out, it sends the error sprite to the label "no_message" ... When the Reset button is pressed, it also sends the error_messages sprite to the label "start" ... This will give you the ability to completely customize each message displayed (so, you will be able to change the text to anything you want - including changing the language the message is in).

5. THE IMPORTANT STEP is resizing the loaded button. Open the button sprites - click once on the PLACE effect for the loader sprite - then turn on Preview Frame mode (in the View menu) ... This will place red handles around the loader sprites. You need to resize that sprite to cover your button shape or text. Here is an illustration :

6. After resizing the loader sprite ... You can place the "reset_button" sprite and the "submit_button" sprite anywhere you want.

7. Be sure to upload the two included files : "mailform_reset_button.swf" and "mailform_submit_button.swf" to the same directory as your SWF and HTML files.


* Customizing the PHP Script *

1. Open the included PHP file (st_mailform_script.php) with your favorite text editor (eg. Windows Notepad)

2. There are two main areas that you will need to customize :

// Start Customizable Email Information
// Change the information in quotes below to fit your needs

$rec_email = "brian@house6.com"; // who do you want to send this email to
$subject = "Test Messages from Swish PHP Email Form v2"; // this is the subject line of the email

// End Customizable Email Information


 

 

 


3. The name of this PHP file CANNOT be changed - or else the mail form will not work properly.

4. If you do not want the email to be censored from strong language - remove the section of the PHP script from "// Begin Censors" to "// End Censors".

5. After your modifications, save the PHP file - and be sure to upload it to the same directory as your HTML page (along with the included "st_emailform_v2.swf" and button SWF files).


* NOTES *

The customizable areas are clearly labeled - each object is labeled with the same name as the area in the loaded Email Form that it corresponds with (eg. email_background is where the user types in their email address; message_background is the area where the viewer types in their message/comments; etc.).


* CONTACT & CREDITS *

For help questions - please post in the General Swish Help Forum : HERE


Swish/PHP Email Form was created by Brian Ayers of Swish-Tutorials.com
Unless a Donation is made for these form files - the copyrights should remain intact
Contact info : admin@swish-tutorials.com (help questions will not be answered via email - please post in the Help Forum as linked above - thank you!)

Redistribution of these files is strictly prohibited ... Webmasters - please link to the main site rather than the download itself - thank you kindly :)


Cheers !
Brian Ayers