Legacy Format

This manual has been automatically converted from an OpenOffice document. It is a legacy format that does not support all features of a modern documentation. Learn how to update this manual

FAQ:ref:

Can I use old mails in powermail 2.0?:ref:

Question

Can I use old mails in powermail 2.0?

Possible

No

Explanation

It's not possible to use old powermail mails with the new module. At the moment there is no update script.

Can I use old forms in powermail 2.0?:ref:

Question

Can I use old forms in powermail 2.0?

Possible

No

Explanation

It's not possible to use old powermail forms with the new module. At the moment there is no update script.

How to use another Captcha Extension?:ref:

Question

How to use another Captcha Extension?

Possible

No

Explanation

At the moment we support only a calculating captcha in the powermail core. Maybe other extensions in a later version.

How to save values to tt_address, fe_users, tt_news, etc...?:ref:

Question

How to save values to tt_address, fe_users, tt_news, etc...?

Possible

Yes

Explanation

It's very easy to save values to a third-party-table – see manual part “For Administrators / Good to know / Saving Values to Third Party Table”

How to write my own javascript/php validator?:ref:

Question

How to write my own javascript/php validator?

Possible

Yes

Explanation

Write your own validator – see manual part “For Developers / Write own JavaScript Validatior” and “For Developers / Write own PHP Validation”

How to add attached files to any mail?:ref:

Question

How to add attached files to any mail?

Possible

Yes

Explanation

You can simply add some files to any mail via TypoScript cObject – see TypoScript Main Template for details.

Short example:

plugin.tx_powermail.settings.setup.sender {
  addAttachment = TEXT
  addAttachment.value = fileadmin/file.pdf
}

How can the admin confirm a mail from Double-Opt-In?:ref:

Question

How can the admin confirm a mail from Double-Opt-In?

Possible

Yes

Explanation

Per default the confirmation Email (if Double-Opt-In is enabled) will be sent to the sender.

You can overwrite it via TypoScript. See TypoScript Main Template for details.

Short example:

plugin.tx_powermail.settings.setup.optin {
  overwrite.email = TEXT
  overwrite.email.value = admin@domain.org
}

How to prevent Spam or to change the Spam-Prevention-Settings?:ref:

Question

How to prevent Spam or to change the Spam-Prevention-Settings?

Possible

Yes

Explanation

Powermail in version 2 comes with a lot of spam-prevention-methods along. You can use the integrated spamshield (configuration via constants and typoscript) or captcha. See TypoScript Main Template for details.

