yiibr/yii2-correios

Locates an address in Brazil by postal code

yii2-correios

This extension allows automatic completion and search Brazilian address., _(*1)

, _(*2)

Installation

Add to the require section of your composer.json file:, _(*3)

"yiibr/yii2-correios": "*"

Configuration

On your controller., _(*4)

public function actions()
{
    return [
        ...
        'addressSearch' => 'yiibr\correios\CepAction'
        ...
    ];
}

How to use

On your view file., _(*5)

...

= CepInput::widget([
    'name' => 'cep',
    'action' => ['addressSearch'],
    'fields' => [
        'location' => 'location_input_id',
        'district' => 'district_input_id',
        'city' => 'city_input_id',
        'state' => 'state_input_id'
    ],
]); ?>

// Example:

= $form->field($model, 'cep',)->widget('yiibr\correios\CepInput', [
    'action' => ['addressSearch'],
    'fields' => [
        'location' => 'address-location',
        'district' => 'address-district',
        'city' => 'address-city',
        'state' => 'address-state',
    ],
]) ?>

= $form->field($model, 'location')->textInput() ?>
= $form->field($model, 'district')->textInput() ?>
= $form->field($model, 'city')->textInput() ?>
= $form->field($model, 'state')->textInput() ?>