Skip to main content
Version: 5.3 (Upcoming)

Registrationdaterange Form Field

The registrationdaterange form field type provides a list box of date ranges which is used by the administrator com_users functionality, within the Manage Users filter fields. This field extends PredefinedlistField.

  • type (mandatory) must be registrationdaterange.
  • name (mandatory) is the unique name of the field.
  • label (mandatory) (translatable) is the field html label.
  • description (optional) (translatable) is the field description.
  • multiple (optional) if set to true allows multiple items to be selected at the same time. Set to false to allow single selection.
  • required (optional) if set to true, the first field option should be empty, see last example.

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

Example XML parameter definition​

<field
        name="mystatus" 
        type="registrationdaterange"
        label="Choose" 
        description=""
/>

This returns the following entries in a list:
'today',
'past_week',
'past_1month',
'past_3month',
'past_6month',
'past_year',
'post_year'