fiProcessArrays
Last updated Apr 30th, 2019 | Page history | Improve this page | Report an issue
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$311 per month—let's make that $500!
Learn morefiProcessArrays concatenates array values into strings so that they can be used in an email report.
Some (later?) versions of FormIt handle array values already, but fiProcessArrays can be useful if you need extra customization or if have any trouble with multiple checkboxes not showing up in fiGenerateReport.
To use, call the fiGenerateReport hook before the hooks that would use the converted values (such as "fiGenerateReport" and/or "email").
[[!FormIt?
&hooks=`math,spam,fiProcessArrays,fiGenerateReport,email,redirect`
...
&figrExcludedFields=`op1,op2,operator,math`
]]
Available Properties¶
The following parameters can be passed to the FormIt call:
Name | Description | Default Value | Version Added |
---|---|---|---|
fipaTpl | Optional chunk to pass each value of each field through. You can use placeholders [[+name]] and [[+value]] for the field name and field value. |
1.1.1 | |
fipaWrapTpl | Optional chunk called for each field, but only if there are values. It uses a single placeholder: [[+values]] |
nospam,blank,recaptcha_challenge_field,recaptcha_response_field | 1.1.1 |
fipaFieldSuffix | The suffix to append to each array field name with the results of the array concatenation. For example, if the suffix is "_values" and the array field name is "colors[]", the placeholder available on your FormIt email report is [[+colors_values]] |
_values | |
fipaValueSeparator | The placeholder to use for the output. | (empty) if a fipaTpl is set, otherwise ',' (comma) | 1.1.1 |
fipaList | A shortcut to generate an HTML bulleted list of each field name. Wraps each array value in and all of the values for a field in | False | |
fipaExcludedFields | List of field names for which to not process array values. |