Skip to content

Form field: compare submitted value

Plugin ID: eca_form_field_value

Available since: 1.0.0

Compares a submitted form field value.

Fields

Field value — config key: field_value

The field value to compare.
This field supports tokens.

Type: textarea · Required: no · Default: empty string

Field name — config key: field_name

The input name of the form field. This is mostly found in the "name" attribute of an <input> form element. For submit buttons within content forms: Use "submit" for the labeled "Save" button, and "preview" for the labeled "Preview" button.
This field supports tokens.

Type: textfield · Required: yes · Default: empty string

Strip tags — config key: strip_tags

Whether stripping all HTML and PHP tags or not.

Type: checkbox · Required: no · Default: true

Trim — config key: trim

Whether stripping all whitespaces at the beginning and end or not.

Type: checkbox · Required: no · Default: true

Filter XSS — config key: xss_filter

Additionally filters out possible cross-site scripting (XSS) text.

Type: checkbox · Required: no · Default: true

Comparison operator — config key: operator

The available comparison operators like equals or less than.
When using the "Defined by token" option, make sure there is a token with this name: eca_form_field_value_operator

Type: select · Required: no · Default: equal

Allowed values: equal, beginswith, endswith, contains, greaterthan, lessthan, atmost, atleast, _eca_token, ''

Comparison operator. Possible values:

  • equal
  • greater than
  • less than
  • starts with
  • ends with
  • contains
  • at least
  • at most
Comparison type — config key: type

The type of the comparison.
When using the "Defined by token" option, make sure there is a token with this name: eca_form_field_value_type

Type: select · Required: no · Default: value

Allowed values: value, natural, numeric, lexical, count, _eca_token, ''

Case sensitive comparison — config key: case

Compare the values based on case sensitivity.

Type: checkbox · Required: no · Default: false

Negate the condition — config key: negate

Negates the condition. Makes TRUE to FALSE and vice versa.

Type: checkbox · Required: no · Default: false