Installation and User Manual
Contents
1. Text Import Wizard Step 2 of 3 px This screen lets you set the delimiters your data contains You can see how your text is affected in the preview below elimiters IV Tab I Semicolon I Comma I Space M Other fi I Treat consecutive delimiters as one Text qualifier I z ata preview 02 08 44 BZ 66 188 129 p20 224 41 47 Krutika 2 12 05 44 82618810 1 9 06 59 220 224 41 47 Krutika krutika borikar infosys kkeindi 44 Ambazari Layout Nagpu Ve Mail v 3 Store Data in MySQL Database Kmita Mail v 3 can store form data directly into your MySQL database This may be helpful in storing email addresses across multiple tables in database saving you your valuable time Setting Up your MySQL database Login to your MySQL database In case have not created database before or in case you need to build a new one create a database in MySQL A tool like PHPMyAdmin would be helpful and is generally provided by all the webhosts these days MySQL Create new database Languag Theme p Show MySQL runtime kl E phpmya Show MySQL system variables Show PH ow processes 4 Official p St Engi 89 Storage Engines Ghanas I gt Reload MySQL Official phpMy 8 Privileges Databases 4 Event Create a table in the database Specify the number of fields that are to be inserted in the MySQL No tables found In database Create new table on2. setting action Conditional Form Submission There are cases when you need to send email to different people through same form depending upon the selection made by the visitor For example in a contact form you can have a drop down menu which asks the visitor to specify the recipient or if you want to create a form which has conditional data handling likeproviding details for Product 1 Product 2 Product 3 Product 4 or Marketing Sales Finance Purchase or send email to any one Allen Jim Thomas Peter There can be n number of such applications and it for you to decide how you can use it As you know formname field tells Kmita Mail which form to execute lt input type hidden name formname value contactus php gt So if you want Kmita Mail v 3 to submit data to different email addresses according to formname selected You are not required to make different HTML forms for each There are two options Either have 1 Radio Buttons or 2 Drop Down Menu Step 1 Run Form setup for as many options you want to create This gives you the option of giving different Success Page Autoresponder Data file etc for each form No generalised autoresponder E g For support you can provide by what time you can provide support and also provide instructions and Marketing or Sales you can provide where to contact your marketing people and bit of thank you text with flowery language Copy the
3. Then Put the field names enclosed in name of the field separated by commas customers exact name of the field exact name of the next field exact name of the next field AA Chapter 6 Building an HTML Form Essentials in HTML Form To get the basic HTML code required to be included in the HTML form goto Administration Home gt Kmita Mail List of Forms Click HTML Code infront of the name of the name of the form you are setting up min Change P inistrati ome gt Kmita Mail List of Forms Find the list of all the form pro ing setups below You can edit the form processing settings and delete To create a new Form Click here Filename 4 File Size Actions 2 371 KB HTML Code Change Se KKE Info Media 2006 You can download the HTML code and paste it into your HTML editor Enter name for your form For Ex if you are making a contact form you can type the name as Image Challenge Enabled Uploads Disabled Form Name contactO php HTML Code Build your form using this code lt form action Email Mail v 3 Kite Changing an Existing Form If you already have a form you need to modify your form by adding and modifying the following fields Form Tag Form tag specifies method of send data from your HTML form to Kmita Mail The action in the form tag specifies the location of Kmita Mail E g lt form action kmitam
4. 00 ccccccccssssecseeeeeeeessssseeaseeeeeeeseseeseeaaaeeeeeeeseseess 16 Editing a Form Configuration rrrrrsrrsnnnvrrrrrnrrrnnrrrrnnnnnnvnnnrrnnrrnrnnnnnnnvnnrrrnrrrnrnnnnnnnnnnnen 18 Basic Kmita Mail v 3 Features ymug immemnnunanemneintetevumsinsantadnenkned 20 Customizing your Form Data Email and Subject ornnrnnnrnnnrrrnnrrnnrrnnrrnnnnrnnnrrnnnnnnnn 21 Customizing your Autoresponder Email and Subject orrnnnnnnrnnrrnnrrnnnnrnnrrnnnnnnrnn 23 Data storage in Text File ornrrrnnnnnnnonnoonnnnrrrnnnnnnornnnnnnnnrrnnnnnnnvnnnrnnnnnnnnnnnnsnnnssennnnnrnnnnnnn 25 Import Datafile in MS Excel MS ACCESS rmnrrrnnnnnnnnrnnrrnnrrnnnnnnnnrnnnnnnnrnnnnnnnnrrnnnnnnrtnnnn 26 Store Data in MySQL Database morsnnnnnnnnnrnnnnnnnnnnrnnnnrnnnnrn nn nnnrn norr nnnrnnnnnnrnnnnrnnnnnnnn 28 Building an HTML Form sissicicceciccscvstieessseciescieacnsecswensatinsninnocccesasvacdeontecmnesacnne 31 Essentials in HTML Form rnnvrnnnnnnnnonnnnnnnvrnnnnnnnvnnnnrnnnnnvnnnnnnnernnnrnnnnvrrnnnnnennssrennnnrrnennnen 32 Changing an Existing Form orrnnnrnonnrrnnnrnnrrnnrnnrnnnnnnrnnnnnnrnn nn nnnnnrnnnnnnnrnnnnnnnnrrnnnnnnen nn 34 Field Names Formatting Without Form Validation oreronornnrrnnrnnrrrnrnrrnnrnnnrnnnnn 36 Field Names Formatting With Form Validation c ccceesecceeeeeeceeeeeeeeteeeetees 37 Changing SMTP Settings seins ccssciiecisisscsiinacesenissiecnsncssacs
5. Number 1 means that you grant execute rights number 2 means that you make the file writeable number 4 means that you make the file readable Add up these numbers to specify needed rights You can also read more about modes on UNIX systems with man 1 chmod and man 2 chmod Set these settings using some FTP Client like WS_FTP ACE FTP Cute FTP to name a few The following steps are mostly common for all FTP clients 1 Right click the folder kmita 2 A menu pops up Select CHMOD or Set File Permissions 3 A new Dialogue box appears Set CHMOD 777 Owner Read Write Execute Group Read Write Execute Public Read Write Execute 4 and That s Done You can also do the same at UNIX command prompt FTP File Transfer Protocol This is the language used for file transfer from computer to computer across the WWW An anonymous FTP is a file transfer between locations that does not require users to identify themselves with a password or log in An anonymous FTP is not secure because it can be accessed by any other user of the WWW
6. 55 PM 2 login php 118 PHPSc 4 26 2 44 PM login temp html 97 HTML 4 26 2 44 PM 2 login1 php 695 PHP Sc 4 26 2 4 PM 2 logout php 1 397 PHP Sc 4 2672 44 PM 2 php php 351 PHPSc 4 26 72 44 PM 2 smtp php 362 PHPSc 4 26 2 1 30 AM a smtp_settings php 5 994 PHP Sc 4 26 2 You can reduce the permissions once Kmita Mail v 3 is installed Mail v 3 Entering License Information Now that you have uploaded and set permissions you now need to Open your browser window Enter http www yourwebsite com kmitaadmin to get page like this Kmita Website Administration enter your Administration Username and Password admin Login KKE Info Media 2006 Enter your username and password which are set as admin and admin respectively You can change the password once you login into Kmita Admin Change ListofForms Banned IP Addresses SMTP Settings License Management Change _ Check Save License Goto http login kkeim com Using your username and password sent to you login into your account and create your Kmita Mail v 3 Key Mail v 3 Enter the key in the field shown in the figure above and press Save License If you get several PHP warnings after saving the password there is a problem with the Permissions provided to kmitaadmin kmitam php Please see Setting Folder P
7. Error The security image value didnot match I Chapter 7 Changing SMTP Settings By default Kmita Mail v 3 uses PHP s mail function If your webhosthas disabled the mail function you can use your SMTP server to send the emails To view the settings go to Home gt SMTP Settings In the admin panel Admin Change Use SMTP Server or no Save Settings KKE Info Media 200 To enable sending emails through SMTP server Click on Yes Admin Change Home gt SMTP Settings Use SMTP Server Q ne O No res vo SMTP Host R Does your SMTP Server require authetication O ves no SMTP Username SMTP Password Save Settings Fill the required details in the form and press Save Settings EA dmin SMTP Host Does your SMTP Server require authetication SMTP Username SMTP P rd yes oO No kkeinda cam Yes Oo No kke password R Chapter 8 Advanced Kmita Mail Features Multi page forms using Kmita Mail v 3 Multi page forms are an easy way of splitting up large form into number of number of forms spread over number of pages Visitors on internet do not like to fill forms especially the forms which run for several screens Multi page forms can help you by tempting your customer to fill very few fields on first page and then asking more information on the foll
8. ad dmin tings Data Email Autoresponder Data Storage Form Validation Upload Settings Yes DATE TIME IP rn_Name re_ Email km_Address UNIQUEID O No ministration Home gt Kmita Mail List of Forms Edit Form contactO0 php making changes click Change Pass You can use the following code to add IP address date and Time in your datafile results Value Code IP IP Date DATE Time TIME Unique ID UNIQUEID Mail v 3 Import Datafile in MS Excel MS Access 1 Download the datafile from your server The file is stored in kmitaadmin kmitam data If your form configuration file name is contact0 php then the name of your datafile will be contact0 dat 2 Download the file to your desktop and import the file using import options of the softwares Importing of data into MS Excel is shown below Text Import Wizard Step 1 of 3 20x gg The Text Wizard has determined that your data is Fixed Width rp If this is correct choose Next or choose the data type that best describes your data riginal data type dia Choose the file type that best describes your data F o H Characters such as commas or tabs separate each field ika an i x L C Fixed width Fields are aligned in columns with spaces between each field Start import at row fi File origin ms Dos PC 8 Preview of file CAWINDOWSI Desktop abc data Mail v 3
9. page using exact name of the field e g If the code below is put on the success page Name rn_Namel Address re_Address The success page will appear as Name John Address j peterQemail com Blocking IP addresses Click on Banned IP Addresses in the menu as shown below mi Kmita Mail Administration List of Forms Banned IP Addresses SMTP Settings In License Management Change Version 3 0 Add the IP addresses you wish to block Separate each IP address using a comma break Enter key tong Administration Home gt Kmita Mail Banned IP List You can restrict form subr ons from the following IP addresses by writing each IP address on new line 192 168 0 7 1202 221 2 23 1202 221 2 100 Change I Separate different IP addressd Once you have entered the list press Save or a line Changing the Kmita Admin Language In Kmita Admin the language of the complete Admin Panel can be changed Just copy the lanuguage file from the Language Files directory in kmitaadmin directory and save it in kmitaadmin directory Now find and delete the earlier admin lang php Rename the file you copied from Language Files as admin lang php Currently the language files are available in English Spanish French Chapter 9 Glossary BCC BCC is an abbreviation for blind carbon copy If you add a recipient s name to t
10. submit php method post gt Hidden input tag formname The formname input tag tells Kmita Mail which form to execute Kmita Mail then opens the form configuration and then sends data to the email addresses in To CC and BCC sends Auto responder to visitor and sends the visitor to Success Page etc E g lt input type hidden name formname value contact1 php gt Input tag Email This is mandatory tag if the auto responder is to be sent You can place this tag wherever you wish to have your visitor s email address Eg lt input type text name re Email gt How to put the code in the existing form 1 You get the form action as the first part of the code This code is to be placed in the starting of the form before the form fields begin lt form method post action kmitam submit php enctype multipart form data gt lt input name kk_Name type text id r_Name gt name Email lt input type text name re_Email gt The extra code enctype multipart form data is added in the form tag if the form is a Upload form Mail v 3 Mail v 3 2 The second field is a hidden formname tag which carries the name of the configuration file This can be placed anywhere inside the form Preferably just below the form tag lt form method post action http website com kmita submit php go 1 enctype multipart form data gt lt input type hidden name formname value 3 php gt lt input name kk Name typ
11. File Folder 12 07 10 18 fe kmitaadmin File Folder 4 3 0712 44 Eten File Folder 007 11 5 O shashank File Folder 07 12 44 E htaccess 359 HTACC 07 12 44 _vti_inf html 1 754 HTML 07 1 14F eror htm 9 HTML lnz 12 44 ME SE 2070 pupe Caution The files have to be in the HTML root of the website else Kmita Admin and Kmita Mail will not work Mail v 3 Setting Folder Permissions Kmita Mail creates files and folders on your server and requires read write and execute permissions The following files and folders require CHMOD 777 File Folder Permission CHMOD kmitaadmin smtp php 777 kmitaadmin login php 777 kmitaadmin kmitam php 777 kmitaadmin login php 777 kmitaadmin kmitam data 777 kmitam temp 777 The image below shows the view of ACE FTP Right Click on the kmitaadmin folder and click properties Select all the checkboxes or type CHMOD value directly to 777 and click OK Size SKE 4 955 bytes ipu Modified Multiple Dates H 4 Name Attributes Owner Read Write Execute K a H Group Read M Write Execute 3 PM 2 admi Everyone V Read Write Execute 45 AM admi CHMOD Value 777 25 PM 2 admi 37 PM cha 1 18 AM func Apply 10 PM 2 inde 44 PM 7 2 kmitam php 127 PHPSc 4 26 2 18 AM lic temp html 91 HTML 4 26 2 44 PM license php 4348 PHP Sc 4 2672
12. L Text plain Thank you This is a simple text autoresponder This is the information filled by you in the form Email re Email Name rn Name Address km Address Date DATE The following is the server path of HTML root of your website G mail Mail v 3 The name of the field mentioned in the Autoresponder Email should be exactly the same Even the change in the case or capitalization takes place Kmita Mail v 3 will not work That is the value in the form field will not be substituted You can use the following code to add IP address date and Time in your form results Value Code IP IIP Date DATE Time TIME Unique ID UNIQUEID Data storage in Text File Mail v 3 Kmita Mail v 3 allows you to store the form details in a text file Kmita Mail v 3 separates each field by and includes all field values in inverted commas You can specify the field sequence in the Datafile Sequence textbox If you leave it empty Kmita Mail v 3 will save the details in the sequence they are sent are sent by the form 2004 2 13 02 05 44 82 66 188 129 India contactus1 php Submit 2004 2 12 19 06 59 220 224 41 47 Krutika krutika yahoo com 44 Ambazari Layout Nagpur Yes India If you need to specify the field sequence separate name of each field by DATE TIME IP rn Name re Email km Address UNIQUEID
13. Version 3 0 Installation and User Manual KKE RY p Zjinfo Imedia 44 Ambazari Layout Nagpur MH India 440033 Phone 91 712 223 7066 395 8918 Fax 91 712 223 5838 Email wecare Qkkeim com Website http www kkeim com Pad Mail v 3 Contents Using This Help umsmumnsnmsnnnsunenvvne b nd sne isse mei 3 Text Conventions sno sveket wehicdsadeiensut sasetegecsamadsdstadaaduaaedeteescamegsadetanecieatacedeateeancts 4 Special Messages n nnnananassdudenemsnaede bud udeabvisinhurnbadene 5 Locating Help suisse deig ee dende 6 About Kmita Mail v 3 uussauasemenesnnigienunnnamni nm dnevekdsddsnakEGdnanmddsneie 7 What s New in Kmita Mail v 37 ornnnrnnnrrrrrnnnnrrnnnnnnnnrrrnnnnnrnnrrrrnnnnrrnnnnnnnnnnrrnnnnrrrnnrrennnnee 8 Kmita Mail v 3 Requirements orrroronoonnnnrrrnnnnnornnnrnnnnnrrrnnnrnnnnnnvnnnnnnrnnnrnnnnnserennnannnnnnnen 9 Getting Ered ts Faas act cea dete achat ec eects EAEan AE Aa Aaaa AA AENEAN ana REEERE 10 Uploading to the Server c ccccecceeeceeeeeeceeeeeceeeeeeeeeaaeeeeeeaeaeeeeseeaeeeeeessseeeeessneeeees 11 Setting Folder Permissions ccccccccceceecceceeeeeceeeeeeeeeeseseaeeeeeeeeeeeeesesneeetesneeees 12 Entering License Information cccccccceeeceeeeeeeeeeeeeeeceaeeeeeecaeeeeeeeaeeeeeseneeeees 13 Creating and Editing Form ConfigurationsS rarnvvrnnnnnnnnnnnnvvnnnnnnnnnnnvvnnnnnnn 15 Creating a Form Configuration
14. ail Address and is required ne Fieldname ne Name Cannot be blank and should be valid text rn Fieldname rn Company Cannot be blank br Start End FieldName br 1 10 Qty The number filled should be between specified range nn Fieldname nn Phone The field should contain a number km fieldname km comments Field with no validation required 0 Eg email lt input type text name re Email gt lt select name km list size 4 multiple gt lt option value 1 gt hello lt option gt lt option value 2 gt go lt option gt lt option value 3 gt my baby lt option gt lt option value 4 gt good boy lt option gt lt select gt lt input type text name br 10 15 Number of Items gt Eg br 10 15 Number of Items In this field you need to put br initially followed by the first limit 10 of the range you want to the value to be between Then put the end limit 15_ followed by the name of the field You can change the validation text for each form in Form Validation Tab on the Edit form page Enable Form Validation O ves no Yalidation Error Messages Configuration Required field and an email address Cannot be blank and should be a valid acaress email address Only Text Cannot be blank and should be a valid email address Required field is required Between a number range should be between Should be a number should be a number Image Challenge
15. database testing Name Fields 7 Mail v 3 Put the fields that you want the form to insert in the Database Field Type Length Values Attributes Null Default Extra fame varenr mp Ee rots Jf CTC Phone Bent Hpo C i frotrut SPE fo Me A rot SIP fo fvarcraR SPE i frotrut IPE fvarcraR SE roto JE CTC varenr SPE Ee frotrut SPE rer H 1 Afonmlgf Table comments Table type I Dagens l Er ere rere After creating the table go to Administration Home gt Kmita Mail List of Forms gt Edit Form formname 0 php And select Data Storage Tab Put the exact sequence of the fields as they are in the table that you have created The sequence has to put in the following manner tablename exact name of the field exact name of the next field exact name of the next field MySQL Settings RE O ves No MySQL Username kmita MySQL Password EE HEISE localhost MySQL Database customer Insert Field Sequence eustomers rn_Name re_Email km_Address Firstly you need to mention the tablename followed by three vertical bars Then Put the field names enclosed in name of the field separated by commas Mail v 3 If you need to insert the data in more that one table you need to put the name of the tables separated by line Enter When the tablenames are written you need to put
16. e text id r Name gt name lt input type text name re Email gt 3 Third is the re Email field You can place this tag wherever you wish to have your visitor s email address 4 Insert this code where ever you wish to have the security CAPTCHA Image lt img src kmitam image php width 150 height 80 gt lt p gt Enter the characters shown in the above image 0 9 A F lt input name secnum type text id secnum gt lt p gt 5 Always ensure that the lt form gt tag which ends the form is present where the form fields end Eg lt form method post action kmitam submit php gt lt input type hidden name formname value 3 php gt lt input name kk_Name type text id r_Name gt name lt input type text name re_Email gt email lt select name km_list size 4 multiple gt lt option value 1 gt hello lt option gt lt option value 2 gt go lt option gt lt option value 3 gt my baby lt option gt lt option value 4 gt good boy lt option gt lt select gt lt p gt lt img src kmitam image php width 150 height 80 gt lt p gt lt p gt Enter the characters shown in the above image 0 9 A F lt input name secnum type text id secnum gt lt p gt lt input type submit name Submit value Submit gt lt form gt Field Names Formatting Without Form Validation You can choose any name for form tags except formname You can include _ underscore whic
17. ermissions Koil v 3 Chapter 4 Creating and Editing Form Configurations Creating a Form Configuration Em Kmita Mail Administration pes KN Banned TP Addresses SMTP Settings License Management Change Version 3 0 Mail v 3 Click on List of Forms to view the list of form configurations Since this is the first time you are opening this page you ll not see any form configuration file Click on To create a new form Click Here Admin Administration Home Kmita Mail List of Forms 1g setups below You Change can edit the form processing settings an Ent sles mydomain com ce N later File Name File Size Actions KKE Info Media 2006 i ain Change P Administration Home gt Kmita Mail List of Forms gt Add Form Enter name for your form For Ex if you are making a contact form you can type the name Name of the form at KKE Info Media 2006 Mail v 3 You ll need to fill some name for the form like contact feedback registration etc You also need to fill a primary email address for the form preferably the email address which will receive all the form data emails The email address is used for default settings and can be changed later Press Create button to build the configuration files You can now either go back to the List of Forms to use directly with default settings Goto Chapter Jo
18. formname value gt text for each form setup Step 2 Make an HTML form Step 3 Now this step differs for Radio Button and Drop Down Menu For Radio Button Use the code below to get Radio Buttons for whom to submit data The visitor selects the radio button and the email is sent through the indicated formname by Kmita Mail lt input type radio name formname value mktg php checked gt Marketing lt input type radio name formname value sales php gt Sales lt input type radio name formname value purchase php gt Purchase lt input type radio name formname value finance php gt Finance lt input type radio name formname value resel php gt Reseller Options Ensure that at least one form is checked other Kmita Mail will send the email data to website administrator email address This is how the above code looks like Name Email C Marketing C Sales C Puchase C Finance C Reseller Options For Drop Down Menu Use the code below to get Drop Down Menu for whom to submit data The visitor selects the required person from menu and the email is sent through the indicated formname by Kmita Mail lt select name formname gt lt option value mktg php selected gt Marketing lt option gt lt option value sales php gt Sales lt option gt lt option value purchase php gt Purchase lt option gt lt option value finance php gt Finance lt option gt lt option value resel p
19. h will be removed in the Data Email which you ll receive Ordering Date O lt HTML gt lt tr valign top gt lt td width 28 class text align right gt lt b gt Ordering Date lt b gt lt td gt lt td vwidth 72 gt lt input type text name Order Date class normalform gt lt span class text gt Eg 10 Jul 2003 lt span gt lt td gt lt tr gt lt tr valign top gt Data Email Phoneno Order Date 07 02 2004 Product formmmmmmmm Problem this is just a test Ly Note You cannot use special characters like P 2 TY TT Y T T etc for proper functioning of Kmita Mail Mail v 3 Mail v 3 Field Names Formatting With Form Validation The form fields need to be formatted as per the requirement of the field The phone field will hold a number while Name will hold simple text You can make the fields mandatory by proper formatting to enable good validation lt tr gt lt td width 200 class text gt lt font color 000000 font face tahoma size 2 gt Name company lt font gt lt td td width 200 gt lt font color 000000 font face tahoma size 2 gt Subject lt font gt lt ti td lt select nane km Subject size 1 gt lt option value General encujrv gt Genera enaulrv onution gt Name company i i E mall address i Comments ss tt i i sS re Syntax Example Explanation re Fieldname re Email Checks the syntax of Em
20. his box in a message a copy of the message is sent to that recipient and the recipient s name is not visible to other recipients of the message CAPTCHA A CAPTCHA an acronym for Completely Automated Public Turing test to tell Computers and Humans Apart trademarked by Carnegie Mellon University is a type of challenge response test used in computing to determine whether or not the user is human A CAPTCHA involves one computer a server which asks a user to complete a test While the computer is able to generate and grade the test it is not able to solve the test on its own Because computers are unable to solve the CAPTCHA any user entering a correct solution is presumed to be human The term CAPTCHA was coined in 2000 by Luis von Ahn Manuel Blum Nicholas J Hopper all of Carnegie Mellon University and John Langford of IBM A common type of CAPTCHA requires that the user type the letters of a distorted image sometimes with the addition of an obscured sequence of letters or digits that appears on the screen Source Wikipedia http en wikipedia org wiki Captcha CHMOD CHMOD stands for Change Mode CHMOD is used for changing mode of usage of the file The mode parameter consists of three octal number components specifying access restrictions for the owner the user group in which the owner is in and to everybody else in this order One component can be computed by adding up the needed permissions for that target user base
21. hp gt Resseller lt option gt lt select gt Ensure that atleast one form is selected other Kmita Mail will send the email data to website administrator email address Above code looks like this Name Email Query related to Marketing v Marketing Sales Purchase Finance Resseller x Note Kmita Mail cannot handle multiple formnames If it receives Lh multiple form names it will only execute the last formname that is specified or in some cases it may give error Preview the form before submission after submission Preview the form before submission 1 Create a form configuration Refer Chapter 3 2 Once this setup is done you will obtain a code similar to one below Insert these tags and fields in the first page of your form lt form method post action kmitam submit php gt lt input type hidden name formname value contact php gt lt input type text name re_Email gt lt form gt Ensure that your form fields are validated and made required 3 Secondly add a hidden field named _multipage in the form The value of the form should contain the server location of the next page e g lt input name multipage type hidden id multipage value home kmita public_html preview html gt The form is now complete Preview Page 1 The preview page can contain any text as per your requirements Then insert a form tag in the form Inside the form
22. lled on the server running in Normal Mode e SendMail installed or any SMTP server with or without authentication e GD2 Library for CAPTCHA Image Security e MySQL Writing privileges if you wish to add data to database AA Chapter 3 Getting Started Mail v 3 Uploading to the Server You have downloaded the ZIP file from your account http login kkeim com Since the script is in PHP therefore follow the procedure below Note On UNIX and Linux folder is referred to as directory Since most of the people use Windows as their operating system we would refer directory as folder in this help document G Unzip the contents of the ZIP on your local hard drive preferably on your desktop Now connect to Internet open your favourite FTP program Some of the most common FTP programs are CuteFTP WS_FTP AceFTP Freeware etc Upload the upload folder to the HTML root of your website The root of your website may be called as htdocs httpdocs wwwroot www public www public html etc fpublic htmlf X 3 EIO amp v Hodified Name Size Type Mi 07 1 13F Oo private File Folder 114 p71 13F Gr EG vii bin File Folder 114 07 1 13F vii on File Folder 114 007 8 45 O vi log File Folder 114 O07 8 25 DD vii pt File Folder 114 007 11 3 vi kst File Folder 114 007 10 1 album File Folder 4 4 007 5 10 cgi bin File Folder 114 07 12 44 images
23. neucvescusacsuansvenssanndannconnsics 39 Advanced Kmita Mail Features rrrnnnnnnnnnvnnnnnnnnnnnnvnnnnnnnnnnnnnnnnnvnnnnnnnnnnnnenn 42 Multi page forms using Kmita Mail v 3 ccccccceeescceeeeeceeeeeeeeeeeeeeeeeaeeeeeesneeeetees 43 Conditional Form Submission 1rrrrnrrrnrrnrrrnnrrn rn nrrnrrnnnnnrrrn nn nnnnnrnnnnnenrnnnnnnnnrrnnnnenrnnnn 46 Preview the form before submission after submission cccceeeeeeeeeees 49 Changing the Kmita Admin Language srrnrrnnnooonnrrnnrnnnrnnnrnrnnnnnnrrnnnnnnrrnnnnnnnnrnnnnnenenn 54 ET EE aa ARAARA EEEa Eaa AA ARARNAR aii 55 AA Chapter 1 Using This Help Thank you for buying Kmita Mail V2 for your website forms Please take a moment to familiarize yourself with the special text and messages used throughout this guide Text Conventions The examples below explain the specially formatted text used in this guide HTML code appears in Green coloured Text lt form method post action gt The names of the input form tags appear in Bold Type formname Email PHP code appears in Brown coloured Text lt Sto you yourdomain com gt File names appear in Italics Text setup php setup asp URL appear in Bold Blue text http www kmita mail com Email address appears in Blue text wecare kkeim com Mail v 3 Mail v 3 Special Messages The following words and symbols have special meaning in this g
24. ntain the server location of the next page lt input name multipage type hidden id multipage value home kmita public_html feedback_2 html gt The first page of the form is completed 4 Now on to the second page and the pages in between the first and the last page Set the action of form on all the pages as lt form method post action kmitam submit php gt 5 All the pages except the first one should contain this block CODE any where inside the form tags This will produce hidden fields and will not be visible even if placed any where inside the form 6 Then set the hidden field _multipage having the value of the location of the next page lt input name multipage type hidden id _multipage value home kmita public_html feedback_3 html gt 7 In short every page in the form should have its action to be set then have a hidden tag named _multipage and CODE written anywhere inside the form 8 The last page in the form WILL NOT contain any hidden field named multipage but will contain CODE block The form will now be directed to the thank you page collecting all the data 9 The Email field can be any of the form pages but it should be present CHECKLIST Page Kmita Mail Multipage form requirements First page Action inserting formname tag Email field multipage hidden field Between pages Putting CODE setting action multipage field Last page Putting CODE
25. owing pages What you need to have a multi page form 1 A form configuration setup normally 2 A Long form Step 1 Split your form based on the content For example contact information of one page details about occupation on other page You can split the form into any number of pages but consider that people on internet do not have much patience They may leave your form half if they cannot get to the end of the form If you have a long form mention like Page 4 of 10 4 pages more to go etc This lets the visitor know how many pages he still has to fill Multi page forms are an easy way of splitting up large form into number of number of forms spread over number of pages Visitors on internet do not like to fill forms especially the forms which run for several screens Multi page forms can help you by tempting your customer to fill very few fields on first page and then asking more information on the following pages Step 2 1 Open the Kmita Admin gt Kmita Mail List of Forms gt and create a new form 2 Once this setup is done you will obtain a code similar to one below Insert these tags and fields in the first page of your form lt form method post action kmitam submit php gt lt input type hidden name formname value feedback php gt lt input type text name re_Email gt lt form gt 3 Secondly add a hidden field named _multipage in the form The value of the form should co
26. r Edit the form settings to customize your form processing further Mail v 3 Editing a Form Configuration Goto the Kmita Mail v 3 List of Forms Page You should see the form s you have previously created Lin Change Password fdministration Home gt Kmita Mail List of Forms Find the list of all the form processing setups below You can edit the form processing settings and you can als IT new Form Click her File Name File Size Actions contact0 php 2 371 KB HTML Code chant Settings Delete KKE Info Media 2006 Click on Change Settings to edit the configuration file Admin Change I Administration Home Kmita Mail List of Forms Edit Form contactO php You can edit the settings by clicking on the tabs below On making changes click Save Settings d the page General Settings Data Email Autoresponder Data Storage Form Validation Upload Settings General Settings Success and Error Page Settings A or your website SERVER Pati Following is the your HTML root F ymaily Bac ita FAmail kmita thankyou htm You ll be able to see the following tabs on this page above Mail v 3 General Settings Data Email Autoresponder Data Storage Form Validation T 2 3 4 5 6 You can change any settings on the page and press Save Settings button on the bottom of Upload Settings the page 31 Jan 2005 11 45 12 PM Off
27. set time by Be Bs 0 Enns R KKE Info Media 2006 Caution You ll lose all the changes you made if you do not press Save Settings AA Chapter 5 Basic Kmita Mail v 3 Features Lov Mail v 3 Customizing your Form Data Email and Subject Kmita Mail v 3 allows you to customize how you receive the form details from your website visitor 1 HTML 2 Plain Text You have an option to receive the data in following formats 1 Kmita Mail Default 2 My own HTML Text Full Customisation If you select option 2 i e My own HTML Text Full Customisation you ll need to provide complete email body To start with you can make a table with two columns One column will hold the label for the particular field and the other will show the value filled by the visitor The name of the field if enclosed by vertical bars and square braces substitutes the value filled in the form exact name of the field Data Email from rn_Name Email address re_Email Address Address Query Query Date DATE Time TIME IP IP Once this email has been designed in HTML Text you simply need to paste it in the Textbox for Data Layout Mail v 3 Data Email Layout Layout Text Incase of My own HTML Text Data Email Format HTML Texts Plain Larout My own HTML Text Full Customisation ayout O Kmita Mail Default No Customisation Data Email Subjec
28. t etails from rn Namel lt table border 0 cellspacing 0 cellpadding 0 gt lt tr gt lt td width 430 colspan 3 valign top gt lt p align left gt Data Email from rn Name lt p gt lt 1 a lt tr gt lt tr gt lt td width 125 valign top gt lt p align left gt En address lt p gt lt td gt lt td width 305 colspan 2 v amp lign top gt lt p align left gt re Email lt p gt lt td The name of the field mentioned in the Data Email should be exactly the same Even the change in the case or capitalization takes place Kmita Mail v 3 will not work That is the value in the form field will not be substituted You can use the following code to add IP address date and Time in your form results Value Code IP IPI Date DATE Time TIME Unique ID UNIQUEID Customizing your Autoresponder Email and Subject v Mail v 3 Kmita Mail v 3 allows you to customize how you send your autoresponder email to your visitor 1 HTML 2 Plain Text The name of the field if enclosed by vertical bars and square braces substitutes the value filled in the form exact name of the field Once this email has been designed in HTML Text you simply need to paste it in the Textbox for Autoresponder Text responder using Auto responder format Auto Responder Subject Auto responder text Auto responder Attachment HTM
29. tags insert CODE as shown below lt form method post action kmitam submit php gt CODE lt form gt 2 Inside these tags you can insert a table where you can can show the preview of the data filled by the visitor One column can contain the label of the form field and the other should have Exact name of the field e g Name rn_Namel Address re_Address 3 Put submit button at the end of this table inside the form tags Your preview page is now ready On submission this will appear as Name John Address j peter Qemail com You can personalize any part of your text by inserting Exact name of the field in your emails email subjects success pages etc Preview the filled details after submission 1 Create a form configuration Refer Chapter 3 2 Once this setup is done you will obtain a code similar to one below Insert these tags and fields in the first page of your form lt form method post action kmitam submit php gt lt input type hidden name formname value contact php gt lt input type text name re Email gt lt form gt Ensure that your form field are validated and made required Kindly refer the details of Form field validation Once the form is prepared place the submit button The form is directed to the success page on form submission The success page can be personalized as per the form submitted by the visitor Any field can be added into the
30. uide LY Note Important information concerning the operation of Kmita Mail V2 TAN Caution Failure to follow directions may result in malfunctioning and data loss VHA Error Failure to follow directions could lead to the errors listed in this box Mail v 3 Locating Help Kmita Mail provides you with several ways to find help 1 Setup Manual 2 Knowledgebase http support kkeim com faq 3 Website Support http support kkeim com 4 Email Support wecare kkeim com LY Note Always mention Location of Kmita Mail on your server and the form you are trying to integrate with Kmita Mail when communicating with Support AA Chapter 2 About Kmita Mail v 3 Mail v 3 What s New in Kmita Mail v 3 Kmita Mail v 3 is the latest version for Kmita mail The new version now has e New 4 step spam check e CAPTCHA image security e Tabbed form configurations for easy understanding and use e Individual Upload settings for each form e Individual Validation Settings for each form e Option of changing the language of the Admin Panel e Integrates into Kmita Admin e Intutive menus e SMTP settings page e Blocked IP page Mail v 3 Kmita Mail v 3 Requirements Since Kmita Mail is installed on your server You server should fulfill the following requirements Kmita Mail can be installed on mostly any Linux Unix or Windows Server as we have kept the PHP requirements to very low e PHP 4 1 0 or higher insta
Download Pdf Manuals
Related Search