Wallogit.com
2017 © Pedro Peláez
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'.
Lista de prioridades de novas implementações, (*1)
Ajude-nos! Vamos fazer isso juntos, faça seu fork!, (*2)
, (*3)
Edite seu composer para instalar versoes dev., (*4)
"minimum-stability": "dev"
Via composer, (*5)
composer require blitsoftwares/laravel-states-and-cities
ou manualmente adicione no seu composer.json, (*6)
{
"require": {
"blitsoftwares/laravel-states-and-cities": "dev-master"
}
}
Se você está usando Laravel 5.5+ pule esta sessão, pois nosso pacote possui suporte à auto-discovery., (*7)
'providers' => [
Blit\StatesAndCities\Providers\StatesAndCitiesServiceProvider::class,
],
Execute as migrações, as tabelas serão criadas em seu banco de dados;, (*8)
php artisan migrate
Atualmente está disponível via seeder o Brasil, com todos os estados e cidades. Estados e cidades possuem código do IBGE, (*9)
Quem desejar contribuir na implementação de novos países, fique à vontade, faça o fork, implemente os seeds e envie seu PullRequest., (*10)
php artisan db:seed --class=Blit\\StatesAndCities\\Seeds\\DatabaseSeeder
Publique os arquivos do pacote:, (*11)
php artisan vendor:publish --provider=Blit\\StatesAndCities\\Providers\\StatesAndCitiesServiceProvider
Rotas disponíveis, (*12)
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., (*13)
6.1 - Adicione no fim do seu layout (template), (*14)
<script src="//oss.maxcdn.com/jquery.mask/1.11.4/jquery.mask.min.js"></script> <script src="/vendor/StatesAndCities/js/blit-states-and-cities.js"></script>
Caso você esteja integrar países, cidades e estados em seu formulário, basta adicionar os selects abaixo., (*15)
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., (*16)
Para países (necessário para load de estados), (*17)
<select name="country_id" id="country" data-default="{{ config('states-and-cities.default-country') }}"></select>
Para estados (necessário para o load de cidades), (*18)
<select name="state_id" id="state" data-default="{{ config('states-and-cities.default-state') }}"></select>
Para cidades, (*19)
<select name="city_id" id="city" data-default="{{ config('states-and-cities.default-city') }}"></select>
Para CEP, (*20)
<input name="postal_code" id="postal_code" data-autocomplete="true" data-mask="{{ config('states-and-cities.postal_code_mask') }}" type="text" }}">
Na pasta config do laravel, se encontra publicado o arquivo de configuração do pacote:, (*21)
Nele possi algumas variáveis que pode ser personalizada conforme sua necessidade:, (*22)
Os valores a serem adicionados nas 3 primeiras variáveis são os IDs da sua respectiva tabela, acesse as rotas e olhe a coluna # que possui os ids dos registros., (*23)
O pacote está integrado com VIACEP. Para utilizar, use o componente de CEP na sessão MANUALMENTE e adicione os campos de endereços com os IDs abaixo:, (*24)
Para logradouro:, (*25)
<input id="street" >
Para bairro:, (*26)
<input id="district" >
Os seletores automáticos para estado e cidade após uma consulta do CEP, ainda será implementado., (*27)
As views de cadastros nativas de países, estados, cidades e endereços, estão integradas com o LANG do laravel. Idiomas disponívies, (*28)
Os arquivos estão disponíveis na pasta:, (*29)
Configure o locale do seu laravel., (*30)
Este pacote é mantido pela equipe de desenvolvedores da Blit Softwares. Faça um fork e nos ajude com novidades e eventuais falhas., (*31)
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'.
MIT