####################################
#                                  #
# ext: th_mailformplus             #
#                                  #
# by:         Dev-Team             #
# email:      dev@typoheads.at     #
# www:        www.typoheads.at     #
#                                  #
# donations welcome :)             #
#                                  #
####################################

################################################
############# ATTENTION ########################
# read this section when using multipage-forms #
# 
# showing different forms depending on user selection
#
################################################

    > [2]  -> [4] \  
[1]                > [6]
    > [3]  -> [5] /

[1] ... depending the user selection the next step is [2] or [3]



make sure that:
- each form has a form-start-tag beginning with "<form" or "<FORM"
- each form has a form-end-tag "</form>" or "</FORM>"
- fieldnames are enclosed by " eg. <input type="text" name="email">

Dependancy on JavaScript for multipage-forms:
- only works with JavaScript enabled by default.
- works without JavaScript by using
  plugin.th_mailformplus.multipage_without_js = 1 (see example below)

In order you do not want to write the <form>-tag in each step-template, 
you can define a subpart within the first step template for a starting-block and an end-block.
You can use these subparts within each following step-template by the markers
- ###STARTBLOCK### 
- ###ENDBLOCK###

Define the subparts like this:
<!-- ...FORM1 begin -->

  <!-- ###FORM_STARTBLOCK### begin-->
  ... put your start-form tag here
  ... everything you write here, will be put in the ###FORM_STARTBLOCK### marker
  <!-- ###FORM_STARTBLOCK### end-->
  
  put your inputfields here
  ...

  <!-- ###FORM_ENDBLOCK begin  -->
  ... put your end-form tag here
  <!-- ###FORM_ENDBLOCK end -->

<-- ...FORM1 end -->


in all following steps you can use the markers:
<!-- ...FORM1 begin -->
  ###STARTBLOCK###
  
  put your inputfields here
  ...

  ###ENDBLOCK###
<!-- ...FORM1 end -->


################################################
# showing different forms depending on user selection
# example: 

if a field [fieldname] has a value [value] the template for step 3
will be FORM3[name of postfix]. if that field had the value [other value],
the template for step 3 would be FORM3[name of other postfix]
################################################

use postfixes in subpart definitions to use conditions:
<!-- ...FORM3[name of postfix] begin -->
<!-- ...FORM3[name of postfix] end -->

<!-- ...FORM3[name of other postfix] begin -->
<!-- ...FORM3[name of other postfix] end -->

by using typoscript conditions you can set a postfix for a specific step.
Example:
[globalVar = GP:[fieldname] = [value]]
plugin.tx_thmailformplus_pi1.multipage.3.postfix = [name of postfix]
[global]
[globalVar = GP:[fieldname] = [other value]]
plugin.tx_thmailformplus_pi1.multipage.3.postfix = [name of other postfix]
[global]

################################################

new markers to be used in multipage forms:

###ADDITIONAL_MULTIPAGE###  ... make sure you insert this marker in every step between the <form> and </form> tag
	This is where the automatic generated JS function and hidden fields are written.

	If plugin.th_mailformplus.multipage_without_auto_hidden = 1 is set, the ###ADDITIONAL_MULTIPAGE### marker will not contain the inactive steps and therefore, the values from other pages will have to be set manually in the step-templates by input type=hidden. this will result in more work for creating the HTML template, but removes CSS dependancy and renders a "cleaner" HTML (no xform tags).

	If plugin.th_mailformplus.multipage_without_js = 1 is set, the ###ADDITIONAL_MULTIPAGE### marker will not contain JavaScript functions, since browsing between pages is expected to be realized by <input type="submit" ###submit_nextStep### value="next" /> respectively <input type="submit" ###submit_prevStep### value="back" /> (see example below).

###curStep### ... current step shown
###maxStep### ... total number of steps
when using multipage forms with conditions be sure not to use this marker because the total amount of steps can not be determined at runtime.

