Skip to main content
Version: 4.4

Userstate Form Field

The userstate form field type provides a list box of statuses associated with the enabled state of a user. This field extends PredefinedlistField and is used in the Manage Users filter fields.

  • type (mandatory) must be userstate.
  • name (mandatory) is the unique name of the field.
  • label (mandatory) (translatable) is the field html label.
  • description (optional) (translatable) is the field description.
  • required (optional) if set to true, the first field option should be empty, see last example.

Implemented by: libraries/src/Form/Field/UserstateField.php

Example XML parameter definition

<field
name="mystate"
type="userstate"
label="Choose"
description=""
/>

Based on the source code this returns the following entries in a list:
0 - Enabled - JENABLED
1 - Disabled - JDISABLED