README

Conditions for TYPO3 extension powermail. While a user fills out a form, some fields should disappear, while others should be visible.

⚠️ TYPO3 12 compatibility
See EAP page (DE) or EAP page (EN) for more information how to get access to a TYPO3 12 version

Screenshots

List of Conditions you can apply on the powermail form fields

is set
is not set
contains value
contains value not
is
is not
is greater than (numbers only)
is less than (numbers only)
contains value from field
contains not value from field

Quick installation

Quick guide:

Just install this extension - e.g. composer require in2code/powermail_cond
Clear caches
Add a powermail form to any page
Add a new record from type "condition container" to a sysfolder and configure it
Don't forget to include the static template from powermail_cond
Don't forget to add jQuery to your frontend (if not yet installed)

Example routing configuration for TypeNum 3132:

...
rootPageId: 1
routes:
  -
    route: robots.txt
    type: staticText
    content: "Disallow: /typo3/\r\n"
routeEnhancers:
  PageTypeSuffix:
    type: PageType
    default: /
    index: ''
    suffix: /
    map:
      condition.json: 3132
...

Local Development and Contribution

There is a docker based local development environment available. See Readme.md for more information.

Less flickering

To prevent the flickering that occurs when loading a form with conditions the usually asynchronously loaded "condition JSON" can be rendered directly into the HTML source code via this viewhelper in your copy of EXT:powermail/Resources/Private/Templates/Form/Form.html

{namespace pc=In2code\PowermailCond\ViewHelpers}
<script type="application/json" id="form-{form.uid}-actions">{pc:conditions(form:form) -> f:format.raw()}</script>
<style type="text/css">
    .powermail_fieldset {
        opacity: 0;
        visibility: hidden;
        transition: opacity 0.5s, visibility 0.5s;
    }
</style>

This way the initial asynchronous call will be skipped which reduces the flickering to a minimum.

Early Access Programm (EAP)

You can support the development via our EAP on https://www.in2code.de/en/agency/typo3-extensions/early-access-program/ Also official (fee-based) support is possible within the EAP.

This is the current status of the EAP features:

Changelog

More to come soon?

Use vanilla JS instead of jQuery

Conflicts

It's not possible to use powermail multistep forms with powermail_cond

in2code / powermail_cond

Maintainers

Details