typo3.org: Documentation: powermail (powermail)

1.10. FAQ

I need help/support with this plugin!

Use the TYPO3 forum http://www.typo3.net or http://www.typo3forum.net for help! The author will checks this both forums and give a little bit free support.

How can I prefill some fields?

Prefill with values from backend or
Prefill with feuser values (set in backend)
Prefill if some fields are already filled and than the user submits form and leaves this page but comes back to the form page later
Prefilling from outside like index.php?id=1&tx_powermail[uid55] (if you want to prefill with a pre form)

Error in backend “Unknown type: inline” - what to do?

Deactivate IRRE and set the relations manually!

If you have already deactivated IRRE or use TYPO3 < 4.1, don't care about this error – set the relations manually via list modul

How can I overwrite the locallang translations / How can I add a new locallang marker

You can overwrite the locallang via typoscript or you can change the locallang.xml in the ext folder.

Details - see “HTML Templates and markers use” in manual above

How can I use validation of fields per Javascript?

This check is activated for default for textfields

You can turn of the validation via TS constants

JavaScript check don't work - why?

Check if the 4 js files are correctly implemented in the HTML HEAD area:

<script src="typo3conf/ext/powermail/js/mandatoryjs/lib/prototype.js" type="text/javascript"></script>
<script src="typo3conf/ext/powermail/js/mandatoryjs/src/effects.js" type="text/javascript"></script>
<script src="typo3conf/ext/powermail/js/mandatoryjs/fabtabulous.js" type="text/javascript"></script>
<script src="validation/fachgebiete/typo3-extensions/powermail.html" type="text/javascript"></script>

The last file is a little bit tricky – It is the current page with type=3131. If you copy this relative path to your browser, this should show you a dynamic JavaScript file!

If you want to check of mandatory fields, check if “required” is in the input class.If you want to check of email fields, check if “validate-email” is in the input class.Of course you can mix this.See standard form for all needed classes.

How can a style my form?

All can be done with css. Note: If you only need one page (no multiple page), you can anyway add more than only one fieldset. So you can float fieldsets horizontal (e.g.).

Note1: See “CSS corner” for css examples below

Note2: We offer a sample css in the extension folder: ext/powermail/css/sampleCSS.css

Note3: Have a look into an existing powermail example and copy the css of this homepage (examples are listed above)

HTML Validation vailed

HTML validation failed on such form action:

index.php?id=1&tx_powermail_pi1[mailId]=1&cHash=1234567

Try to use RealUrl to remove cHash
If you have chosen XHTML strict in your TYPO3 backend, the & will be written as &

How can I choose my own html code instead of the automatic html generation

Sometimes it could be useful to use an own html code instead of the automatic html code. You can simply generate some fields and copy the html source between the form tags in the formwrap.html template – thats all.

Note: This method is not very flexible (no prefilling, no multiple, etc...)

POWERMAIL ERROR: No title to current field found in DB (uidXX)

If you are installing powermail and fill out the form (submit) and you will delete a field after this, the field value is still set in the session.

Just delete the current FE cookie in your browser or close and re-open your browser and fill out the form again – that's all!

I want a select box in frontend where the user can choose the receiver of the form

Main explanation:

Add new fe_users in backend with email (e.g. UID1 info@test.com and UID2 with support@test.com)
Create a new select field in powermail (value e.g. Info | 1 \n Support | 2) (select like ###UID42#)
Use db query for recipients in TYPO3 backend (e.g. SELECT email FROM fe_users WHERE uid = ###UID42###)

Example pictures:

Different Examples to select receiver in frontend:

Query for selecting one fe user (e.g.: UID42 is fe_user uid):

SELECT email FROM fe_users WHERE uid = ###UID42### AND hidden = 0 AND deleted = 0

Query for selecting a fe usergroup (e.g.: UID43 is fe_user group uid):

SELECT email FROM fe_users WHERE find_in_set(###UID43###,usergroup) > 0 AND hidden = 0 AND deleted = 0

Query for sending form to a static fe usergroup (e.g.: usergroup with uid 44)

SELECT email FROM fe_users WHERE find_in_set(44,usergroup) > 0 AND hidden = 0 AND deleted = 0

I will check some fields (with php) if the value is an email or an URL

plugin.tx_powermail_pi1 {

validate.uid41.auto = email

validate.uid41.errormsg = Please check your email, there is an error!

validate.uid56.auto = url

validate.uid56.errormsg = Please check your url, there is an error!

}

Details or how to use own regulare expression see above!

I want to use captcha but no captcha field is shown

Maybe you have installed and loaded the extension captcha and in constants is set sr_freecap (standard) instead of captcha.

There is a problem with content elements like text/image / dividers2tab problem

We know about this problem and there is an entry in the typo3 bugtracker:

http://bugs.typo3.org/view.php?id=7297

Workarround: You can disable dividers2tab in the extension manager of powermail, so tt_content is without dividers2tab (but powermail too)