From 62b10f9a4b643ece06159dabd536738ede152647 Mon Sep 17 00:00:00 2001 From: Borales Date: Fri, 4 Mar 2016 00:52:24 +0100 Subject: [PATCH] Release 0.0.2 Update docs --- README.md | 69 ++++++++++++++++++++++++++++++++++++++++++++++++- composer.json | 2 +- screenshot.png | Bin 0 -> 37910 bytes 3 files changed, 69 insertions(+), 2 deletions(-) create mode 100644 screenshot.png diff --git a/README.md b/README.md index f4e8402..5f28353 100644 --- a/README.md +++ b/README.md @@ -33,4 +33,71 @@ to the `require` section of your `composer.json` file. ## Usage -Docs will be available soon... \ No newline at end of file +![Phone input](screenshot.png "Phone input") + +Using as an `ActiveField` widget with the preferred countries on the top: + +```php +use borales\extensions\phoneInput\PhoneInput; + +echo $form->field($model, 'phone_number')->widget(PhoneInput::className(), [ + 'jsOptions' => [ + 'preferredCountries' => ['no', 'pl', 'ua'], + ] +]); +``` + +Using as a simple widget with the limited countries list: + +```php +use borales\extensions\phoneInput\PhoneInput; + +echo PhoneInput::widget([ + 'name' => 'phone_number', + 'jsOptions' => [ + 'allowExtensions' => true, + 'onlyCountries' => ['no', 'pl', 'ua'], + ] +]); +``` + +Using phone validator in a model (validates the correct country code and phone format): + +```php +namespace frontend\models; + +use borales\extensions\phoneInput\PhoneInputValidator; + +class Company extends Model +{ + public $phone; + + public function rules() + { + return [ + [['phone'], 'string'], + [['phone'], PhoneInputValidator::className()], + ]; + } +} +``` + +Using phone behavior in a model (auto-formats phone string to the required phone format): + +```php +namespace frontend\models; + +use borales\extensions\phoneInput\PhoneInputBehavior; + +class Company extends Model +{ + public $phone; + + public function behaviors() + { + return [ + 'phoneInput' => PhoneInputBehavior::className(), + ]; + } +} +``` diff --git a/composer.json b/composer.json index 4bcfbb7..b69d30d 100644 --- a/composer.json +++ b/composer.json @@ -1,6 +1,6 @@ { "name": "borales/yii2-phone-input", - "version": "0.0.1", + "version": "0.0.2", "description": "Yii2 International telephone numbers - Asset Bundle, Behavior, Validator, Widget", "keywords": [ "yii2", diff --git a/screenshot.png b/screenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..59c0dec2cbc4d532f8a458bd7d647fb6d0bcb824 GIT binary patch literal 37910 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