Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/2amigos/yii2-date-picker-widget
Bootstrap DatePicker Widget for Yii2
https://github.com/2amigos/yii2-date-picker-widget
2amigos datepicker widget yii2
Last synced: 3 months ago
JSON representation
Bootstrap DatePicker Widget for Yii2
- Host: GitHub
- URL: https://github.com/2amigos/yii2-date-picker-widget
- Owner: 2amigos
- License: other
- Archived: true
- Created: 2014-04-02T20:23:51.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2019-08-06T16:05:30.000Z (over 5 years ago)
- Last Synced: 2024-09-23T22:02:36.176Z (3 months ago)
- Topics: 2amigos, datepicker, widget, yii2
- Language: PHP
- Homepage: https://2amigos.us
- Size: 98.6 KB
- Stars: 130
- Watchers: 29
- Forks: 77
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
Bootstrap DatePicker Widget for Yii2
====================================
[](https://github.com/2amigos/yii2-date-picker-widget/tags)
[](LICENSE.md)
[](https://travis-ci.org/2amigos/yii2-date-picker-widget)
[](https://scrutinizer-ci.com/g/2amigos/yii2-date-picker-widget/code-structure)
[](https://scrutinizer-ci.com/g/2amigos/yii2-date-picker-widget)
[](https://packagist.org/packages/2amigos/yii2-date-picker-widget)
Renders a [Bootstrap DatePicker plugin](http://bootstrapformhelpers.com/datepicker/).
Installation
------------
The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
Either run
```bash
$ composer require 2amigos/yii2-date-picker-widget:~1.0
```
or add
```json
"2amigos/yii2-date-picker-widget" : "~1.0"
```
to the require section of your application's `composer.json` file.
Usage
-----
The widget comes in two flavors:
- DatePicker
- DateRangePicker
**DatePicker**
This widget renders a Bootstrap DatePicker input control. Best suitable for model with date string attribute.
***Example of use with a form***
There are two ways of using it, with an `ActiveForm` instance or as a widget setting up its `model` and `attribute`.
```php
= DatePicker::widget([
'model' => $model,
'attribute' => 'date',
'template' => '{addon}{input}',
'clientOptions' => [
'autoclose' => true,
'format' => 'dd-M-yyyy'
]
]);?>
= $form->field($model, 'date')->widget(
DatePicker::className(), [
// inline too, not bad
'inline' => true,
// modify template for custom rendering
'template' => '
{input}',
'clientOptions' => [
'autoclose' => true,
'format' => 'dd-M-yyyy'
]
]);?>
```
***Example of use without a model***
```php
= DatePicker::widget([
'name' => 'Test',
'value' => '02-16-2012',
'template' => '{addon}{input}',
'clientOptions' => [
'autoclose' => true,
'format' => 'dd-M-yyyy'
]
]);?>
```
**DateRangePicker**
This widget renders a Bootstrap DateRangePicker Input control.
***Example of use with a form***
The following example works with a model that has two attributes named `date_from` and `date_to`.
```php
= $form->field($tour, 'date_from')->widget(DateRangePicker::className(), [
'attributeTo' => 'date_to',
'form' => $form, // best for correct client validation
'language' => 'es',
'size' => 'lg',
'clientOptions' => [
'autoclose' => true,
'format' => 'dd-M-yyyy'
]
]);?>
```
***Example of use without a model***
```php
= DateRangePicker::widget([
'name' => 'date_from',
'value' => '02-16-2012',
'nameTo' => 'name_to',
'valueTo' => '02-20-2012'
]);?>
```
Testing
-------
To test the extension, is better to clone this repository on your computer. After, go to the extensions folder and do
the following (assuming you have `composer` installed on your computer):
```bash
$ composer install --no-interaction --prefer-source --dev
```
Once all required libraries are installed then do:
```bash
$ vendor/bin/phpunit
```
I would recommend to have `phpunit` globally installed together with `xdebug` so you can have code coverage analysis too.
Further Information
-------------------
Please, check the [Bootstrap DatePicker site](http://bootstrap-datepicker.readthedocs.io/en/latest/) documentation for further information about its configuration options.
Contributing
------------
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
Credits
-------
- [Antonio Ramirez](https://github.com/tonydspaniard)
- [All Contributors](../../contributors)
License
-------
The BSD License (BSD). Please see [License File](LICENSE.md) for more information.
> [](http://www.2amigos.us)
Web development has never been so fun!
[www.2amigos.us](http://www.2amigos.us)