🌳 模型概览

Category模型是CMS的树形栏目管理系统，采用MPTT（Modified Preorder Tree Traversal）算法实现高效的多级分类管理。栏目是内容的容器，决定了内容的组织结构、访问路径、模板展示和权限控制。

✨ 核心功能特性

1. 树形结构管理

  • 多级分类：支持无限级栏目嵌套
  • 拖拽排序：后台可视化拖拽调整结构
  • 层级关系：完整的父子孙层级关系
  • 路径继承：子栏目继承父栏目属性

2. 栏目类型系统

  • 普通栏目(1)：常规内容展示
  • 百科栏目(2)：知识库/百科内容
  • 下载栏目(3)：资源下载类内容
  • 专题栏目(4)：聚合型专题内容

3. 模型关联机制

  • 动态关联：每个栏目关联一个内容模型
  • 内容过滤：自动限制栏目下内容的模型类型
  • 业务分离：不同类型栏目对应不同业务逻辑
  • 权限继承：栏目权限可被内容继承

4. 个性化域名系统

  • 个性域名：支持二级/三级域名
  • 域名纯净：自动提取纯净域名部分
  • 缓存优化：域名信息永久缓存
  • 泛解析：支持泛解析域名策略
  • 优先级：个性域名优先于全局配置

5. 完整的状态管理

  • 激活(1)：正常可用状态
  • 禁用(2)：前端隐藏，保留数据
  • 待审核(3)：新建/修改待审核
  • 归档(4)：历史归档，不可编辑

6. 导航与模板系统

  • 导航控制：控制是否显示在导航
  • 打开方式：原窗口/新窗口打开
  • 模板定制：独立首页/内容模板
  • 路径继承：支持模板路径继承

7. 高级权限控制

  • 用户组控制：限制特定用户组访问
  • 员工可见：仅内部人员可见
  • 审核流程：完整的审核状态流转
  • 内容统计：实时统计栏目内容状态

8. SEO与URL优化

  • 自定义slug：支持中英文栏目标识
  • 自动生成：中文标题自动转拼音slug
  • 唯一性验证：确保slug全局唯一
  • 限制词管理：避免敏感词作为slug
  • 多级路径：支持多级slug路径生成

🎯 后台使用指南

1. 创建新栏目

步骤1：基础信息
 
栏目名称：[必填] 栏目显示名称
栏目标识：[必填] URL友好标识，自动生成拼音
栏目类型：[必选] 普通/百科/下载/专题
关联模型：[必选] 选择栏目关联的内容模型
父栏目：[可选] 选择上级栏目，不选为顶级
 
 
步骤2：SEO设置
 
SEO标题：[可选] 留空使用栏目名称
栏目关键词：[可选] 英文逗号分隔
栏目说明：[可选] 栏目描述，用于SEO
 
 
步骤3：高级设置
 
个性域名：[可选] 如：news.example.com
栏目图片：[可选] 栏目封面/背景图
打开方式：[可选] 原窗口/新窗口
导航状态：[可选] 是否加入导航
首页模板：[可选] 栏目首页自定义模板
内容模板：[可选] 内容详情页模板
站长备注：[可选] 内部管理备注
 
 
步骤4：权限设置
 
审核状态：[必选] 激活/禁用/待审核/归档
仅工作人员可见：[可选] 内部栏目
允许访问的用户组：[可选] 限制用户组
 
 
步骤5：保存
 
保存 → 自动处理slug、域名、路径 → 建立树形关系
 
 

2. 树形结构操作

拖拽排序：
 
1. 在栏目列表页，点击栏目前的拖动图标
2. 拖拽到目标位置
3. 松开鼠标完成排序
4. 可跨层级拖拽
 
 
结构可视化：
 
- 层级缩进显示
- 折叠/展开子栏目
- 快速查看栏目深度
- 父子关系一目了然
 
 
批量操作：
 
