嵌入 Django Apps

简介 #

SmartChart 可以作为一个 Django App 插件嵌入到你已有的 Django 项目中，共享同一套用户体系和数据库，无需独立部署。适合已有 Django 系统的团队快速集成可视化能力。

你可以查看相关视屏

应用场景 #

  • 在你的django项目中直接使用smartchart做为应用插件
  • 与现有 Django 用户系统集成

使用方法 #

按照以下步骤将 SmartChart 集成到你的 Django 项目：

Step 1: 添加到 INSTALLED_APPS

INSTALLED_APPS = [
    'smart_chart.smartui',
    ....
    ....
    'smart_chart.echart'
]

Step 2: 注释掉 XFrameOptionsMiddleware

在 MIDDLEWARE 中注释掉 django.middleware.clickjacking.XFrameOptionsMiddleware

Step 3: 确保 Templates 配置正确

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates'],   # 此处需要有
        'APP_DIRS': True,                   # 也要有
        .....
    },
]

Step 4: 设置中国时区（支持中文）

LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'
USE_I18N = True
USE_L10N = True
USE_TZ = False  # 此处必须为False

Step 5: 添加 imports

from django.conf.urls import include
from django.views.generic import RedirectView

Step 6: 添加路由

path('echart/', include('smart_chart.echart.urls')),
path('', RedirectView.as_view(url='/echart/index/')),  # 首页，可自定义路由

Step 7: 初始化数据库

python manage.py makemigrations
python manage.py migrate

Step 8: 创建管理员账号（已有可跳过）

python manage.py createsuperuser

Step 9: 启动服务

python manage.py runserver

Step 10: 组件升级初始化 ⚠️ 重要！

点击首页的"组件升级"进行初始化

组件升级

注意 #

一般来说如果你使用django遇到的问题，都不是smartchart导致的 作者也很难给你解答， 建议你可以进行有偿问答

Edit Edit this page