Download the PHP package silverware/calendar without Composer
On this page you can find all versions of the php package silverware/calendar. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download silverware/calendar
More information about silverware/calendar
Files in silverware/calendar
Package calendar
Short Description SilverWare Calendar Module.
License BSD-3-Clause
Homepage https://github.com/praxisnetau/silverware-calendar
Informations about the package calendar
SilverWare Calendar Module
A date and time picker module for SilverStripe v4 which adds flatpickr to
standard SilverStripe DateField
, DatetimeField
and TimeField
instances.
Contents
- Requirements
- Installation
- Configuration
- Usage
- Issues
- Contribution
- Attribution
- Maintainers
- License
Requirements
Installation
Installation is via Composer:
Note: forms on the website will automatically make use of the datepicker if the app is using SilverWare. If you are using a vanilla SilverStripe project, you'll need to load the module script and styles in your app bundle (jQuery is required):
silverware/calendar: client/dist/js/bundle.js
silverware/calendar: client/dist/styles/bundle.css
Configuration
As with all SilverStripe modules, configuration is via YAML. Extensions to LeftAndMain
and
ContentController
are applied via config.yml
.
Highlight Color
The module supports a custom highlight color for both the CMS and forms on the website. To define the highlight color, use the following YAML configuration:
Datepicker Class
SilverStripe will not apply it's own JavaScript to form fields which have a certain datepicker class. To prevent conflicts, use the following configuration to define the class which SilverStripe will detect:
Disabling via Configuration
If you need to disable the datepicker for all instances of a certain form field, use the following configuration:
Usage
Out of the box, the module will automatically add a flatpickr to
all DateField
, DatetimeField
and TimeField
instances. Each field will
be configured automatically with default settings for each use case.
If you need to apply additional options supported by flatpickr, you
can do so by using the setCalendarConfig()
method:
In addition to accepting an array, the setCalendarConfig()
method also supports
the setting of individual config settings:
To see a full list of the supported options, please refer to the flatpickr documentation.
Disabling by Instance
If you need to disable the datepicker for a particular field instance,
as opposed to all instances, you may call the setCalendarDisabled()
method
on the field:
Issues
Please use the GitHub issue tracker for bug reports and feature requests.
Contribution
Your contributions are gladly welcomed to help make this project better. Please see contributing for more information.
Attribution
- Makes use of flatpickr by Gregory Petrosyan and others.
Maintainers
Colin Tucker | Praxis Interactive |
License
BSD-3-Clause © Praxis Interactive