hotgo/docs/guide-zh-CN/addon-version-upgrade.md

104 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## RageFrame 2.x 插件升级到 3.x
目录
- 路由替换
- 配置移除
- UI 替换
- Icons 替换
- 表单组件 替换
- 安装
> 注意:默认当已安装 PhpStorm 等可以批量替换的编译器/软件
### 路由替换
1. 查找 `插件/common/config` 目录
2. 替换 `route``name`
### 配置移除
1. 查找 `插件/AddonConfig.php` 文件
2. 找到 `appsConfig` 变量的 `merapi` 删除掉,移除掉以后的配置
```
public $appsConfig = [
'backend' => 'common/config/backend.php',
'frontend' => 'common/config/frontend.php',
'merchant' => 'common/config/merchant.php',
'html5' => 'common/config/html5.php',
'api' => 'common/config/api.php',
'oauth2' => 'common/config/oauth2.php',
];
```
### UI 替换
1. 查找 `插件` 目录
2. 替换 `<div class='col-sm-1 text-right'>{label}</div><div class='col-sm-11'>{input}{hint}{error}</div>``<div class='row'><div class='col-sm-1 text-right'>{label}</div><div class='col-sm-11'>{input}\n{hint}\n{error}</div></div>`
3. 替换 `<div class='col-sm-2 text-right'>{label}</div><div class='col-sm-10'>{input}{hint}{error}</div>``<div class='row'><div class='col-sm-2 text-right'>{label}</div><div class='col-sm-10'>{input}\n{hint}\n{error}</div></div>`
4. 替换 `<div class='col-sm-2 text-right'>{label}</div><div class='col-sm-10'>{input}\n{hint}\n{error}</div>``<div class='row'><div class='col-sm-2 text-right'>{label}</div><div class='col-sm-10'>{input}\n{hint}\n{error}</div></div>`
5. 替换 `<div class='col-sm-3 text-right'>{label}</div><div class='col-sm-9'>{input}{hint}{error}</div>``<div class='row'><div class='col-sm-3 text-right'>{label}</div><div class='col-sm-9'>{input}\n{hint}\n{error}</div></div>`
6. 替换 `modal`
> 批量替换估计难查找到,可以看见了手动替换掉,关键词搜索 `基本信息`
```
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">关闭</span></button>
<h4 class="modal-title">基本信息</h4>
</div>
```
```
<div class="modal-header">
<h4 class="modal-title">基本信息</h4>
<button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">×</span></button>
</div>
```
7. 替换布局
如果单独使用了 `col-*` 这种布局出现页面失调的,需要在 `col-*` 外层加上 `<div class='row'></div>`
例如:
```
<div class="row">
<div class="col-6">
</div>
<div class="col-6">
</div>
</div>
```
### Icons 替换
Icons 找不到请使用最新的 Icons 库 https://fontawesome.com/v5/search?s=solid
### 表单组件替换
个别表单组件报错请参考最新的使用文档 [表单控件](sys-widget.md)
### 安装
1. 放入 3.x 的 `addons` 目录,在后台->应用管理查找安装即可
2. 个别页面出现大小表格缩短显示问题可以修改替换
- `col-xs-12``col-12`
- `col-lg-12``col-12`
- `col-sm-12``col-12`
> 个别报错找不到的组件需要自己替换修复