====== conform Plugin ======
---- plugin ----
description: Simple HTML forms with HTML e-mail output
author : William Fletcher
email : uiriamu.furecchaa@gmail.com
type : syntax, helper
lastupdate : 2008-10-29
compatible : !Hrun
depends :
conflicts :
similar : form, contact, bureaucracy, contactmodern
tags : form, email, poll
downloadurl: http://thirdforces.internationalconspiracy.org/~ultraviolet/software/conform/dokuwiki-plugin-conform.tar.bz2
----
===== Download and Installation =====
Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
==== Warning ====
This plugin should currently only be used on closed wikis, because it could easily be abused as a spam gateway. Counter measurements are planned for future releases.
===== Usage =====
Fully loaded example:
In main DokuWiki config you will need to allow the "page" (specified by the "ID" in the URL, so namespace:anothernamespace:page, etc).
And then allow e-mail to where you desire (In the example: toenail@fingernail.co.za and peanut@butter.co.za), this prevents the service from being
abused on a public wiki. (Although, please heed the warning above, this is still not suitable for public wikis yet, just the initial design is heading that way).
MailTo "toenail@fingernail.co.za, peanut@butter.co.za";
MailSubject "BigEvilCorp - Leave Form";
Textbox EmployeeName "Employee Name" 180;
Constraint EmployeeName "Fill in the the Employee Name" minLength="2";
Textbox PracticeOrDepartment "Practice Or Department" 180;
Constraint PracticeOrDepartment "Practice or Department" minLength="2";
Textbox Position "Employee Position" 180;
Constraint Position "Fill in the Employee's position" minLength="3";
Select TypeOfLeave "Type of leave requested" "Annual Leave,Sick Leave" 180;
Textarea ReasonRequestedOther "Specify Other If Selected Above" 10 320;
Radio ReplacementArranged "Replacement/Locum Arranged" "Yes,No,Not required";
Textbox name "Your name" 180;
Static "A combobox declared by a list";
Select country "Your country" "Biscuit, Tea, Coffee" 180;
Static "A combobox declared by a name";
Line;
Checkbox news "We advice you to subscribe to our newsletter" 1;
Checkbox news2 "We advice you to subscribe to our newsletter" 0;
Line;
Radio zahlmethode "Payment:" "Mastercard,Visa,Cash, Paypal";
Line;
Textarea comments "**Comments**" 10 320;
Textbox zip "zip" 180;
Textbox mail "e-mail" 180;
Textbox max7 "max 7" 180;
Textbox min7 "min 7" 180;
Textbox greptest "greptest" 180;
Textbox testint "Int test" 180;
Textbox testfloat "Float test" 180;
Textbox functiontest "Function test" 180;
Constraint min7 "Mind. 7 digits!" minLength="7";
Constraint max7 "Max. 7 digits!" maxLength="7";
Submit "Submit" 200;
Textbox zipzip "zip" 180;
RowsStart 3;
Textbox DaysWorked3 "Day's Worked" 90;
RowsEnd;
RowsStart 10;
Textbox DaysWorked "Day's Worked" 90;
Textbox FromTime "Start Time" 90;
Textbox EndTime "End Time" 90;
Textbox NumberOfHours "Number Of Hours" 90;
Textbox RatePerHour "Rate Per Hour" 90;
RowsEnd;
Textbox meow "zip" 290;
RowsStart 3;
Textbox DaysWorked2 "Day's Worked" 90;
Textbox FromTime2 "Start Time" 90;
Textbox EndTime2 "End Time" 90;
RowsEnd;
A sample form:\\
{{http://software.applestone.co.za/conform.png|A sample form}}
\\
A sample e-mail:\\
{{http://software.applestone.co.za/email.png|A sample email}}
\\
===== TODO =====
* Setup an 'amounts' keywords that pushes financial amounts to the right.
* Fix characters allowed in the keywords, because users can stop $_POST from functioning.
* Setup a something to stop spam bots.
===== UTF-8 charset in e-mail =====
This addition improves the look of e-mails containing international characters.
--- syntax.php.org 2008-10-03 07:28:00.000000000 +0200
+++ syntax.php 2009-03-04 14:30:36.000000000 +0100
@@ -373,6 +373,7 @@
if ( $_SESSION["conform_emailed"] == false )
{
$emailform = "";
+ $emailform .= "";
$emailform .= "