How can I set some advanced mail settings (like priority or:ref:

Question

How can I set some advanced mail settings (like priority or returnPath, etc...)?

Possible

Yes

Explanation

You can change following settings for the mail to the receiver and to the sender completely via TypoScript. See TypoScript Main Template for details.

- email

- name

- senderName

- senderEmail

- subject

- cc Receivers

- bcc Receivers

- returnPath

- reply to email

- reply to name

- priority

How to change the style selector with my own values (In Forms, Pages:ref:

Question

How to change the style selector with my own values (In Forms, Pages or Fields)?

Possible

Yes

Explanation

<select>
        <option value=”layout1”>Layout1</option>
        <option value=”layout2”>Layout2</option>
        <option value=”layout3”>Layout3</option>
</select>
TCEFORM {
   tx_powermail_domain_model_forms {
      css {
         removeItems = layout1, layout2, layout3

         addItems {
            blue = Blue Form
            green = Green Form
         }
      }
   }

   tx_powermail_domain_model_pages < tx_powermail_domain_model_forms

   tx_powermail_domain_model_fields < tx_powermail_domain_model_forms
}
<select>
        <option value=”blue”>Blue Form</option>
        <option value=”green”>Green Form</option>
</select>

And adds the class “blue” or “green” to all forms, pages and fields in the Frontend.

img-93

How to prefill a field in the powermail form?:ref:

Question

How to prefill a field in the powermail form?

Possible

Yes

Explanation

Prefilling of fields will be done by the prefillFieldsViewHelper. It listen to the following methods and parameters:

  1. GET/POST param like &tx_powermail_pi1[marker]=value
  2. GET/POST param like &tx_powermail_pi1[field][123]=value
  3. GET/POST param like &tx_powermail_pi1[uid123]=value

4. If field should be filled with values from FE_User (Flexform Settings)

  1. If field should be prefilled from static Flexform Setting
  2. Fill with TypoScript cObject like
plugin.tx_powermail.settings.setup.prefill {
   # Fill field with marker {email}
   email = TEXT
   email.value = mail@domain.org
}
  1. Fill with TypoScript like
plugin.tx_powermail.settings.setup.prefill {
   # Fill field with marker {email}
   email = mail@domain.org
}

How is JavaScript included to Powermail?:ref:

Question

How is JavaScript included to Powermail?

Possible

Yes

Explanation

Powermail loads jQuery and jQuery UI by default from googleapis.com. You can change that behaviour with constants or typoscript.

Responsible TypoScript for the include of JS and CSS:

page {
        # Inlude JavaScript files
        includeJSFooterlibs {
                powermailJQuery = {$plugin.tx_powermail.settings.javascript.powermailJQuery}
                powermailJQuery.external = 1
                powermailJQueryUi = {$plugin.tx_powermail.settings.javascript.powermailJQueryUi}
                powermailJQueryUi.external = 1
                powermailJQueryUiDatepicker = EXT:powermail/Resources/Public/Js/jquery.ui.datepicker.min.js
                powermailJQueryFormValidationLanguage = EXT:powermail/Resources/Public/Js/jquery.validationEngine-en.js
                powermailJQueryFormValidation = EXT:powermail/Resources/Public/Js/jquery.validationEngine.js
                powermailJQueryTabs = EXT:powermail/Resources/Public/Js/tabs.js
        }
        includeJSFooter {
                powermailForm = EXT:powermail/Resources/Public/Js/form.js
        }

        # Include CSS files
        includeCSS {
                powermailJQueryUiTheme = EXT:powermail/Resources/Public/Css/jquery.ui.theme.css
                powermailJQueryUiDatepicker = EXT:powermail/Resources/Public/Css/jquery.ui.datepicker.css
        }
}

You can change this by overwriting some or all lines in your TypoScript.

How can I disable the including of jQuery?:ref:

Question

How can I disable the including of jQuery?

Possible

Yes

Explanation

Maybe you already included jQuery on every of your pages. So powermail should not include it twice. Overwrite it with TypoScript Setup:

page.includeJSFooterlibs.powermailJQuery >
page.includeJSFooterlibs.powermailJQueryUi >

How can I use t3jquery?:ref:

Question

How can I use t3jquery?

Possible

No

Explanation

You can manually disable the including of the libraries from google (see line above) and force to use jQuery from t3jquery (see manual of that extension)

JavaScript validation don't work – what's wrong?:ref:

Question

JavaScript validation don't work – what's wrong?

Possible

Explanation

At the moment we do not use t3jquery. Powermail loads jQuery and jQuery UI by default from googleapis.com. You can change that behaviour with constants or typoscript.

It's importand to have the correct ordering of the JavaScript files. First you need the libraries and after that your JavaScript.

Check the correct including of your JavaScript in the HTML source – example Footer could be:

<script src="https://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js" type="text/javascript"></script>
<script src="https://ajax.googleapis.com/ajax/libs/jqueryui/1/jquery-ui.min.js" type="text/javascript"></script>
<script src="typo3conf/ext/powermail/Resources/Public/Js/jquery.ui.datepicker.min.js?1336555116" type="text/javascript"></script>
<script src="typo3conf/ext/powermail/Resources/Public/Js/jquery.validationEngine-en.js?1336586579" type="text/javascript"></script>
<script src="typo3conf/ext/powermail/Resources/Public/Js/jquery.validationEngine.js?1336586579" type="text/javascript"></script>
<script src="typo3conf/ext/powermail/Resources/Public/Js/tabs.js?1336555116" type="text/javascript"></script>
<script src="typo3conf/ext/powermail/Resources/Public/Js/form.js?1336555115" type="text/javascript"></script>

I want to have automatic export files with the scheduler module –:ref:

Question

I want to have automatic export files with the scheduler module – what's wrong?

Possible

No

Explanation

In powermail 1.4 up to 1.7 it was possible to get automatic export files from a cli script or from the scheduler. This feature is not yet integrated in version 2.0.

Marketing Information are not working – what's wrong?:ref:

Question

Marketing Information are not working – what's wrong?

Possible

Yes

Explanation

Did you include the marketing static template on the root page of your domain?

I want to add a new Field Type to powermail – how can I do this:ref:

Question

I want to add a new Field Type to powermail – how can I do this

Possible

Yes

Explanation

You can add a new Fieldtype (in record tx_powermail_domain_model_fields) with some Page TSConfig. See following example to add a new fieldtype with Partial Newfield.html

tx_powermail.flexForm.type.addFieldOptions.newfield = New Field Name

I have a problem, what can I do?:ref:

Question

I have a problem, what can I do?

Possible

Yes

Explanation

- Did you read the manual?

- Turning on the Debug Output in Powermail (via TypoScript) can solve some problems

- Try to get free help from a TYPO3 Forum like (typo3.net or typo3forum.net)

- Did you need payed support? Ask the author www.in2code.de for it.

- Did you found a bug? Report it to http://forge.typo3.org/projects /extension-powermail/issues

- Did you miss a feature? Ask the author www.in2code.de for it.