README

Laravel.
国家，州和城市。
已预填充巴西州和城市，包含IBGE代码

任务

新实现的优先级列表

交易和合同
- 创建一个交易，以便任何模型（公司，人员，供应商）通过一个动态的交叉表拥有地址。
改进脚本JS
- 查询CEP以在返回输入的CEP地址时自动选择州和城市。

帮助我们！让我们一起做这件事，创建您的分支！

DER - 关系实体图

安装

编辑您的composer以安装开发版。

"minimum-stability": "dev"

通过composer

composer require blitsoftwares/laravel-states-and-cities

或手动将其添加到您的composer.json中

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

2. 提供者

如果您正在使用Laravel 5.5+，请跳过此部分，因为我们的包具有自动发现支持。

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

3. 迁移

执行迁移，将在您的数据库中创建表；

php artisan migrate

4. 播种器

目前通过播种器提供巴西，包含所有州和城市。州和城市包含IBGE代码

希望在新国家的实现中做出贡献的人，请随意，创建分支，实现种子并发送您的PullRequest。

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

5. 发布

发布包文件

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

要发布的文件

语言（翻译）
- resources/lang/vendor/StatesAndCities
视图
- resources/views/vendor/StatesAndCities
资产
- public/vendor/StatesAndCities
配置
- config/states-and-cities.php

6. 路由

可用路由

/countries
/states
/cities
/addresses

7. Javascript

为了使国家，州和城市的下拉列表动态，需要添加包的JS，以及jquery.mask，以便CEP字段带有掩码。

6.1 - 在您的布局（模板）末尾添加

<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>

手动添加

如果您正在将国家，城市和州集成到您的表单中，只需添加以下下拉列表。

不要更改组件的ID，因为JS使用它来执行加载。属性NAME可以根据您的地址表进行自定义。

对于国家（用于加载州）

<select name="country_id" id="country" data-default="{{ config('states-and-cities.default-country') }}"></select>

对于州（用于加载城市）

<select name="state_id" id="state" data-default="{{ config('states-and-cities.default-state') }}"></select>

对于城市

<select name="city_id" id="city" data-default="{{ config('states-and-cities.default-city') }}"></select>

对于CEP

<input name="postal_code" id="postal_code" data-autocomplete="true" data-mask="{{ config('states-and-cities.postal_code_mask') }}" type="text" }}">

配置

在Laravel的config文件夹中，发布了包的配置文件

states-and-cities.php

其中包含一些可以按需自定义的变量

default-country :: 默认自动加载国家
default-state :: 默认自动加载州
default-city :: 默认自动加载城市
postal_code_mask :: 使用我们的组件的CEP掩码标准
routes_middleware :: 路由中间件

前三个变量的值是相应表的ID，请访问路由并查看包含记录ID的#列。

自动填写输入的CEP

该包集成了VIACEP。要使用，请在MANUALMENTE会话中使用CEP组件，并添加以下ID的地址字段

用于街道名称

<input id="street" >

用于区/县

<input id="district" >

在查询CEP后自动选择州和城市的选项器尚未实施。

翻译

国家、州、城市和地址的本地原生视图已与Laravel的LANG集成。支持的语种

葡萄牙语巴西 (pt-br)
英语 (en)

文件位于以下文件夹中

resources/lang/vendor/StatesAndCities

配置您的Laravel本地化设置。

信息

此包由Blit Softwares的开发团队维护。创建一个分支并帮助我们添加新功能以及修复可能出现的错误。

联系方式
- Blit Softwares falecom@blitsoft.com.br
- http://blitsoft.com.br

blitsoftwares / laravel-states-and-cities

维护者

详细信息