###link_nextStep_start### ... <a> start-tag for next page
###link_nextStep_stop### ... </a> end-tag for next page
###link_prevStep_start### ... <a> start-tag for previous page
###link_prevStep_stop### ... </a> end-tag for previous page
###link_reload_start### ...   <a> start-tag for submitting form but stay on the same step  
###link_reload_stop###  ...  </a> end-tag for submitting form but stay on the same step

###submit_nextStep### ... name="" attribute next step (input type="submit" requires TS multipage_without_js = 1)
###submit_prevStep### ... name="" attribute prev step (input type="submit" requires TS multipage_without_js = 1)
###submit_reload### ... name="" attribute reload (input type="submit" requires TS multipage_without_js = 1)

settings for file upload defined in TS:
###[name of upload field]_fileTypes### ... allowed filetypes eg. jpg,gif,pdf
###[name of upload field]_fileSize###  ... maximum allowed filesize per file
###[name of upload field]_numberOfAllowedFiles### ... maximum number of files that can be uplaoded with this field
###[name of upload field]_numberOfUploadedFiles### ... number of currently uploaded files via this field
###[name of upload field]_numberOfRemainingFiles### ... number of remaining files that can be uploaded 

###############################################


###############################################
##             EXAMPLE                       ##
###############################################

<!-- ###TEMPLATE_FORM1### begin -->

  <!-- ###FORM_STARTBLOCK### begin-->
    
    <form name="Formular" method="post" action="###REL_URL###" enctype="multipart/form-data">
    <input type="hidden" name="id" value="###PID###" />
    <input type="hidden" name="submitted" value="1" />
    <input type="hidden" name="L" value="###value_L###" />
  
  <!-- ###FORM_STARTBLOCK### end-->
<fieldset>
				<legend>###LLL:pers_info###</legend>
<label for="surname" accesskey="s">###LLL:surname###:</label><br />
###error_surname###
<input type="text" name="surname" id="surname" value="###value_surname###" tabindex="1"/>
<br />
<label for="email" accesskey="m">###LLL:email###:</label><br />
###error_email###
<input type="text" name="email" id="email" value="###value_email###" tabindex="2"/>
<br/>
<label for="education" accesskey="e">###LLL:education###:</label><br/>
<input tabindex="3" type="radio" name="education" value="school" id="education_school" style="border-style:none;" ###checked_education_school### /><label for="education_school">###LLL:school###</label><br/>
<input tabindex="4" type="radio" name="education" value="university" id="education_university" style="border-style:none;" ###checked_education_university### /><label for="education_university">###LLL:university###</label><br/>
<p>###LLL:surname###: ###value_surname###</p><br/>

<input type="submit" ###submit_nextStep### value="###LLL:next###" tabindex="5"/>
</fieldset>
  <!-- ###FORM_ENDBLOCK### begin -->
    ###ADDITIONAL_MULTIPAGE###
    </form>
  <!-- ###FORM_ENDBLOCK### end -->

<!-- ###TEMPLATE_FORM1### end -->







###########################################
# step 2 and step 3 (universty) are the same
###########################################
<!-- ###TEMPLATE_FORM2### begin -->
<!-- ###TEMPLATE_FORM3_university### begin -->
###STARTBLOCK###
<fieldset>
				<legend>###LLL:add_info###</legend>
<label for="age" accesskey="a">###LLL:age###:</label><br />
###error_age###
<input type="text" name="age" id="age" value="###value_age###" tabindex="1"/>
<br />
<label for="job" accesskey="j">###LLL:job###:</label><br />
###error_job###
<input type="text" name="job" id="job" value="###value_job###" tabindex="2"/>
<br/>

<input type="submit" ###submit_nextStep### value="###LLL:next###" tabindex="3"/>
<input type="submit" ###submit_prevStep### value="###LLL:back###" tabindex="4"/>
</fieldset>
###ENDBLOCK###
<!-- ###TEMPLATE_FORM3_university### end -->
<!-- ###TEMPLATE_FORM2### end -->







