This module provides a date picker field widget for Drupal, integrating the popular bootstrap-datepicker JavaScript library. It allows users to select dates with various customizable options for formatting, language, and calendar appearance.
Drupal date picker. Implements https://github.com/uxsolutions/bootstrap-datepicker as a field widget for a date field.
Supported options:
- Date picker title
- Date format
- Language tag
- RTL language
- Show week days
- Show today button
- Week start
- Enable auto close
- Show clear button
- Nearby year assumption
- Container to be appended
- Show calendar weeks
- Toggle active date
- Dates disabled
- Disabled days in week
- Highlighted days in week
- Disable touch keyboard
- Enabled when readonly
- End date
- Force date parcing
- Immediate updates
- Keep empty values
- Keyboard navigation
- Max view mode
- Min view mode
- Orientation
- Start date
- Start view
- Highlight today
- Update view date
- Z-index offset
Module installation
Install Drupal module as usual. Visit https://www.drupal.org/docs/extending-drupal/installing-modules for further information.
Library installation
You can download the library or use composer.
Make sure the library is placed into: "/libraries/bootstrap-datepicker" and the file structure is as following: "/libraries/bootstrap-datepicker/dist/js/bootstrap-datepicker.min.js"
To make it work with composer:
Add the following to your composer.json file into the repositories section:
{
"type": "composer",
"url": "https://asset-packagist.org"
}
And extend the 'installer-path' section:
"web/libraries/{$name}": [
"type:drupal-library",
"type:bower-asset",
"type:npm-asset"
],And add a new 'installer-types' section next to the 'installer-path' in the 'extra' section:
"installer-types": ["bower-asset", "npm-asset"],
Known problems
The widget only works for "date" fields at this moment. Data-time support or repeated dates support has to be added. Feel free to open a feature request with a patch.
Similar projects
There are many other date widget modules. All implementing an other javascript library.
We want to thank all other maintainers for their effort and the code they wrote. We based some of our features on code written by them.