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:
@@ -14,7 +14,8 @@ from collections import OrderedDict
|
||||
|
||||
from flask import Blueprint, render_template, request, jsonify
|
||||
|
||||
from applications.models import Nav
|
||||
from applications.models import Nav, NavCategory
|
||||
from plugins.siteStats.view.stat import get_nav_visit_counts
|
||||
|
||||
bp = Blueprint('public_nav', __name__, url_prefix='/site')
|
||||
|
||||
@@ -24,14 +25,7 @@ def index():
|
||||
"""
|
||||
公开首页:按 category 分组聚合,渲染模板
|
||||
"""
|
||||
groups = _grouped_navs()
|
||||
total = sum(len(items) for items in groups.values())
|
||||
return render_template(
|
||||
'public/index.html',
|
||||
groups=groups,
|
||||
total=total,
|
||||
site_name='BWStudio · 导航',
|
||||
)
|
||||
return _render_index()
|
||||
|
||||
|
||||
@bp.get('/category/<string:name>')
|
||||
@@ -41,15 +35,21 @@ def category_detail(name: str):
|
||||
"""
|
||||
items = (
|
||||
Nav.query
|
||||
.filter(Nav.category == name, Nav.status == 1)
|
||||
.filter(Nav.category == name, Nav.enable == 1)
|
||||
.order_by(Nav.sort.asc(), Nav.id.asc())
|
||||
.all()
|
||||
)
|
||||
counts = get_nav_visit_counts()
|
||||
dict_items = []
|
||||
for it in items:
|
||||
d = it.to_dict()
|
||||
d['visit_count'] = counts.get(it.id, 0)
|
||||
dict_items.append(d)
|
||||
return render_template(
|
||||
'public/category.html',
|
||||
category=name,
|
||||
items=items,
|
||||
site_name='BWStudio · 导航',
|
||||
items=dict_items,
|
||||
site_name='旺珂 · 导航',
|
||||
)
|
||||
|
||||
|
||||
@@ -66,15 +66,65 @@ def api_navs():
|
||||
})
|
||||
|
||||
|
||||
def render_public_index():
|
||||
"""给外部复用:渲染前台公开导航首页(无需登录)。"""
|
||||
return _render_index()
|
||||
|
||||
|
||||
def get_category_meta() -> "dict[str, dict]":
|
||||
"""给外部复用:返回启用的分类元信息。"""
|
||||
return _category_meta()
|
||||
|
||||
|
||||
def _render_index():
|
||||
groups = _grouped_navs()
|
||||
total = sum(len(items) for items in groups.values())
|
||||
return render_template(
|
||||
'public/index.html',
|
||||
groups=groups,
|
||||
total=total,
|
||||
site_name='旺珂 · 导航',
|
||||
cat_meta=_category_meta(),
|
||||
)
|
||||
|
||||
|
||||
def _grouped_navs() -> "OrderedDict[str, list]":
|
||||
"""按 category 分组,组内按 sort asc 排序"""
|
||||
"""按 category 分组,组内按 sort asc 排序;分组顺序优先按 NavCategory.sort 排列"""
|
||||
# 先取启用的分类,按 sort 排好序
|
||||
cats = (
|
||||
NavCategory.query
|
||||
.filter(NavCategory.enable == 1)
|
||||
.order_by(NavCategory.sort.desc(), NavCategory.id.asc())
|
||||
.all()
|
||||
)
|
||||
ordered_names = [c.name for c in cats]
|
||||
cat_order = {name: idx for idx, name in enumerate(ordered_names)}
|
||||
|
||||
items = (
|
||||
Nav.query
|
||||
.filter(Nav.status == 1)
|
||||
.filter(Nav.enable == 1)
|
||||
.order_by(Nav.category.asc(), Nav.sort.asc(), Nav.id.asc())
|
||||
.all()
|
||||
)
|
||||
# 一次性取所有 nav 的点击数(带缓存)
|
||||
counts = get_nav_visit_counts()
|
||||
groups = OrderedDict()
|
||||
# 按 cat_order 初始化空分组,保证顺序
|
||||
for name in ordered_names:
|
||||
groups[name] = []
|
||||
for item in items:
|
||||
groups.setdefault(item.category, []).append(item.to_dict())
|
||||
return groups
|
||||
d = item.to_dict()
|
||||
d['visit_count'] = counts.get(item.id, 0)
|
||||
if item.category in groups:
|
||||
groups[item.category].append(d)
|
||||
else:
|
||||
# 对于未在 NavCategory 登记的历史分类,放在最后
|
||||
groups.setdefault(item.category, []).append(d)
|
||||
# 过滤空分组(启用的分类下可能没有导航)
|
||||
return OrderedDict((k, v) for k, v in groups.items() if v)
|
||||
|
||||
|
||||
def _category_meta() -> "dict[str, dict]":
|
||||
"""返回分类元信息 {name: {icon, description, ...}},用于抽屉图标等"""
|
||||
cats = NavCategory.query.filter(NavCategory.enable == 1).all()
|
||||
return {c.name: {'icon': c.icon or 'layui-icon-list', 'description': c.description or ''} for c in cats}
|
||||
Reference in New Issue
Block a user