<!-- ###TEMPLATE_FORM2_university### begin -->
###STARTBLOCK###
<fieldset>
				<legend>###LLL:edu_info###</legend>
<label for="university" accesskey="u">###LLL:university###:</label><br />
###error_university###
<input type="text" name="university" id="university" value="###value_university###" tabindex="1"/>
<br />
<label for="study" accesskey="s">###LLL:study###:</label><br />
###error_study###
<select name="study" id="study" size="1" tabindex="2">
	<option value=""></option>
	<option value="mtd" ###selected_study_mtd###>###LLL:study_mtd###</option>
	<option value="other" ###selected_study_other###>###LLL:study_other###</option>
</select>
<br/>

<input type="submit" ###submit_nextStep### value="###LLL:next###" tabindex="3"/>
<input type="submit" ###submit_prevStep### value="###LLL:back###" tabindex="4"/>
</fieldset>
###ENDBLOCK###
<!-- ###TEMPLATE_FORM2_university### end -->






<!-- ###TEMPLATE_FORM3### begin -->
<!-- ###TEMPLATE_FORM5_university### begin -->

###STARTBLOCK###
<fieldset>
				<legend>###LLL:files###</legend>
<label for="picture" accesskey="p">###LLL:picture###:</label><br />
you are allowed to upload <b>###picture_numberOfAllowedFiles###</b> files.<br/>
you can upload <b>###picture_numberOfRemainingFiles###</b> more files.<br/>
allowed file types: <b>###picture_fileTypes###</b><br/>
<br/>
###error_picture###
###LLL:uploadedfiles###:<br/>
<b>###picture###</b><br/>
<input type="file" name="picture" id="picture" size="5" maxlength="3000000" accept="application/zip/image" tabindex="1"/>
###link_reload_start###upload file now###link_reload_stop###
<br/>

<input type="submit" ###submit_nextStep### value="###LLL:submit###" tabindex="2"/>
<input type="submit" ###submit_prevStep### value="###LLL:back###" tabindex="3"/>
</fieldset>
###ENDBLOCK###
<!-- ###TEMPLATE_FORM5_university### end -->
<!-- ###TEMPLATE_FORM3### end -->









<!-- ###TEMPLATE_FORM4_university_other### begin -->
###STARTBLOCK###
<fieldset>
				<legend>###LLL:something_else###</legend>
<label for="something" accesskey="s">###LLL:something###:</label><br />
###error_something###
<input type="text" name="something" id="something" value="###value_something###" tabindex="1"/>
<br />

<input type="submit" ###submit_nextStep### value="###LLL:next###" tabindex="2"/>
<input type="submit" ###submit_prevStep### value="###LLL:back###" tabindex="3"/>
</fieldset>
###ENDBLOCK###
<!-- ###TEMPLATE_FORM4_university_other### end -->







<!-- ###TEMPLATE_FORM4_university_mtd### begin -->
###STARTBLOCK###
<fieldset>
				<legend>###LLL:feedback###</legend>
<label for="code" accesskey="c">###LLL:code###:</label><br />
###error_code###
<input type="text" name="code" id="code" value="###value_code###" tabindex="1"/>
<br />
<label for="c" accesskey="f">###LLL:feedback###:</label><br />
###error_c###
<input type="checkbox" name="c[]" id="c_0" value="u rock!" ###checked_c_u rock!### tabindex="2"/><label for="c_0">###LLL:feedback_1###</label>
<input type="checkbox" name="c[]" id="c_1" value="details" ###checked_c_well### tabindex="3"/><label for="c_1">###LLL:feedback_2###</label>
<input type="checkbox" name="c[]" id="c_2" value="good" ###checked_c_good### tabindex="4"/><label for="c_2">###LLL:feedback_3###</label>
<input type="checkbox" name="c[]" id="c_3" value="ngood" ###checked_c_ngood### tabindex="5"/><label for="c_3">###LLL:feedback_4###</label>
<br />

