Skip to content

Add conditions (via AJAX) to TYPO3 powermail forms for fields and pages

Notifications You must be signed in to change notification settings

in2code-de/powermail_cond

Repository files navigation

TYPO3 Extension powermail_cond

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

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

Screenshots

Example form with conditions

Backend view to records

Backend view to records with rule

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 for TYPO3 13 support

ℹ️ TYPO3 13 compatibility

See EAP page (DE) or EAP page (EN) for more information how to get access to a TYPO3 13 version

Changelog

Version Date State Description
13.0.0 tbs Feature Support Powermail 13 - planned
11.1.0 2023-10-16 Feature Support Powermail 11 & 12
11.0.0 2023-07-05 Feature Support Powermail 11
10.1.1 2023-03-23 Bugfix Fix possible undefined array key error
10.1.0 2023-03-14 Task Support all kind of powermail fields as with jQuery before (e.g. submit, text, etc...)
10.0.0 2022-10-10 Feature Support for Powermail 10 and remove of jQuery support
9.0.4 2022-10-10 Bugfix Allow multilanguage conditions
9.0.3 2022-07-05 Bugfix Fix ext_emconf.php for TER upload via REST API (another change)
9.0.2 2022-07-05 Bugfix Fix ext_emconf.php for TER upload via REST API
9.0.1 2022-07-04 Bugfix Fix page fieldset conditions not being applied correctly
9.0.0 2022-02-23 Feature Support for TYPO3 11 and Powermail 9
8.2.2 2021-11-22 Bugfix Reverted type change for field condition.target_field and updated index configuration for this field
8.2.1 2021-11-22 Bugfix Use integer field for condition.target_field
8.2.0 2021-11-22 Task Add mysql indices, hide children tables in list view, add code linting tests
8.1.1 2021-08-04 Task Simplify TCA to also fix the start/endtime bug in TYPO3 (last regression)
8.1.0 2021-03-18 Feature Add TER autodeployment, add extension key to composer.json, small doc fix
8.0.3 2020-04-30 Bugfix Enforce content-type in TypoScript
8.0.2 2020-04-30 Bugfix Also support checkboxes (array values) in powermail 8
8.0.1 2020-04-29 Task Add useless dependency to TYPO3 for TER upload
8.0.0 2020-04-29 Task Update extension for powermail 8 and TYPO3 10.4
7.0.0 2018-11-16 Task Update dependencies for powermail 7
6.1.0 2018-10-21 Task Remove deprecation warnings in TYPO3 9.5
6.0.0 2018-10-16 Task Support powermail 6.1
5.0.0 2018-05-24 Task Support powermail 6.0
4.1.1 2018-03-28 Bugfix Prevent exceptions in log
4.1.0 2018-01-29 Task Remove dependencies for TYPO3 7.6
4.0.0 2018-01-15 Task Update dependencies for powermail 5.0
3.5.2 2017-12-05 Bugfix Turn of ConditionAwareValitor on fields without page relations
3.5.1 2017-12-13 Bugfix Prevent exceptions in backend for MySQL strict mode
3.5.0 2017-11-13 Task Update dependencies for powermail 4.x
3.4.0 2017-08-14 Feature Allow all fieldtypes for target, add JS compression
3.3.4 2017-07-25 Bugfix Reduce unneeded calls in frontend
3.3.3 2017-06-12 Bugfix Small change for MySQL strict mode
3.3.2 2017-05-20 Bugfix TCA update for TYPO3 8.7
3.3.1 2017-04-25 Bugfix Fix package name in composer.json
3.3.0 2017-04-23 Task Move ext to github, make it fit for TYPO3 8.7 LTS

More to come soon?

  • Use vanilla JS instead of jQuery

Conflicts

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