Django Messages Extends 安装与使用指南

1. 项目目录结构及介绍

Django Messages Extends 是一个扩展了 Django 内置消息框架的应用，允许实现粘性消息和持久化消息等特性。以下是项目的基本目录结构及其简要说明：

.
├── LICENSE.txt         # 许可证文件
├── MANIFEST.in         # 包含在分发包中的额外文件列表
├── README.md           # 项目介绍文档
├── messages_extends    # 应用主目录
│   ├── __init__.py     # 标记该目录为Python包
│   ├── admin.py        # Django管理界面配置
│   ├── apps.py         # 应用配置文件
│   ├── migrations      # 数据库迁移文件夹
│   │   └── ...
│   ├── models.py       # 模型定义文件
│   ├── tests.py        # 单元测试文件
│   ├── urls.py         # 应用内部的URL配置
│   └── views.py        # 视图处理逻辑
├── requirements.txt    # 依赖库列表（如果存在）
├── setup.py            # Python包安装脚本
└── tox.ini             # 测试环境配置文件

2. 项目的启动文件介绍

在使用 django-messages-extends 时，虽然没有特定的“启动文件”像其他独立应用那样直接运行，但关键在于正确集成到你的Django项目中。主要涉及以下几个步骤来“启动”该功能：

• 添加到INSTALLED_APPS: 在你的Django项目的settings.py文件中，你需要将'messages_extends'添加到INSTALLED_APPS列表里。

• 中间件配置: 确保Django的消息中间件已经包含在MIDDLEWARE设置（以前可能称为MIDDLEWARE_CLASSES）。对于较新的Django版本，确保'django.contrib.messages.middleware.MessageMiddleware'存在于MIDDLEWARE列表中。

• URL配置: 将django-messages-extends的URL模式包含进你的项目URL配置，通常是在urls.py或相应的路由文件中通过include('messages_extends.urls')实现。

• 消息存储配置: 修改settings.py，设置MESSAGE_STORAGE为'messages_extends.storages.FallbackStorage'来启用持久化存储。

• 数据库迁移: 使用Django的迁移命令设置数据库表格，即执行python manage.py makemigrations 和 python manage.py migrate。

3. 项目的配置文件介绍

配置主要发生在你的Django项目的settings.py文件中。具体的配置项包括：

• 添加应用到INSTALLED_APPS:

  INSTALLED_APPS = [
      ...,
      'messages_extends',
  ]
  

• 配置消息中间件:

  （注意：Django 2.x+ 的中间件配置方式与早期版本不同，以下适用于新版本）

  MIDDLEWARE = [
      ...,
      'django.contrib.sessions.middleware.SessionMiddleware',  # 确保此条在MessageMiddleware之前
      'django.contrib.messages.middleware.MessageMiddleware',  # 保持默认位置或按需调整
      ...
  ]
  

• 设置消息存储:

  MESSAGE_STORAGE = 'messages_extends.storages.FallbackStorage'
  

完成上述配置后，你的Django项目就已经准备好了使用增强后的消息系统。这使得你能享受到更多样化的消息处理能力，如sticky和persistent消息，以及多存储支持。

记得，每次修改settings.py后重启开发服务器以使改动生效。这样，你就成功地配置并启动了 django-messages-extends 功能于你的Django项目中。