mrlco/yii2-jalali-datepicker

Jalali (persian) Bootstrap DatePicker Widget for Yii2

Installs: 1 898

Dependents: 0

Suggesters: 0

Security: 0

Stars: 6

Watchers: 3

Forks: 2

Open Issues: 0

Type:yii2-extension

2.0.0 2020-05-15 00:24 UTC

This package is auto-updated.

Last update: 2024-03-16 19:02:35 UTC


README

Renders a Persian Web Toolkit's Persian Date Picker (Reza Babakhani's nice work.)

Installation

The preferred way to install this extension is through composer.

Either run

composer require mrlco/yii2-jalali-datepicker:~1.1.0

or add

"mrlco/yii2-jalali-datepicker" : "~1.1.0"

to the require section of your application's composer.json file.

Bootstrap 4 support

From v2.0.0 - Updated to use Bootstrap 4

Usage

DatePicker

This widget renders a Bootstrap Persian DatePicker input control. Best suitable for model with date string attribute.

With a form model

There are two ways:

  • with an ActiveForm instance:
// as a widget
<?= mrlco\datepicker\Datepicker::widget([
    'model' => $model,
    'attribute' => 'date',
    'template' => '{addon}{input}',
        'clientOptions' => [
            'format' => 'YYYY/MM/DD'
        ]
]);?>
  • As a widget, setup its model and attribute
// with an ActiveForm instance 
<?= $form->field($model, 'date')->widget(
    mrlco\datepicker\Datepicker::className(), [
        'inline' => true,
        'template' => '<div class="well well-sm" style="background-color: #fff; width:250px">{input}</div>',
        'clientOptions' => [
            'format' => 'YYYY/MM/DD'
        ]
]);?>

Without any form model

//use without any model
<?= mrlco\datepicker\Datepicker::widget([
    'name' => 'Test',
    'value' => '1394/03/23',
    'template' => '{addon}{input}',
        'clientOptions' => [
            'format' => 'YYYY/MM/DD'
        ]
]);?>

Credits

License

The MIT License.