PHPackages                             blitsoftwares/laravel-states-and-cities - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. blitsoftwares/laravel-states-and-cities

ActiveLibrary

blitsoftwares/laravel-states-and-cities
=======================================

País, cidades e estados. Com código IBGE Brasil. Com migrations, models, seeder, routes, config e views. SQL de dumps disponiveis na pasta 'sql'.

161.1k9PHP

Since Feb 25Pushed 8y ago2 watchersCompare

[ Source](https://github.com/blitsoftwares/laravel-states-and-cities)[ Packagist](https://packagist.org/packages/blitsoftwares/laravel-states-and-cities)[ RSS](/packages/blitsoftwares-laravel-states-and-cities/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

laravel-states-and-cities
=========================

[](#laravel-states-and-cities)

- Laravel.
- País, estados e cidades.
- Já populado com estados e cidades brasileiras com código do IBGE

### Tasks

[](#tasks)

Lista de prioridades de novas implementações

- Traid e contrato
    - Criar uma traid para que qualquer model (empresa,pessoa,fornecedores) possua endereços atraves de uma tabela pivo dinamica.
- Melhorar o script JS
    - Consulta de CEP para selecionar estado e cidade automaticamente ao retornar o endereço do cep digitado.

Ajude-nos! Vamos fazer isso juntos, faça seu fork!

### DER - RELATIONAL ENTITY DIAGRAM

[](#der---relational-entity-diagram)

[![Image of Blit Softwares](./assets/der.png)](./assets/der.png)

Instalação
----------

[](#instalação)

Edite seu composer para instalar versoes dev.

```
"minimum-stability": "dev"

```

Via composer

```
composer require blitsoftwares/laravel-states-and-cities

```

ou manualmente adicione no seu composer.json

```
{
    "require": {
    "blitsoftwares/laravel-states-and-cities": "dev-master"
    }
}

```

### 2. Provider

[](#2-provider)

Se você está usando Laravel 5.5+ pule esta sessão, pois nosso pacote possui suporte à auto-discovery.

```
'providers' => [
        Blit\StatesAndCities\Providers\StatesAndCitiesServiceProvider::class,
    ],

```

### 3. Migration

[](#3-migration)

Execute as migrações, as tabelas serão criadas em seu banco de dados;

```
php artisan migrate

```

### 4. Seeder

[](#4-seeder)

Atualmente está disponível via seeder o Brasil, com todos os estados e cidades. Estados e cidades possuem código do IBGE

Quem desejar contribuir na implementação de novos países, fique à vontade, faça o fork, implemente os seeds e envie seu PullRequest.

```
php artisan db:seed --class=Blit\\StatesAndCities\\Seeds\\DatabaseSeeder

```

### 5. Publish

[](#5-publish)

Publique os arquivos do pacote:

```
php artisan vendor:publish --provider=Blit\\StatesAndCities\\Providers\\StatesAndCitiesServiceProvider

```

#### Arquivos a serem publicados

[](#arquivos-a-serem-publicados)

- Lang (traduções)
    - resources/lang/vendor/StatesAndCities
- Views
    - resources/views/vendor/StatesAndCities
- Assets
    - public/vendor/StatesAndCities
- Config
    - config/states-and-cities.php

### 6. Routes

[](#6-routes)

Rotas disponíveis

- /countries
- /states
- /cities
- /addresses

### 7. Javascript

[](#7-javascript)

Para que os selects entre países, estados e cidades fiquem dinâmicos, é necessário adicionar o JS do pacote, juntamente com o jquery.mask para que o campo de CEP fique com máscara.

6.1 - Adicione no fim do seu layout (template)

```

```

### Manualmente

[](#manualmente)

Caso você esteja integrar países, cidades e estados em seu formulário, basta adicionar os selects abaixo.

Não mude o ID do componente, pois o JS usa ele para fazer os loads. O atributo NAME pode ser personalizado conforme sua tabela de endereços.

Para países (necessário para load de estados)

```

```

Para estados (necessário para o load de cidades)

```

```

Para cidades

```

```

Para CEP

```