从旧项目迁移

由于 Pear Admin Layui 框架(下面将会称其为 “主项目”)的更新获得了更好的性能与新的功能, 此项目 Pear Admin Flask 作为主项目的附属项目将会在一定时间进行迁移与同步。由于主项目的更新,此项目的部分功能被弃用这大大增加了同步的难度,所以在一段时间 内,此项目并未有同步的打算。为了获得性能更新,此项目于 2025 的新年前后开始逐步将项目代码进行同步与完善,迫不得已舍去了部分功能,这为以往基于此项目的作品更新 加大了难度,所以便有了此迁移章节。各位开发者,如果您想要同步自己原先以项目为基础的作品,请阅读该章节。

迁移到 v2.0.0-4.0.5 版本

更正验证码生成模块引用

由于 applications/common/utils/gen_captcha.py 更名为 applications/common/utils/captcha.py ,需要修改导入引用。

例如:

from applications.common.utils.gen_captcha import vieCode

更正为:

from applications.common.utils.captcha import vieCode

后台首页路径修改

由于为了对齐主项目,system/console/console.html 更名为 system/analysis/main.html,前端页面需要进行修改。

例如:

<a href="system/console/console.html"></a>

更正为:

<a href="system/analysis/main.html"></a>

公用模板修改

移除了 templates/system/common/memory.html ,该文件原先仅用于系统监控页面,现在换为 JavaScript 函数进行换算。 详情参阅模板文件 templates/system/monitor.html

移除 Pear Button 模块

由于主项目不再使用 Pear Button 而直接使用 Layui Button。所以需要将所有的按钮 class 中的 “pear-btn” 变为 “layui-btn”。 (附属的 pear-btn-* 也要修改,建议是直接搜索替换。)

例如:

<button class="pear-btn pear-btn-primary pear-btn-md" lay-submit lay-filter="dept-query">
    <i class="layui-icon layui-icon-search"></i>
    查询
</button>
<button type="reset" class="pear-btn pear-btn-md">
    <i class="layui-icon layui-icon-refresh"></i>
    重置
</button>

改为:

<button class="layui-btn layui-btn-md" lay-submit lay-filter="dept-query">
    <i class="layui-icon layui-icon-search"></i>
    查询
</button>
<button type="reset" class="layui-btn layui-btn-primary layui-btn-md">
    <i class="layui-icon layui-icon-refresh"></i>
    重置
</button>

小技巧

你会注意到修改之后的 layui-btn-primary 属性添加在了 “重置” 按钮上,而不是 “查询” 按钮上, 这是因为 layui-btn-primary 是默认白色的,而不加 layui-btn-primary 属性是跟随主题色的。这里需要特别注意一下。

合并日志模块

为了减少冗余,将 applications/common/admin_log.py 与 applications/common/admin.py 合并,仅留下 applications/common/admin.py 。

例如:

from applications.common.admin_log import admin_log

改为:

from applications.common.admin import admin_log

验证码生成路由修改

为了优化代码,将验证码生成路由改为了 system.passport.captcha 。这主要会影响前端模板渲染。

例如:

url_for('system.passport.get_captcha')

改为:

url_for('system.passport.captcha')