- 批量修改导航状态
- 批量更改审核状态
- 批量设置用户组权限
- 批量重建树结构
 
 

3. 个性域名配置

域名格式要求：
 
正确格式：subdomain.example.com
错误格式：http://subdomain.example.com
纯净提取：系统自动提取纯净域名部分
支持级别：二级、三级、多级域名
 
 
域名缓存策略：
 
1. 首次访问时计算域名
2. 结果永久缓存
3. 修改后需重启项目生效
4. 缓存键：category{id}absoluteurl
 
 
域名优先级：
 
1. 当前栏目个性域名
2. 根栏目个性域名
3. 全局泛解析域名
4. 默认站点域名
 
 

4. 关联模型管理

模型选择限制：
 
# 模型必须来自指定应用
limitchoicesto=getcontenttype_choices()



支持模型类型



    

  • 文章（article）
    • 

  • 百科（wiki）
    • 

  • 下载（download）
    • 

  • 图库（imagegallery）
    • 

  • 其他自定义模型
 
 
内容统计功能：
 
在栏目列表页显示：

  • 各状态内容数量
    • 

  • 内容总数
    • 

  • 状态颜色标记
    • 

  • 快捷操作链接
    •  
     

    5. URL生成规则

    路径风格配置：
     
    url_front: 路径前缀风格

  • model: 模型路径 (/category/)
    • 

  • slug: 单级slug (/news/)
    • 

  • moreslug: 多级slug (/news/sports/)
    • 

  • random: 随机字符
    • 

  • custom: 自定义路径
    •  
     
    标识符规则：
     
    url_mid: 中间标识

  • id: 使用数字ID
    • 

  • hash: 使用哈希值
    • 

  • 特殊：当为slug类时自动添加'index'
    •  
     
    完整URL示例：
     
    # 多级slug风格
/news/sports/index.html



    模型路径+哈希
    


    /category/abc123.html
    


    个性域名+路径
    


    //news.example.com/sports/index.html
     
     

    6. 工作流程

    审核流程：
     
    新建栏目 → 待审核(3)
    ↓
管理员审核 → 激活(1)/禁用(2)
    ↓
使用中 → 可随时禁用
    ↓
历史栏目 → 归档(4)
     
     
    状态说明：
    • 激活(1)：正常显示，可访问
    • 禁用(2)：前端隐藏，保留数据
    • 待审核(3)：新建/修改后等待审核
    • 归档(4)：历史数据，不可编辑

    📊 字段说明速查

    字段分组
    字段名
    说明
    必填
    默认值
    基础信息​
    name
    栏目名称
    是
    -
     
    slug
    栏目标识
    是
    自动生成
     
    parent
    父栏目
    否
    null
     
    catetype
    栏目类型
    是
    1(普通)
     
    contenttype
    关联模型
    是
    -
    媒体信息​
    image
    栏目图片
    否
    null
     
    description
    栏目说明
    否
    空
     
    notes
    站长备注
    否
    空
    SEO优化​
    seotitle
    SEO标题
    否
    空
     
    keywords
    关键词
    否
    空
    导航设置​
    opentype
    打开方式
    是
    self
     
    navstatus
    导航状态
    是
    1(显示)
    模板系统​
    indextemplate
    首页模板
    否
    空
     
    contenttemplate
    内容模板
    否
    空
    域名配置​
    subdomain
    个性域名
    否
    null
    时间信息​
    createdtime
    创建时间
    自动
    当前时间
     
    updatedtime
    更新时间
    自动
    当前时间
    权限控制​
    reviewstatus
    审核状态
    是
    1(激活)
     
    staffonly
    仅员工可见
    否
    False
     
    allowedgroups
    允许用户组
    否
    空
    树形结构​
    treeid
    树ID
    自动
    -
     
    lft
    左值
    自动
    -
     
    rght
    右值
    自动
    -
     
    level
    层级
    自动
    0

    🔧 高级功能详解

    1. 树形结构算法（MPTT）

    核心字段：
     
    treeid: 树的唯一标识
