feat(plugins): 4 个业务插件代码 + 前台公开页面改造

plugins/navManager:导航 CRUD + 导航分类 CRUD(独立 blueprint)
plugins/friendManager:友情链接 CRUD
plugins/aboutManager:关于本站 CRUD
plugins/siteStats:访问统计主页 + JSON 接口 + /site/* GET 埋点 + nav 卡片点击埋点

applications/view/public/nav.py:导航聚合页 / 分类详情 / JSON 接口,支持 visit_count 注入
applications/view/public/about.py:关于本站公开页
applications/view/public/friend.py:友情链接公开页

templates/public/base.html:响应式首页(搜索框 / 分类抽屉 / 5 主题切换 / footer 隐私小字)
templates/public/index.html / category.html:卡片右下角访问次数
templates/public/about.html / friend.html:关于 + 友链前台页

docs/plugins-development.md:插件开发完整指南(生命周期 + 4 个示例 + FAQ + framework 迁移)

scripts/:探针与端到端验证脚本(probe_*/verify_*/test_*)
This commit is contained in:
bwstudio
2026-09-06 18:18:06 +08:00
parent 1ea69c2c34
commit 0ffc103e46
53 changed files with 4705 additions and 89 deletions
@@ -0,0 +1,101 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>新增导航</title>
{% include 'system/common/header.html' %}
</head>
<body>
<div class="layui-form" lay-filter="nav-form" style="padding: 20px 30px 0 0;">
<div class="layui-form-item">
<label class="layui-form-label">分类</label>
<div class="layui-input-block">
<input type="text" name="category" required lay-verify="required" placeholder="如:开发工具 / AI / 设计资源"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">标题</label>
<div class="layui-input-block">
<input type="text" name="title" required lay-verify="required" placeholder="显示在卡片上的名称"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">链接 URL</label>
<div class="layui-input-block">
<input type="text" name="url" required lay-verify="required|url"
placeholder="https://example.com" autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">简介</label>
<div class="layui-input-block">
<textarea name="description" placeholder="选填,鼠标悬停时显示" class="layui-textarea"></textarea>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">图标</label>
<div class="layui-input-block">
<input type="text" name="icon" placeholder="layui-icon-website / layui-icon-ai / 等"
autocomplete="off" class="layui-input" value="layui-icon-link">
<div class="layui-form-mid layui-word-aux">参考:<a href="https://layui.dev/web/doc/element/icon.html" target="_blank">layui 图标库</a></div>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">排序</label>
<div class="layui-input-inline">
<input type="number" name="sort" value="0" autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">类型</label>
<div class="layui-input-block">
<input type="radio" name="isExternal" value="1" title="外链(新窗口)" checked>
<input type="radio" name="isExternal" value="0" title="站内(当前窗口)">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">状态</label>
<div class="layui-input-block">
<input type="radio" name="enable" value="1" title="启用" checked>
<input type="radio" name="enable" value="0" title="禁用">
</div>
</div>
<div class="layui-form-item">
<div class="layui-input-block">
<button class="layui-btn" lay-submit lay-filter="nav-submit">保存</button>
<button type="reset" class="layui-btn layui-btn-primary">重置</button>
</div>
</div>
</div>
{% include 'system/common/footer.html' %}
<script>
layui.use(['form', 'layer'], function(){
var form = layui.form;
var layer = layui.layer;
var $ = layui.$;
form.on('submit(nav-submit)', function(data){
$.ajax({
url: '/system/nav/save',
type: 'POST',
contentType: 'application/json',
data: JSON.stringify(data.field),
success: function(res){
if (res.success) {
layer.msg(res.msg, {icon: 1});
parent.layui.table.reload('nav-table');
setTimeout(function(){ parent.layer.closeAll(); }, 800);
} else {
layer.msg(res.msg, {icon: 2});
}
}
});
return false;
});
});
</script>
</body>
</html>
@@ -0,0 +1,84 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>新增导航分类</title>
{% include 'system/common/header.html' %}
<style>
.layui-form-label { width: 90px; }
.layui-input-block { margin-left: 120px; }
</style>
</head>
<body class="pear-container">
<form class="layui-form" lay-filter="cat-add-form" style="margin-top: 20px;">
<div class="layui-form-item">
<label class="layui-form-label">分类名</label>
<div class="layui-input-block">
<input type="text" name="name" required lay-verify="required" placeholder="请输入分类名(唯一)" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">图标 class</label>
<div class="layui-input-block">
<input type="text" name="icon" placeholder="layui-icon-list" value="layui-icon-list" class="layui-input">
<div class="layui-form-mid layui-word-aux">填写 layui 图标 class,例如 layui-icon-list / layui-icon-star</div>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">简介</label>
<div class="layui-input-block">
<input type="text" name="description" placeholder="前台首页卡片标题下方的描述" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">排序</label>
<div class="layui-input-block">
<input type="number" name="sort" value="0" class="layui-input">
<div class="layui-form-mid layui-word-aux">数字越大,越靠前</div>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">状态</label>
<div class="layui-input-block">
<input type="radio" name="enable" value="1" title="启用" checked>
<input type="radio" name="enable" value="0" title="禁用">
</div>
</div>
<div class="layui-form-item">
<div class="layui-input-block">
<button type="submit" class="layui-btn" lay-submit lay-filter="cat-submit">立即提交</button>
<button type="reset" class="layui-btn layui-btn-primary">重置</button>
</div>
</div>
</form>
{% include 'system/common/footer.html' %}
<script>
layui.use(['form', 'layer'], function(){
var form = layui.form;
var layer = layui.layer;
var $ = layui.$;
form.on('submit(cat-submit)', function(data){
$.ajax({
url: '/system/nav-category/save',
type: 'POST',
contentType: 'application/json',
data: JSON.stringify(data.field),
success: function(res){
if (res.code === 0 || res.success) {
layer.msg(res.msg, {icon: 1}, function(){
parent.layui.table.reload('cat-table');
parent.layer.closeAll();
});
} else {
layer.msg(res.msg, {icon: 2});
}
}
});
return false;
});
});
</script>
</body>
</html>
@@ -0,0 +1,95 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>编辑导航分类</title>
{% include 'system/common/header.html' %}
<style>
.layui-form-label { width: 90px; }
.layui-input-block { margin-left: 120px; }
</style>
</head>
<body class="pear-container">
<form class="layui-form" lay-filter="cat-edit-form" style="margin-top: 20px;">
<input type="hidden" name="catId" value="{{ cat.id }}">
<div class="layui-form-item">
<label class="layui-form-label">分类名</label>
<div class="layui-input-block">
<input type="text" name="name" required lay-verify="required" value="{{ cat.name }}" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">图标 class</label>
<div class="layui-input-block">
<input type="text" name="icon" value="{{ cat.icon or 'layui-icon-list' }}" class="layui-input">
<div class="layui-form-mid layui-word-aux">填写 layui 图标 class</div>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">简介</label>
<div class="layui-input-block">
<input type="text" name="description" value="{{ cat.description or '' }}" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">排序</label>
<div class="layui-input-block">
<input type="number" name="sort" value="{{ cat.sort or 0 }}" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">状态</label>
<div class="layui-input-block">
{% if cat.enable == 1 %}
<input type="radio" name="enable" value="1" title="启用" checked>
<input type="radio" name="enable" value="0" title="禁用">
{% else %}
<input type="radio" name="enable" value="1" title="启用">
<input type="radio" name="enable" value="0" title="禁用" checked>
{% endif %}
</div>
</div>
<div class="layui-form-item">
<div class="layui-input-block">
<button type="submit" class="layui-btn" lay-submit lay-filter="cat-submit">立即提交</button>
<button type="button" class="layui-btn layui-btn-primary" id="btn-cancel">取消</button>
</div>
</div>
</form>
{% include 'system/common/footer.html' %}
<script>
layui.use(['form', 'layer'], function(){
var form = layui.form;
var layer = layui.layer;
var $ = layui.$;
form.render();
form.on('submit(cat-submit)', function(data){
$.ajax({
url: '/system/nav-category/update',
type: 'PUT',
contentType: 'application/json',
data: JSON.stringify(data.field),
success: function(res){
if (res.code === 0 || res.success) {
layer.msg(res.msg, {icon: 1}, function(){
parent.layui.table.reload('cat-table');
parent.layer.closeAll();
});
} else {
layer.msg(res.msg, {icon: 2});
}
}
});
return false;
});
$('#btn-cancel').on('click', function(){
parent.layer.closeAll();
});
});
</script>
</body>
</html>
@@ -0,0 +1,146 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>导航分类管理</title>
{% include 'system/common/header.html' %}
</head>
<body class="pear-container">
<div class="layui-card">
<div class="layui-card-body">
<form class="layui-form" action="" lay-filter="cat-query-form">
<div class="layui-form-item" style="margin-bottom: unset;">
<label class="layui-form-label">关键词</label>
<div class="layui-input-inline">
<input type="text" name="keyword" placeholder="分类名/简介" class="layui-input">
</div>
<button class="layui-btn layui-btn-md" lay-submit lay-filter="cat-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>
<button type="button" class="layui-btn layui-btn-normal layui-btn-md" id="btn-add">
<i class="layui-icon layui-icon-add-1"></i> 新增分类
</button>
</div>
</form>
</div>
</div>
<div class="layui-card">
<div class="layui-card-body">
<table id="cat-table" lay-filter="cat-table"></table>
</div>
</div>
{% include 'system/common/footer.html' %}
{% raw %}
<script type="text/html" id="col-cat-status">
{{# if(d.enable === 1){ }}
<span class="layui-badge layui-bg-green">启用</span>
{{# } else { }}
<span class="layui-badge layui-bg-gray">禁用</span>
{{# } }}
</script>
<script type="text/html" id="col-cat-op">
<a class="layui-btn layui-btn-xs" lay-event="edit">编辑</a>
{{# if(d.enable === 1){ }}
<a class="layui-btn layui-btn-xs layui-btn-warm" lay-event="disable">禁用</a>
{{# } else { }}
<a class="layui-btn layui-btn-xs layui-btn-normal" lay-event="enable">启用</a>
{{# } }}
<a class="layui-btn layui-btn-xs layui-btn-danger" lay-event="remove">删除</a>
</script>
{% endraw %}
<script>
layui.use(['table', 'form', 'layer'], function(){
var table = layui.table;
var form = layui.form;
var layer = layui.layer;
var $ = layui.$;
var renderTable = function(){
var keyword = $('input[name="keyword"]').val() || '';
table.render({
elem: '#cat-table',
url: '/system/nav-category/data',
where: { keyword: keyword },
page: true,
limit: 20,
cols: [[
{field: 'id', title: 'ID', width: 60},
{field: 'name', title: '分类名', width: 150},
{field: 'icon', title: '图标', width: 150},
{field: 'description', title: '简介', minWidth: 220},
{field: 'sort', title: '排序', width: 70},
{field: 'enable', title: '状态', width: 80, templet: '#col-cat-status'},
{field: 'create_at', title: '创建时间', width: 170},
{fixed: 'right', title: '操作', toolbar: '#col-cat-op', width: 220}
]],
skin: 'line',
text: {none: '暂无分类数据'}
});
};
renderTable();
form.on('submit(cat-query)', function(){
renderTable();
return false;
});
$('#btn-add').on('click', function(){
layer.open({
type: 2,
title: '新增导航分类',
area: ['520px', '520px'],
content: '/system/nav-category/add'
});
});
table.on('tool(cat-table)', function(obj){
var data = obj.data;
if (obj.event === 'edit'){
layer.open({
type: 2,
title: '编辑导航分类',
area: ['520px', '520px'],
content: '/system/nav-category/edit?catId=' + data.id
});
} else if (obj.event === 'remove'){
layer.confirm('确定删除该分类吗?\n(该分类下的导航不会删除,但前台将归入「未分组」)', function(idx){
$.ajax({
url: '/system/nav-category/remove/' + data.id,
type: 'DELETE',
success: function(res){
if (res.code === 0 || res.success) { layer.msg(res.msg); obj.del(); }
else layer.msg(res.msg);
}
});
layer.close(idx);
});
} else if (obj.event === 'enable'){
$.ajax({
url: '/system/nav-category/enable',
type: 'PUT',
contentType: 'application/json',
data: JSON.stringify({catId: data.id}),
success: function(res){ layer.msg(res.msg); renderTable(); }
});
} else if (obj.event === 'disable'){
$.ajax({
url: '/system/nav-category/disable',
type: 'PUT',
contentType: 'application/json',
data: JSON.stringify({catId: data.id}),
success: function(res){ layer.msg(res.msg); renderTable(); }
});
}
});
});
</script>
</body>
</html>
@@ -0,0 +1,100 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>编辑导航</title>
{% include 'system/common/header.html' %}
</head>
<body>
<div class="layui-form" lay-filter="nav-form" style="padding: 20px 30px 0 0;">
<input type="hidden" name="id" value="{{ nav.id }}">
<div class="layui-form-item">
<label class="layui-form-label">分类</label>
<div class="layui-input-block">
<input type="text" name="category" required lay-verify="required" value="{{ nav.category }}"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">标题</label>
<div class="layui-input-block">
<input type="text" name="title" required lay-verify="required" value="{{ nav.title }}"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">链接 URL</label>
<div class="layui-input-block">
<input type="text" name="url" required lay-verify="required|url" value="{{ nav.url }}"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">简介</label>
<div class="layui-input-block">
<textarea name="description" class="layui-textarea">{{ nav.description or '' }}</textarea>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">图标</label>
<div class="layui-input-block">
<input type="text" name="icon" value="{{ nav.icon }}" autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">排序</label>
<div class="layui-input-inline">
<input type="number" name="sort" value="{{ nav.sort }}" autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">类型</label>
<div class="layui-input-block">
<input type="radio" name="isExternal" value="1" title="外链(新窗口)" {% if nav.is_external == 1 %}checked{% endif %}>
<input type="radio" name="isExternal" value="0" title="站内(当前窗口)" {% if nav.is_external != 1 %}checked{% endif %}>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">状态</label>
<div class="layui-input-block">
<input type="radio" name="enable" value="1" title="启用" {% if nav.enable == 1 %}checked{% endif %}>
<input type="radio" name="enable" value="0" title="禁用" {% if nav.enable != 1 %}checked{% endif %}>
</div>
</div>
<div class="layui-form-item">
<div class="layui-input-block">
<button class="layui-btn" lay-submit lay-filter="nav-submit">保存</button>
<button type="button" class="layui-btn layui-btn-primary" onclick="parent.layer.closeAll();">取消</button>
</div>
</div>
</div>
{% include 'system/common/footer.html' %}
<script>
layui.use(['form', 'layer'], function(){
var form = layui.form;
var layer = layui.layer;
var $ = layui.$;
form.on('submit(nav-submit)', function(data){
$.ajax({
url: '/system/nav/update',
type: 'PUT',
contentType: 'application/json',
data: JSON.stringify(data.field),
success: function(res){
if (res.success) {
layer.msg(res.msg, {icon: 1});
parent.layui.table.reload('nav-table');
setTimeout(function(){ parent.layer.closeAll(); }, 800);
} else {
layer.msg(res.msg, {icon: 2});
}
}
});
return false;
});
});
</script>
</body>
</html>
@@ -0,0 +1,162 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>导航管理</title>
{% include 'system/common/header.html' %}
</head>
<body class="pear-container">
<div class="layui-card">
<div class="layui-card-body">
<form class="layui-form" action="" lay-filter="nav-query-form">
<div class="layui-form-item" style="margin-bottom: unset;">
<label class="layui-form-label">关键词</label>
<div class="layui-input-inline">
<input type="text" name="keyword" placeholder="标题/链接/简介" class="layui-input">
</div>
<label class="layui-form-label">分类</label>
<div class="layui-input-inline">
<input type="text" name="category" placeholder="按分类过滤" class="layui-input">
</div>
<button class="layui-btn layui-btn-md" lay-submit lay-filter="nav-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>
<button type="button" class="layui-btn layui-btn-normal layui-btn-md" id="btn-add">
<i class="layui-icon layui-icon-add-1"></i> 新增导航
</button>
</div>
</form>
</div>
</div>
<div class="layui-card">
<div class="layui-card-body">
<table id="nav-table" lay-filter="nav-table"></table>
</div>
</div>
{% include 'system/common/footer.html' %}
{% raw %}
<script type="text/html" id="col-status">
{{# if(d.enable === 1){ }}
<span class="layui-badge layui-bg-green">启用</span>
{{# } else { }}
<span class="layui-badge layui-bg-gray">禁用</span>
{{# } }}
</script>
<script type="text/html" id="col-external">
{{# if(d.is_external === 1){ }}
<span class="layui-badge layui-bg-blue">外链</span>
{{# } else { }}
<span class="layui-badge">站内</span>
{{# } }}
</script>
<script type="text/html" id="col-op">
<a class="layui-btn layui-btn-xs" lay-event="edit">编辑</a>
{{# if(d.enable === 1){ }}
<a class="layui-btn layui-btn-xs layui-btn-warm" lay-event="disable">禁用</a>
{{# } else { }}
<a class="layui-btn layui-btn-xs layui-btn-normal" lay-event="enable">启用</a>
{{# } }}
<a class="layui-btn layui-btn-xs layui-btn-danger" lay-event="remove">删除</a>
</script>
{% endraw %}
<script>
layui.use(['table', 'form', 'layer'], function(){
var table = layui.table;
var form = layui.form;
var layer = layui.layer;
var $ = layui.$;
var renderTable = function(){
var keyword = $('input[name="keyword"]').val() || '';
var category = $('input[name="category"]').val() || '';
table.render({
elem: '#nav-table',
url: '/system/nav/data',
where: { keyword: keyword, category: category },
page: true,
limit: 20,
cols: [[
{field: 'id', title: 'ID', width: 60},
{field: 'category', title: '分类', width: 120},
{field: 'title', title: '标题', width: 180},
{field: 'url', title: '链接', minWidth: 200},
{field: 'icon', title: '图标', width: 100},
{field: 'sort', title: '排序', width: 70},
{field: 'is_external', title: '类型', width: 80, templet: '#col-external'},
{field: 'enable', title: '状态', width: 80, templet: '#col-status'},
{field: 'create_at', title: '创建时间', width: 170},
{fixed: 'right', title: '操作', toolbar: '#col-op', width: 220}
]],
skin: 'line',
text: {none: '暂无导航数据'},
// table_api 默认返回 {code:0, data, count, msg, limit},与 Layui 默认 statusCode: 0 匹配,无需 parseData/response
});
};
renderTable();
form.on('submit(nav-query)', function(){
renderTable();
return false;
});
$('#btn-add').on('click', function(){
layer.open({
type: 2,
title: '新增导航',
area: ['640px', '620px'],
content: '/system/nav/add'
});
});
table.on('tool(nav-table)', function(obj){
var data = obj.data;
if (obj.event === 'edit'){
layer.open({
type: 2,
title: '编辑导航',
area: ['640px', '620px'],
content: '/system/nav/edit?navId=' + data.id
});
} else if (obj.event === 'remove'){
layer.confirm('确定删除该导航吗?', function(idx){
$.ajax({
url: '/system/nav/remove/' + data.id,
type: 'DELETE',
success: function(res){
if (res.code === 0 || res.success) { layer.msg(res.msg); obj.del(); }
else layer.msg(res.msg);
}
});
layer.close(idx);
});
} else if (obj.event === 'enable'){
$.ajax({
url: '/system/nav/enable',
type: 'PUT',
contentType: 'application/json',
data: JSON.stringify({navId: data.id}),
success: function(res){ layer.msg(res.msg); renderTable(); }
});
} else if (obj.event === 'disable'){
$.ajax({
url: '/system/nav/disable',
type: 'PUT',
contentType: 'application/json',
data: JSON.stringify({navId: data.id}),
success: function(res){ layer.msg(res.msg); renderTable(); }
});
}
});
});
</script>
</body>
</html>