Date

The Date element is a form element that lets the user enter a date.

Date element example

Settings

Basic

Label

Sets the label of the element.

Description

Sets description text to display below or above the field.

Required

Sets the field to be required, i.e. the user must complete this field.

Styles

Label icon

Choose an icon to display in the label.

Field icons

Choose icons to display on the left or right side of the field.

Field size

Sets the vertical height (using padding) and font size of the field.

Field width

Sets the width of the field, choose one of the preset sizes or choose a custom width.

Field custom width

If Field width is set to Custom enter a custom width using any CSS value.

Custom CSS class

Add a custom CSS class to the field, or multiple classes separated by a space.

CSS styles

Add custom CSS styles to any part of this element by clicking Add a style, choose the selector that the style should apply to and enter the CSS into the box.

Labels

Placeholder

Sets the placeholder text, which is text inside the field that is visible before the user enters a value.

Sub label

Sets a small text label below the field.

Admin label

Sets the admin label which allows you to have different label text for the element when viewing entries and within notification emails than the label text shown in the form.

Tooltip text

Sets the tooltip text which is shown in a small popup when the user interacts with the tooltip trigger.

Tooltip trigger

Choose what the user will be interacting with to show the tooltip, the choices are Field, Icon, or Inherit which will inherit the setting from the parent Group, Page or Form setting.

Tooltip event

Choose the event that will trigger the tooltip to show, the choices are Hover, Click, or Inherit which will inherit the setting from the parent Group, Page or Form setting.

Label position

Choose where to display the label relative to the field, the choices are Above, Left, Inside, or Inherit which will inherit the setting from the parent Group, Page or Form setting.

Label width

If the Label position is set to Left enter a custom label width using any CSS value.

Logic

Enable conditional logic

Enable or disable the conditional logic for this element.

Logic rules

Add a logic rule to this element by clicking Add logic rule, then choose the element, operator and value that will trigger the rule.

Data

Default value

Sets the default value of the element, which is the value that the field has when the form is first displayed. The date should be entered in the format YYYY-MM-DD, for example 2018-04-26. The variable {today} can be used to use the current date, this variable also supports modifiers such as {today|+2 days}.

Dynamic default value

Enable or disable the dynamic default value for this element. This option allows the field value to be set from URL parameter, shortcode attribute or filter hook.

URL parameter

The default value of this field can be set from a URL parameter. Once the Parameter name field has been set, add the parameter name and value to the URL. For example:

https://www.example.com/my-form?my_parameter=2018-04-26

Assuming the Parameter name field has the value my_parameter the field value will now be 2018-04-26. If the URL already contains a question mark (?) use an ampersand (&) to add new URL parameter.

https://www.example.com/?p=1&my_parameter=2018-04-26
Shortcode attribute

The default value of this field can be set form a shortcode attribute. Once the Parameter name field has been set, add a new shortcode attribute named values then add the parameter name and value to this new attribute.

[quform id="1" name="Contact form" value="my_parameter=2018-04-26"]

Multiple parameter should be separated by &

[quform id="1" name="Contact form" value="my_parameter=2018-04-26&my_parameter_2=Bar"]
Filter hook

The default value of this field can be set from a filter hook using PHP code, this will take precedence over the other methods. Add the following code to the WordPress theme functions.php file (or create a plugin for it).

12
3
add_filter('quform_element_value_my_parameter', function ($value) {    return '2018-04-26';
});
add_filter('quform_element_value_my_parameter', function ($value) {
    return '2018-04-26';
});
  • On line 1, replace my_parameter with the Parameter name

Parameter name

Sets the name of the parameter to use as the source of the dynamic default value.

Date range

Sets the minimum and maximum dates that can be selected. The variable {today} can be used to use the current date, this variable also supports modifiers such as {today|+2 days}.

Start view

Sets the default view of the datepicker calendar.

View depth

Specifies the depth of the view that should trigger choosing a date. For example, if the Start view and View depth are set to Months of the year and the Date format (JS) is set to MM/yyyy and the Date format (PHP) is set to m/Y the field can be used to accept a month instead of a date.

Show a link to choose today’s date in the footer of the datepicker, clicking it will set the field value to today.

Locale

Sets the locale of the datepicker, which will translate the datepicker and set the date format according to regional standards. If set to Default it will use the Locale from Edit Form → Settings → Language.

Date format (JS)

The format of the date when displayed in the form. If empty, the global setting will be used or the Locale will determine the date format according to regional standards. See this page for how to set a custom date format.

Date format (PHP)

The format of the date when displayed in notifications and when viewing entries. If empty, the global setting will be used or the Locale will determine the date format according to regional standards. See this page for how to set a custom date format.

Auto open datepicker

If enabled, the datepicker will be opened automatically when the user interacts with the field.

Read only

If enabled, the user will be unable to type in the field but will still be able to choose a date using the datepicker.

Show in email

If enabled, the submitted element data will be shown in the default notification email.

Save to database

If enabled, the submitted element data will be saved to the database and shown when viewing an entry.

Advanced

Unique ID

The unique element identifier is displayed here, you may need this for advanced usage.

Visibility

Sets the element to only be visible when viewing/editing entries (Admin only), or only visible to logged in or logged out users.

Validators

Add validators to the element which checks whether the data entered by the user is valid and displays an error message if it’s not valid. Available validators for this element are listed below.

  • In Array – checks that the value is in a list of allowed values (can be inverted)
  • Prevent Duplicates – checks that the same value has not already been submitted

Translations

You can translate the text of any relevant settings here.

Still having trouble? Head over to the forums.

Forums