lft: 左值（小值表示上级）
rght: 右值（大值表示下级）
level: 节点层级（0为根）
parent: 父节点外键
     
     
    查询优化：
     
    # 获取所有后代
descendants = category.getdescendants(include_self=True)
    


    获取所有祖先
    


    ancestors = category.getancestors(includeself=True)
    


    获取子节点
    


    children = category.get_children()
    


    获取根节点
    


    root = category.getroot()
     
     
    重建树结构：
     
    1. 点击"重建树结构"按钮
2. 系统重新计算所有节点的左右值
3. 修复因直接数据库操作导致的树结构错误
4. 需要特定权限才能执行
     
     

    2. 个性域名系统

    处理流程：
     
    1. 用户输入域名
2. 正则提取纯净域名
3. 保存到数据库
4. 访问时从缓存读取
5. 生成完整URL
     
     
    正则匹配规则：
     
    ^(https?://)?                # 可选协议
(?P<subdomain>               # 命名分组
  ([a-zA-Z0-9-]+.)+        # 多级子域名
  [a-zA-Z0-9-]+             # 主域名
)
(?::\d+)?                    # 可选端口
(/.*)?$                      # 可选路径
     
     
    缓存策略：
     
    # 缓存键格式
cachekey = f"category{self.id}absolute_url"
    


    永久缓存
    


    cache.set(cache_key, url, timeout=None)
    


    清除缓存
    


    1. 重启项目
    


    2. 手动清除缓存
    


    3. 修改个性域名后自动失效
     
     

    3. 限制词管理系统

    验证流程：
     
    # 仅在slug变化时验证


    if slugchanged:
    RestrictedTermManager.validateterm(self.slug)
    # 验证通过后自动添加到限制词库
    RestrictedTermManager.addrestrictedterms(self.slug)
     
     
    避免重复验证：
     
    needvalidate = True
if 不是新增实例 and slug未变化:
    needvalidate = False
    


    if needvalidate:
    执行验证
     
     

    4. 后台管理功能

    列表页特性：
     
    - 树形缩进显示
- 拖拽排序功能
- 状态统计显示
- 快捷操作链接
- 批量编辑功能
     
     
    快捷操作链接：
     
    1. 添加子栏目
2. 前端浏览
3. 添加内容
4. 内容列表
5. 备注提示
     
     
    状态统计显示：
     
    格式：总数: X | 状态1: Y | 状态2: Z
颜色标记：不同状态使用不同颜色
数字格式：超过2000用红色警告
     
     

    🎨 模板使用技巧

    1. 获取栏目路径

     
    {# 获取栏目URL #}
<a href="{{ category.getabsolute_url }}">{{ category.name }}</a>
    


    {# 获取多级面包屑 #}
{% for ancestor in category.getancestors %}
  <a href="{{ ancestor.getabsolute_url }}">{{ ancestor.name }}</a>
  {% if not forloop.last %} > {% endif %}
{% endfor %}
    


    {# 获取子栏目 #}
{% for child in category.getchildren %}
  <a href="{{ child.getabsoluteurl }}">{{ child.name }}</a>
{% endfor %}
     
     

    2. 条件判断

     
    {# 检查栏目状态 #}
{% if category.ispublished %}
  {# 显示栏目内容 #}
{% endif %}
    


    {# 检查导航状态 #}
{% if category.navstatus == 1 %}
  <li><a href="{{ category.getabsolute_url }}">{{ category.name }}</a></li>
{% endif %}
    


    {# 检查权限 #}
{% if not category.staffonly or user.isstaff %}
  {# 显示有权限的内容 #}
{% endif %}
     
     

    3. 模板继承

     
    {# 使用栏目自定义模板 #}
{% if category.indextemplate %}
  {% include category.indextemplate %}
{% else %}
  {% include "default/index.html" %}
{% endif %}
    


    {# 内容模板同理 #}
{% if category.contenttemplate %}
  {% include category.contenttemplate %}
{% else %}
  {% include "default/content.html" %}
{% endif %}
     
     

    4. 内容统计

     
    {# 获取栏目下内容数量 #}
{{ category.article_set.count }}
    


    {# 获取特定状态内容 #}
{{ category.article_set.filter(status=99).count }}
    


    {# 分页显示内容 #}
{% for article in category.articleset.all %}
  {# 内容列表 #}
{% endfor %}
     
     

    💡 最佳实践建议

    1. 栏目结构规划

    层级设计原则：
     
    深度控制：建议不超过3-4级
宽度控制：每级不超过10-15个子栏目
命名规范：清晰、简洁、有意义
业务分离：不同类型内容使用不同栏目
     
     
    分类策略：
     
    1. 按内容类型：新闻、产品、下载
2. 按业务部门：技术、市场、销售
3. 按用户群体：公开、内部、VIP
4. 按时间维度：最新、热门、归档
     
     

    2. slug命名规范

    生成规则：
     
    中文转拼音：自动提取首字母
冲突处理：自动添加随机后缀
长度控制：不超过200字符
字符限制：只允许字母、数字、连字符
     
     
    命名建议：
     
    保持简洁：news, product, download
语义明确：tech-news, product-docs
避免特殊字符：只使用小写字母和连字符
保持一致性：全站使用相同命名风格
     
     

    3. 个性域名策略

    域名规划：
     
    业务划分：news., product., download.
地域划分：cn., us., eu.
语言划分：en., zh., jp.
版本划分：v1., v2., beta.
     
     
    DNS配置：
     
    泛解析：*.example.com → 服务器IP
A记录：子域名 → 服务器IP
CNAME：子域名 → 主域名
TTL设置：根据更新频率调整
     
     

    4. 权限管理

    用户组设计：
     
    公开组：所有用户
注册组：注册用户
VIP组：付费用户
员工组：内部员工
管理组：系统管理员
     
     
    权限分配：
     
    公开栏目：所有人可访问
内部栏目：仅员工可访问
付费栏目：VIP以上可访问
管理栏目：仅管理员可访问
     
     

    5. 性能优化

    缓存策略：
     
    栏目信息：永久缓存
树形结构：长期缓存
内容统计：短期缓存
域名解析：永久缓存
     
     
    查询优化：
     
    使用MPTT方法：避免递归查询
预取关联数据：减少查询次数
使用索引字段：加速查询速度
分页加载：避免大量数据查询
     
     

    6. SEO优化

    栏目SEO：
     
    唯一标题：每个栏目独立SEO标题
关键词优化：3-5个核心关键词
描述完善：150-300字符描述
规范URL：使用唯一slug
结构数据：添加面包屑结构化数据
     
     
    URL优化：
     
    短路径优先：减少URL层级
静态化：使用.html后缀
小写字母：统一使用小写
连字符分隔：使用-而非
     
     

    7. 维护与监控

    日常维护：
     
    定期检查：死链、空栏目
结构优化：合并/拆分栏目
权限审查：更新用户组权限
缓存清理：定期清理无效缓存
     
     
    监控指标：
     
    栏目访问量：热门/冷门栏目
内容数量：各栏目内容分布
用户行为：栏目点击路径
错误日志：404、权限错误
     
     

    8. 安全考虑

    输入验证：
     
    域名验证：正则表达式严格验证
slug验证：限制词过滤
权限验证：用户组权限检查
模板验证：模板路径安全检查
     
     
    防攻击：
     
    SQL注入：使用ORM防止注入
XSS攻击：模板自动转义
CSRF防护：后台操作验证
暴力破解：登录失败限制
     
     
    这个栏目模型是CMS的核心组织架构，合理规划栏目结构对于网站的用户体验、SEO优化、内容管理和权限控制都至关重要。建议在项目开始前就做好完整的栏目规划。