<input type="submit" ###submit_nextStep### value="###LLL:next###" tabindex="6"/>
<input type="submit" ###submit_prevStep### value="###LLL:back###" tabindex="7"/>
</fieldset>
###ENDBLOCK###
<!-- ###TEMPLATE_FORM4_university_mtd### end -->








<!-- ###TEMPLATE_EMAIL_RECEIVER### begin -->
Form was submitted (Receiver):
surname: ###surname###
email: ###email###
education: ###education###
job: ###job###
picture: ###picture###
----------------------
<!-- ###TEMPLATE_EMAIL_RECEIVER### end -->




<!-- ###TEMPLATE_EMAIL_RECEIVER_HTML### begin -->
Form was submitted (Receiver):<br/>
surname: <b>###surname###</b><br/>
email: ###email###<br/>
education: ###education###<br/>
job: ###job###<br/>
picture: ###picture###<br/>
<!-- ###TEMPLATE_EMAIL_RECEIVER_HTML### end -->





<!-- ###TEMPLATE_EMAIL_USER### begin -->
Form was submitted (User):
surname: ###surname###
email: ###email###
education: ###education###
job: ###job###
picture: ###picture###
----------------------
<!-- ###TEMPLATE_EMAIL_USER### end -->






<!-- ###TEMPLATE_EMAIL_USER_HTML### begin -->
Form was submitted (User):<br/>
surname: <b>###surname###</b><br/>
email: ###email###<br/>
education: ###education###<br/>
job: ###job###<br/>
picture: ###picture###<br/>
<!-- ###TEMPLATE_EMAIL_USER_HTML### end -->





<!-- ###TEMPLATE_EMAIL_USER_university### begin -->
Form was submitted (User):
surname: ###surname###
email: ###email###
education: ###education###
job: ###job###
picture: ###picture###
----------------------
<!-- ###TEMPLATE_EMAIL_USER_university### end -->






<!-- ###TEMPLATE_EMAIL_USER_HTML_university### begin -->
Form was submitted (User):<br/>
surname: <b>###surname###</b><br/>
email: ###email###<br/>
education: ###education###<br/>
job: ###job###<br/>
picture: ###picture###<br/>
<!-- ###TEMPLATE_EMAIL_USER_HTML_university### end -->





<!-- ###TEMPLATE_SUBMITTED_OK### begin
  OPTIONAL - will be shown if form was submitted and all required fields were filled out
-->
<b>Thank you, your request will be answered soon.</b>
you have uploaded the following files:<br/>
###picture###<br/>
<!-- ###TEMPLATE_SUBMITTED_OK### end -->

<!-- ###TEMPLATE_ERROR### begin -->

	<!-- ###ERROR_START### begin -->
	<ul>
	<!-- ###ERROR_START### end -->
	
	<!-- ###ERROR_END### begin 
	this is used for the global error marker ###ERROR### -->
	</ul>
	<!-- ###ERROR_END### end -->
	
	<!-- ###ERROR_FILESIZE### begin 
	this is used if you use the file upload functionality -->
	<li>File is too large!</li><br/>
	<!-- ###ERROR_FILESIZE### end -->
	
	<!-- ###ERROR_FILETYPE### begin 
	this is used if you use the file upload functionality -->
	<li>File not allowed!</li><br/>
	<!-- ###ERROR_FILETYPE### end -->
	
	<!-- ###ERROR_EDUCATION### begin -->
	<li>Please select an education</li><br/>
	<!-- ###ERROR_EDUCATION### end -->
	
	<!-- ###ERROR_STUDY### begin -->
	<li>Please enter a field of study</li><br/>
	<!-- ###ERROR_STUDY### end -->

<!-- ###TEMPLATE_ERROR### end -->