What does it do?

This plugin allows you to limit the selectable dates in your Gravity Forms Datepicker fields. This plugin gives you granular control to manage the selectable date range with an easy-to-use user interface.

Features

Documentation

1. How do I enable this functionality?
2. Feature Details
   1. Minimum Date
      1. Date Modifier
   2. Maximum Date
   3. Days of the Week
   4. Exceptions
   5. Inline Date Picker
   6. Validation
   7. Timezones
3. Known Limitations
4. FAQs
   1. How can I exclude a blocked day from a Date Modifier?
   2. Can I automatically open the datepicker in Field B after the date has been selected in Field A?
   3. Does this work with the No Duplicates option?
   4. How can I pad the minimum date beyond the current weekend?
5. Hooks
6. Related Articles

How do I enable this functionality?

After installing and activating Gravity Forms Limit Dates, follow these steps to add a Date field and apply limits to it.

	Add a Date field to your form.
	Click on the Date field to open the field settings. Confirm that the Date Input Type is set to “Date Picker”. This is the only input type that will work with GP Limit Dates. By default, new Date fields will be assigned the “Date Picker” input type.
	Navigate to the Perks tab, and configure the Minimum Date, Maximum Date, Days of the Week, and Exceptions settings as desired.

Feature Details

Minimum Date

The minimum date setting allows you to specify the earliest possible date that can be selected in the date field. There are several types of values that are accepted.

• Date Field
  The earliest date selectable in the current Date field will automatically be adjusted based on the selected date in the specified Date field (i.e Start Date field can set the minimum date in the End Date field).
• Set Specific Date
  Specify a specific date which will be the earliest date selectable in the current Date field.
• Current Date
  The current date will be the earliest date selectable in the current Date field. This is a dynamic value and will automatically adjust to the current date with each new day.

Date Modifier

The Date Modifier settings allows you to modify the selected date by adding or subtracting days, weeks, months or years. The date modifier input is available when a Date field or the Current Date option is selected.

Examples

• Require date to be at least one week from the current date.

  Current Date +1 week

• Require date to be within the previous year from a user-selected date.

  Date field -1 year

• Require date to be at least three (3) days from the current date.

  Current Date +3 days

Maximum Date

See Minimum Date above. The same settings apply; however, the setting will impact the latest date selectable rather than the earliest date.

Days of the Week

The Days of the Week setting allows you to limit which dates are selectable based on the days of the week (a.k.a Monday – Sunday). By default, all days are allowed. Click All Days to select specific days that should be selectable. If Saturday and Sunday are selected, only dates that fall on Saturdays and Sundays will be selectable.

Exceptions

Exceptions allow you to negate the date limitations established in the other settings. An exception works with both selectable dates and unselectable dates. If the excepted date is selectable, it will now be unselectable. If the excepted date is unselectable, it will now be selectable.

For example, if Monday through Friday are selected for the “Days of the Week” setting but you would like to make allow a specific Saturday to be selectable, you can add an “exception” for that specific Saturday. Click the Add Exception button and select the desired date from the date picker.

Inline Date Picker

Instead of the drop-down picker you can display the inline calendar. Check Enable Inline Date Picker on the Perks tab to activate the feature.

As shown on the next screenshot, the inline date picker is initially displayed on the page and doesn’t close when you select dates.

Validation

Date fields limited by GP Limit Dates will be validated client-side and server-side. The client-side validation is relevant when users are manually entering dates in the Date field rather than selecting the date via the Date Picker. The client-side validation will notify the user that the entered Date is invalid; however, it will not prevent submission.

The server-side validation will return a validation error if an invalid date is submitted.

Timezones

When the Current Date option is selected for either the Minimum or Maximum Date settings, the current date will be calculated based on the timezone configured on your WordPress settings page. This prevents users in different timezones from selecting a day that has already passed in your timezone.

Known Limitations

• Exceptions cannot except a date before the Minimum date or after the Maximum date.

FAQs

How can I exclude a blocked day from a Date Modifier?

Install the following to automatically exclude blocked days from modifiers.

Can I automatically open the datepicker in Field B after the date has been selected in Field A?

Yep! Use the gpld_after_set_min_date hook as shown in this example.

Does this work with the No Duplicates option?

When the No Duplicates option is activated, values entered in a field must not already exist in another entry for that field. This is handled during form validation.

To automatically limit duplicate dates using No Duplicates, use this snippet. Any date that has already been submitted will automatically be limited in the datepicker when the form is loaded. Snippet installation instructions can be found in the snippet description.

How can I pad the minimum date beyond the current weekend?

We have a snippet that will automatically pad the minimum date if the form is submitted on the weekend. For example, if you have the minimum date set to Current Date +1 day and someone places an order on Saturday or Sunday, then they will only be allowed to select Tuesday or later.