Installation and User Manual
Contents
1. connect to Internet open your favorite FTP program Some of the most common FTP programs are CuteFTP WS_FTP AceFTP Freeware etc Upload the Kmitaadmin and kmitam folders to the HTML root of your website The root of your website may be called as htdocs httpdocs wwwroot www_public www etc O public_html 22 0 gt rss Hodified Name Size Type Ma 07 1 13 F O private File Folder 114 07 1 13F O _vti_bin File Folder 114 07 1 13 F _vti_ent File Folder 114 007 8 45 _ vti_log File Folder 114 007 8 25 _vti_pvt File Folder 114 007 11 3 _vti_tst File Folder 114 007 10 1 O album File Folder 4 4 007 5 10 O cgi bin File Folder 114 OF 12 44 O images File Folder 124 07 10 18 DEEE A File Folder 0712 44 DE File Folder 007 11 5 9 shashank File Folder 4 4 OF 12 44 htaccess 359 HTACC 11 OF 12 44 _vti_inf html 1 754 HTML 11 07 1 14F error htm 9 HTML 4 3 laz12 aa l TD iaa hn 2070 pupc 4 A Caution The files have to be in the HTML root of the website else Kmita Admin and Kmita Mail will not work Setting Folder Permissions Kmita Mail creates files and folders on your server and requires read write and execute permissions 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 Size2. 5KB 4 955 bytes ipul Modified Multiple Dates l a Name Attributes Owner Read Write Execute 3 PM imag G v v b ppi Skit roup Read M write Execute BPM E admi Everyone V Read Write Execute 45AM admi CHMOD Value 777 25 PM i 37 PM oa 10 PM ai 44 PM J kmitam php ef line SCIAGA 18 AM lic_temp htrl 91 HTML 4 26 2 44 PM license php 4 348 PHPSc 4 26 2 55 PM login php 118 PHPSc 4 26 2 44 PM sy login_temp html 97 HTML 4726 2 44 PM login1 php 695 PHPSc 4 26 2 4 PM logout php 1 397 PHP Sc 4726 2 44 PM php php 351 PHP Sc 4 26 2 44 PM smtp php Gar an Cd 1 30 AM a smtp_settings php 5 994 PHPSc 4 2672 The following files and folders require CHMOD 777 File Folder Permission CHMOD kmitaadmin login php 777 kmitaadmin kmitam php 777 kmitaadmin kmitam data 777 kmitaadmin kmitam config 777 kmitaadmin kmitam config config php 666 kmitaadmin kmitam config oannedemails php 666 kmitaadmin kmitam config oannedips php 666 kmitaadmin kmitam config captchavars php 666 kmitaadmin kmitam config vidrules php 666 kmitam temp 777 12 13 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 er
3. Kile Version 4 0 Installation and User Manual 44 Ambazari Layout Nagpur MH India 440033 Phone 91 712 223 7066 395 8918 Fax 91 712 223 5838 Email wecare kkeim com Website http www kkeim com Contents Using This SU ca ngs 5s Say cesrssectartecsaysecdadeedscesepretapnevboauan ORRE veadiale iosanspbvveestaniaaaes 3 Text Conventions oneiincrorei oaii ii a i i 4 Special MESSAGES sess cisse ss iicceriea tests hctesien issih Gatien Gusher aAnEnKe 5 Locating Help irns nerenin neseniai an e E E E E 6 About Kmita Mail VA enon e aa E O A EE S 7 What s New in Kmita Mail v 4 20 0 ceeceeeeneeseceseeeeeeeeeseenaeenseeneeens 8 Kmita Mail V4 Requirements 0 0 0 ccc cccccceeceeeceeceeeeeeeseceseenseeneeeeenaeenaees 9 Getting Star ed a a cad ea ae ences testa eae ce epee aes caw tanta tcc 10 Uploading to the Server o oo ccc ccccccscceeseeesseceseeeeseeesseeeseeeeseeseseesseeeeseees 11 Setting Folder Permissions 0 0 0 00 cccccccceesceecceseeeceeeeeeeeeeaeeeaeceeeseeeeeeeeenaees 12 Entering License Information 0 0 cece cecceseeeeceseceseeeseeeeeeeeeeenseenseeneeens 13 Creating and Editing Form Configurations 0 0 cc cc cceeseeeseeeteeeeeees 15 Creating a Form Configuration oo cece cceeeseeeceeeeeeeeeaeeeeeeeeeeneeneenaees 16 Error and Success page Configuration 2 0 0 0 ec ecceceeeseeeeeeneeeeeeeeeeeeens 18 Data Email Configuration s iisciccceccssssastvssessatvscessshastonssadesestat
4. 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 Email Format HTML O TEXT Email Layout n 1 HTML Text Full Customization Kmita Mail Default No Customization Data Email Subject Contact Form Data Data Email Body iB ZUS Tate v 3 X x sak x Cu me amp a g Ht E 9 3 Select Font w Size Header w Il W il i m BL A laddress countryl SM ire Email Address Country Query lgueryl v HTML gt BODY gt TABLE gt TBODY gt TR gt TD Submit Reset 20 teen WA ae GE cve0 A 0 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 V4 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 IP Date DATE Time TIME Unique ID UNIQUEID Date Time DATETIME 21 Autoresponder Email Configuration Kmita Mail V4 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 sub
5. areessaaivensnvedstaneondvess 19 Autoresponder Email Configuration 0 00 cece cecceceeeeceneeeeeeeseeneeeneenaee 21 D ta Storage ctae e a a e E A cana 22 Setting form validations ccc cccccsecceteceseeeeseessseeeeeeeseeseseesseeesseessaes 23 CAPTCHA Image Configurations 0 0 0 0 eee ceeeeeceseeeseeeseeeeeeeeeaeenseeeseeneeas 25 Building HTML POMS i2c05cccscsessnisecieeasy inert aastissigieelearaiisndiierianine ives 26 Calculations and Formula iisissccsesnesaianaiiadadasadanadacaiaciceas 28 Setting Preview and Multipage forms 0 00 c cc ccccccseceteeeseeeseeeeeeeeaes 29 Chapter 1 Using This Help Thank you for downloading Kmita Mail V4 manual 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 colored 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 colored 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 Special Messages The following words and symbols have special meaning in this guide LY Note Important information concerning the operat
6. d FLOOR For ex if you wish to round the above summation to 2 decimal digit then set the fields value as ROUND 2 num1 num2 num3 The digit after ROUND is the number of decimal places you wish to add to the result if this number is ignored then 0 is the default value Sample Code lt input name sum type hidden id sum value ROUND 2 num1 num2 num3 gt lt input type hidden name avg id avg value ROUND 2 num1 num2 num3 3 gt lt input name perc type hidden id perc value ROUND 2 num1 num2 num3 100 100000 gt lt input name sum type hidden id sum value CEIL num1 num2 num3 gt lt input name total type hidden id sum value FLOOR price1 price2 price3 gt You can save the calculated value to database table CSV file or Excel sheet by using the same convention as used for other field as fieldname for ex sum in case saving this field to MySQL table use the fieldname without i e sum as field name This value can also be displayed on preview page using the tag sum Caution All the form fields used in the calculation must have names in the A character set a z0 9A Z_ The field s name should not contain any character other than the above character set 29 Setting Preview and Multipage forms To make multipage forms you should add the hidden field _ multipage to all the forms in the submission stages except the last form that you wish should get submitted and proces
7. e form data the MySQL you must provide the MySQL connection parameters Kmita Mail V4 allows you to execute multiple queries you can execute INSERT UPDATE queries depending upon your requirement If you want to execute more than one query please separate the queries using y HTML Code Validations Captcha Error amp Success Page Date Time Data Storage Data Email Autoresponder Email Data Storage ore form data in MySC rate quer IL Queries RT INTO contact name email city state country mobileyVALUES namel lemaill cityl state country Imobile Store form data in CS File es O No Store form data in Excel Sheet yes O No Data Sequence Sample IDATETIME IPI Ire_Emaill namel city slJ lcity country query Submit Reset 23 Setting form validations Kmita Mail V4 allows powerful form validations you can choose either from predefined rules or even create your own custom validation rules Kmita Mail V4 allows you to validate POST and well as FILE field data HTML Code Validations Captcha Error amp Success Page Date Time Data Storage Data Email Autoresponder Email Form Validation Add New Rule A4dd New Field Form Field Required Rule Error Message Action re_Email Email The email address submitted is invalid wx name v Text Name is required and must be valid text 7x address Yy Text Address is required and should not contain special 7
8. er Email Form HTML Code You can start creating form using Kmita Mai our form using the HTML code provided below This is the minimal code that is required for process and any of these form fields form attributes should not be ignored ig the lt form method post enctype multipart form data action kmitam submit php gt Email lt input name re Email type text id re Email size 25 maxlength 100 gt lt input name formname type hidden id formname value contact gt lt br gt lt img srce kmitaadmin kmitam image php width 150 height 80 gt lt br gt Enter the characters shown in the above image 0 9 A F lt input name secnum type text id secnum gt lt br gt lt input type submit name button id button value Submit gt lt form gt 18 Error and Success page configuration wile ain Change Password Logout Administration Home List of forms Form Settings contact Form Configuration contact HTML Code Yalidations Captcha Error amp Success Page Date Time Data Storage DataEmail Autoresponder Email Error amp Success Page Success page is the page which the visitor sees when the form data is submitted successfully The visitor views error Page when form data in not submitted due to some reason Success and Error pages can either be HTTP URL or your website SERVER Path Following is the server path of your HTML root S r ankyou h
9. ha Error amp Success Page Date Time Data Storage Data Email Autoresponder Email Form Validation Rule Pattern Rule isbn Pattern 0 9 S 0 9 xp Sample argument for testing pattern 047038008 Submit Reset Back Action 24 Chapter 5 CAPTCHA Image configurations 25 Kmita Mail V4 allows you to customize the form CAPTCHA you can change the background image captcha font size color and text If you want to add your own background images to the CAPTCA you should upload the images to the folder kmitaadmin kmitam captchaimages G Note The script will only support png images for the CAPTCHA background If you wish to use a custom font for the CAPTCHA upload the font file in kmitaadmin kmitam folder the script will support any true type font i e ttf for the image text Admin Administration Home List of forms Ca Captcha Settings Change Password tcha Settings m Background Captcha Font Logout Font kmita Size 12 Color a v m Captcha Text numbers and Text O Text Only O Numbers Only Save Settings KKE Info Media 2006 Sample CAPTCHA Image generated based on custom settings 26 Chapter 6 Building HTML Forms There are few basic requirements that a form must fulfill to be processed using Kmita Mail V4 1 A hidden field in the form by the name formname the value of this field m
10. ion of Kmita Mail V2 A 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 Locating Help Kmita Mail provides you with several ways to find help 1 2 G Setup Manual Knowledgebase http support kkeim com faq Website Support http support kkeim com Email Support wecare kkeim com 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 Chapter 2 About Kmita Mail V4 What s New in Kmita Mail V4 Kmita Mail V4 is the latest version for Kmita mail The new version now has e New 4step spam check e Uses OOP php 4 compatible e CAPTCHA image security e Advanced settings to control CAPTCHA image font font size and image text e Tab based configuration menus for easy understanding and use e Individual Upload settings for each form e Individual Validation Settings for each form POST and FILE data e Powerful validation with options to create custom validation rules e Integrates into Kmita Admin e Intuitive menus e Kmita mail configuration page e Advanced settings page to control key mail options for ex SMTP Port from suffix e Banned IP Address page e Banned Email Page e Ability to copy old form settings while creating new forms e Ability to export form data to CSV format e Abilit
11. nt To create form configuration click List of forms on the Kmita Mail Administration menu to view the page below peili Administration Home List of forms min Change Password Logout Click here to create new form gt contact False Felcsv HJExcel E Delete gt registration Ese Ejcsv Fjexcel E Delete The page display list of forms created with all the configurations that have been set for the particular form you can view the forms data MySQL report Excel Report or view it in CSV format The page also provides the links to edit form configurations and deleting the forms To create new forms press Click here to create new form link to view the page below 17 Admin Administration Home List of forms Create Form Change Password Logout Form Name Primary Email Addr The data email autores onder email will be sent to from this email addre Copy Settings From Do not copy Submit Reset The newer version also provides you the option to copy settings of previously created forms saving you from the repetitive task of entering common details Once you enter the above details you will be redirected to the settings configurations page shown below Admin Administration Home List of forms Form Settings contact Change Password Logout Form Configuration contact HTML Code Validations Captcha Error amp Success Page Date Time Data Storage Data Email Autorespond
12. of forms Form Settings contact Change Password Logout Form Configuration contact HTML Code Yalidations Captcha Error amp Success Page Date Time Data Storage Data Email Autoresponder Email Form HTML Code You can start creating your form using the HTML code pros form using Kmita Mail Y4 and any of these form fiel orm attribute ided below This he minimal code that is required for processig hould not be ignored lt form method post enctype multipart form data action hkmitam submit php gt Email lt input name re Email type text id re_ Email size 25 maxlength 100 gt lt input name formname type hidden id formname value contact gt lt br gt lt img src kmitaadmin kmitam image php width 150 height 80 gt lt br gt Enter the characters shown in the above image 0 9 A F lt input name secnum type text id secnum gt lt br gt lt input type submit name button id button value Submit gt lt form gt 28 Calculations and Formula You can perform calculations based on the form fields by adding a hidden field to the form and settings its value to an arithmetic expression using form field names For ex price1 price2 price3 Note the sign is required in the value being set and should not be ignored Lh Please see the sample code below You can perform three operations on the resultant number ROUND CEIL an
13. sed The hidden field _multipage must contain the server path or relative path to the next form that the user needs to fill For ex lt input name _multipage type hidden id _multipage value home kmita public_html feedback_2 html gt If you wish that the user also views the values that he has entered in the previous form then please add the fieldname in the tag fieldname on the page where the user previews the values entered For ex Name namel Address address State state Country country The last form in the sequence should not contain the hidden field _ multipage All the forms except the first form in the multipage form sequence should contain the tag CODE otherwise the script will not be able to carry the values entered by the user in the earlier forms to the next form The tag CODE must be placed inside the form tag For ex lt form method post action kmitam submit php gt CODE lt input name _multipage type hidden id _multipage value home kmita public_html feedback_3 html gt lt form gt Caution The file upload fields in the multipage form must appear in the last A form to be filled by the user if you add the file input field to the earlier forms the script will not be able to copy and carry the file contents to the next form
14. stitutes the value filled in the form lexact name of the field Email Format O HTML TEXT Autoresponder Email Subject rou for contacting A ME ET T A A amp 644 ma o Select Font Size w Header w Dear namel we have received the following querwqueries from you query Ve will be responding to you ASAP if you need any information regarding the product and services provided by www mysite com please contact us your email address re_Emaill Mobile mobile IP IDATE For www mysite com v HTML gt BODY gt BR j Autoresponder Attachment Specify the server path of your attachment file If there are more than one file you can zip them into ile Server Path C wamp www kmitaadmin kmitam mpi fimagefimage 2 png Submit Reset 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 V4 will not work That is the value in the form field will not be substituted You can also use the code to add IP address date and Time in your custom layout the same way as for Data Email explained earlier 22 Data Storage Kmita Mail V4 provides you the option to store data in CSV file excel sheet and MySQL table you can specify the form fields that you want to save and view the report in CSV excel or MySQL according to your preference In case you want to save th
15. tm th Clwampiwnw thankyou htm Error Page error htm Submit Reset You can set the success and error page path to either server path or http path we recommend using server path for the error and success pages as this give you the ability to customize the pages In case you are using http path for ex http www mysite com error html the script will only redirect to the http path on error success it wont be able to display the errors custom data By default the Kmita Mail V4 uses relative path for error and success page you can find the thankyou htm and error html files in kmitam folder the path is set relative to kmitam folder You ca also customize the error and success page to display the form fields values if you wish by adding the tag exactfilename in the pages For ex Namel will get replaced by the form field Name you can add as many form fields as you like kmita mail V4 also supports displaying calculated files on the success page 19 Data Email Configuration Kmita Mail V4 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 No Customization 2 My own HTML Text Full Customization If you select option 2 i e My own HTML Text Full Customization you ll need to provide complete email body To start with you can make a table with two columns
16. ust be set to the name of the form being created in the kmitaadmin panel For ex contact registration etc Sample Code lt input name formname type hidden id formname value contact gt A primary email address field in the form re_Email the email field in the form must always be named as re_Email and must be present in the form Sample Code lt input name re_Email type text id re_Email size 25 maxlength 100 gt The Captcha image and security number input field if Image challenge has been enabled for the form The security image field must be named as secnum Sample Code lt img src kmitaadmin kmitam image php width 150 height 80 gt lt br gt Enter the characters shown in the above image 0 9 A F lt input name secnum type text id Ssecnum gt Note if you have enabled file uploads for the form then the form tag must also include the declaration enctype multipart form data The forms action property should be set to kmitam submit php We recommend building your forms using the HTML code generated by the script for the form the script generated this code based on the form settings To view this code click HTML Code tab on the form settings page 27 The HTML code generated by the script is the minimal code that you need in the form to be processed the screen shot below shows a sample code generated for the form contact Admin Administration Home List
17. x characters other than 2 W 5 amp _ city v Text City is required 7x state y Text State is required Zx country Tet Country is required 7x Phone x lt Text Invalid phone number wx mobile lt Number Invalid mobile number Zx query y Text Query is required Zx photo v File Field Photo is required and must be of type jpg jpeg and a x should not exceed 2048 KB To add a field validation click Add New Field HTML Code Validations Captcha Error amp Success Page Date Time Data Storage Data Email Autoresponder Email Form Validation Add Custom Rule Back Field height Required Field Type POST Validation Rule Number v Extras Min 6 0 Max Allow Decimal O allow Negative Error mess y if validation fails should not exceed 250 characters You must be at least 6 feet tall Submit Reset The field should be the exact name of the field in the form and the field type should be appropriately set if the field to be validated is a file upload field then choose the field type as FILE the above screen shot has the field type set to POST for the form field Height any number greater than or equal to 6 0 The button besides the Validation Rule selection box is the custom rules definition link if you want to add your custom rule you will see the pop up form on clicking the button The image below shows a screen shot of the custom rule creation form HTML Code Validations Captc
18. y to export form data to excel xls format e Ability to save data to multiple MySQL tables and report to view the saved data e Support for multiple MySQL queries e Support for multi page forms e Full customization for error and success pages e Full customization for data email and auto responder email e Ability to make calculations and save in MySQL database CSV file excel file and display the calculation in data email auto responder email success page Kmita Mail V4 Requirements To install Kmita Mail V4 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 or higher installed on the server running in Normal Mode e Send Mail installed or any SMTP server with or without authentication e GD2 Library for CAPTCHA Image Security e MySQL Writing privileges if you want to save form data to MySQL table Chapter 3 Getting Started 11 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 Ly 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 Unzip the contents of the ZIP on your local hard drive preferably on your desktop Now
19. your Administration Username and Pas Username admin Password eecce 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 Kmita Mail Administration List offorms Version 4 0 Confiquration Captcha Settings Banned IP Addresses Banned Email Addresses Error Codes Error log License Management 14 Change Password Logout Kmita software to wort 0 yeed to acquire a license key at http login kkeim com Website URL http localhos Enter License Key 13ZL JX6L 64HE 51335 3YGB2 22P03 DA936 D03 Cheek Save License KKE Info Media 200 Go to hittp login kkeim com Using your username and password sent to you login into your account and create your Kmita Mail V4 Key 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 Permissions Chapter 4 Creating and Editing Form Configurations 16 Creating a Form Configuration Kmita Mail Administration Listofforms Version 4 0 Confiquration Captcha Settings Banned IP Addresses Banned Email Addresses Error Codes Error log License Manageme
Download Pdf Manuals
Related Search