.. include:: Images.txt
.. include:: ../../../Includes.txt

.. _prefillOrPreselectAField:

Prefill or preselect a field
----------------------------


.. _prefillOrPreselectAFieldStandard:

The standard way
^^^^^^^^^^^^^^^^

Prefilling (input, textarea, hidden) or preselecting (select, check, radio)
of fields will be done by the prefillFieldsViewHelper. It
listen to the following methods and parameters (in this ordering):

1. GET/POST param like **&tx\_powermail\_pi1[field][marker]=value**

2. GET/POST param like **&tx\_powermail\_pi1[marker]=value**

3. GET/POST param like **&tx\_powermail\_pi1[field][123]=value**

4. GET/POST param like **&tx\_powermail\_pi1[uid123]=value**

5. If field should be filled with values from FE\_User (see field configuration)

6. If field should be prefilled from static Setting (see field configuration)

7. Fill with TypoScript cObject like

.. code-block:: text

	plugin.tx_powermail.settings.setup.prefill {
		# Fill field with marker {email}
		email = TEXT
		email.value = mail@domain.org
	}

8. Fill with simple TypoScript like

.. code-block:: text

	plugin.tx_powermail.settings.setup.prefill {
		# Fill field with marker {email}
		email = mail@domain.org
	}

9. Fill with your own PHP with a Signal. Look at In2code\Powermail\ViewHelpers\Misc\PrefillFieldViewHelper::render()


Example markup
^^^^^^^^^^^^^^

|prefill_frontend_output|

.. _prefillOrPreselectASelectFieldTypoScript:

Generating select options out of TypoScript
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You can dynamicly generate a select field in powermail with some lines of TypoScript.
To use this feature, you have to leave the field "Options" empty and you should fill the field
"Create from TypoScript" with a TypoScriptObjectPath. See the following example:

|prefill_select_typoscript1|

|prefill_select_typoscript2|


Example 1
"""""""""

After this, you can define your TypoScript setup:

.. code-block:: text

	lib.options = TEXT
	lib.options.value = red[\n]blue[\n]pink

This will result in a HTML like:

.. code-block:: text

	<select ...>
		<option>red</option>
		<option>blue</option>
		<option>pink</option>
	</select>



Example 2
"""""""""

You can also define it with different labels and values:

.. code-block:: text

	lib.options = TEXT
	lib.options.value = Red shoes|red[\n]Blue shoes|blue|*[\n]Pink shoes|pink

This will result in a HTML like:

.. code-block:: text

	<select ...>
		<option value="red">Red shoes</option>
		<option value="blue" selected="selected">Blue shoes</option>
		<option value="pink">Pink shoes</option>
	</select>



Example 3
"""""""""

Or maybe the visitor should select a category from table sys_category:

.. code-block:: text

	lib.options = CONTENT
	lib.options {
		table = sys_category
		select.pidInList = 156
		renderObj = COA
		renderObj {
			10 = TEXT
			10.field = title

			20 = TEXT
			20.value = |

			30 = TEXT
			30.field = uid

			stdWrap.wrap = |[\n]
		}
	}

This will result in a HTML like:

.. code-block:: text

	<select ...>
		<option value="23">Category 1</option>
		<option value="24">Category 1</option>
		<option value="25">Category 1</option>
	</select>