codeonyii/yii2-at-least-validator

Validates at least one (or more) attributes.

Friday, June 1, 2018
by slinstj
Repository
5 Watchers
23 Stars
33,458 Installations

PHP
0 Dependents
0 Suggesters
13 Forks
3 Open issues
17 Versions
12 % Grown

The README.md

Yii 2 - AtLeastValidator

, _(*1)

Sometimes, in a set of fields, you need to make at least one of them (sometimes two, or more) be filled. For example, phone OR e-mail, (facebook OR linkedin) OR (linkedin OR instagram) and so on. You can do it using required validator with a bunch of conditional rules. Or you can use AtLeastValidator., _(*2)

Installation

Use composer:, _(*3)

    composer require "codeonyii/yii2-at-least-validator"

In your Model, import the validator:, _(*4)

use codeonyii\yii2validators\AtLeastValidator;

class MyModel extends Model
{
...
    public function rules()
    {
        // see examples below
    }
...

Examples

In the following example, the phone and email attributes will be verified. If none of them are filled phone will receive an error. Please, note that in param is always mandatory., _(*5)

     // in rules()
     return [
         ['phone', AtLeastValidator::className(), 'in' => ['phone', 'email']],
     ];

Here, facebook, linkedin and instagram attributes will be verified. If at least 2 (note the min param) of them are not filled, facebook and instagram will receive an error:, _(*6)

     // in rules()
     return [
         [['facebook', 'instagram'], AtLeastValidator::className(), 'in' => ['facebook', 'linkedin', 'instagram'], 'min' => 2],
     ];

Showing errors in summary

If you want to show errors in a summary instead in the own attributes, you can do this:, _(*7)

Note that summary will not work for client-side validation. If you want to use it, you should disable the client-side validation for your fields or for your entire form., _(*8)

     // in the rules()
     // please note the exclamation mark. It will avoid the pk attribute to be massively assigned.
     return [
         ['!id', AtLeastValidator::className(), 'in' => ['attr1', 'attr2', 'attr3']], // where `id` is the pk
     ];

     // in the view, show all errors in the summary:
     ...
     echo yii\helpers\Html::errorSummary($model, ['class' => ['text-danger']]);

     // OR, to show only `id` errors:
     echo yii\helpers\Html::error($model, 'id', ['class' => ['text-danger']]);

Changelog

Please, access Releases to see versions with a some description., _(*9)

The Versions

01/06 2018

dev-master

9999999-dev https://github.com/code-on-yii/yii2-at-least-validator

Validates at least one (or more) attributes.

yii2-extension yii2-at-least-validator

Validates at least one (or more) attributes.

codeonyii/yii2-at-least-validator

The README.md

Yii 2 - AtLeastValidator

Installation

Examples

Showing errors in summary

Changelog

The Versions

dev-master

The Requires

The Development Requires

by Sidney Lins

1.2.5

The Requires

The Development Requires

by Sidney Lins

dev-slinstj-patch-1

The Requires

The Development Requires

by Sidney Lins

dev-scrutinizer-patch-1

The Requires

The Development Requires

by Sidney Lins

1.2.4

The Requires

The Development Requires

by Sidney Lins

1.2.3

The Requires

The Development Requires

by Sidney Lins

1.2.2

The Requires

The Development Requires

by Sidney Lins

1.2.1

The Requires

The Development Requires

by Sidney Lins

1.2

The Requires

The Development Requires

by Sidney Lins

1.1.2

The Requires

The Development Requires

by Sidney Lins

1.1.1

The Requires

The Development Requires

by Sidney Lins

dev-revert-4-master

The Requires

The Development Requires

by Sidney Lins

1.1

The Requires

The Development Requires

by Sidney Lins

1.0.3

The Requires

The Development Requires

by Sidney Lins

1.0.2

The Requires

by Sidney Lins

1.0.1

The Requires

by Sidney Lins

1.0

The Requires

by Sidney Lins