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
- Minimum & maximum date range.
Set a minimum and maximum date range; manually, based on current date, or by date selected in another field. - Future/past dates only.
Require a date greater than the current day. - Limit by day of the week.
Specify which days of the week are selectable. - Add exceptions.
Specify exceptions for specific dates; make any date available or unavailable. - Linked date fields.
Date selected in one date field sets minimum (or maximum) date in another. - Timezone support.
Dates are automatically converted to WP-configured timezone. - Date modifiers.
Modify the min/max date limits by adding or subtracting days, weeks, months or years. - Inline datepicker.
The datepicker can be displayed inline in your form rather than as a popup. - Automatic validation.
Dates are validated even when entered manually; client-side and server-side. - Perk integrations.
Works well with Gravity Forms Read Only for enforcing use of the datepicker. - Easy-to-use UI.
Manage all settings with ease. - Automatic updates.
Get updates and latest features right in your dashboard. - Awesome support.
We’re here to help! And we mean it.
Documentation
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 weekRequire date to be within the previous year from a user-selected date.
Date field-1 yearRequire 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.
Hooks
- gpld_after_set_min_date (JS)
- gpld_disable_inline_date_picker_default_date
- gpld_invalid_date_error
- gpld_limit_dates_options
