【10.0】后台首页搭建和banner

【一】创建后台主页模块

python ../../manage.py startapp home

【二】创建模型表(轮播图)

luffyCity\luffyCity\utils\common_models.py

from django.db import models


class BaseModel(models.Model):
    '''
        公共字段创建基表 ---- 其他表也可能用
        id img图片地址 上传时间 是否删除 是否显示 显示排序
    '''
    created_time = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
    updated_time = models.DateTimeField(auto_now=True, verbose_name='最后更新时间')
    is_delete = models.BooleanField(default=False, verbose_name='是否删除')
    is_show = models.BooleanField(default=True, verbose_name='是否上架')
    orders = models.IntegerField(verbose_name='优先级')

    class Meta:
        abstract = True  # 这个表模型只用来继承，不用来在数据库中生成表

luffyCity\luffyCity\apps\home\models.py

from django.db import models

from luffyCity.utils.common_models import BaseModel


# Create your models here.
class Banner(BaseModel):
    title = models.CharField(max_length=16, unique=True, verbose_name='名称')
    image = models.ImageField(upload_to='banner', verbose_name='图片')
    # 点击图片，跳转到的路径
    # 前端跳转的地址： 前端路由/完整的http链接
    link = models.CharField(max_length=64, verbose_name='跳转链接')
    info = models.TextField(verbose_name='详情')  # 也可以用详情表，宽高出处

    class Meta:
        db_table = 'luffy_banner'
        verbose_name_plural = '轮播图表'

    def __str__(self):
        return self.title

【三】注册APP并执行数据库迁移

python ../../manage.py makemigrations

python ../../manage.py migrate

【四】simpleui后台管理

【1】录入数据：

在后台管理中，录入数据是一项重要任务。
通过使用simpleui，您可以在后台管理系统的界面上方便地进行数据录入操作。
通常情况下，您需要登录到后台管理系统，并选择相应的数据录入模块。
根据您的需求，选择合适的表单或页面，然后填写所需的数据信息。
这些信息可能包括文本、数字、日期等各种类型的数据。
填写完毕后，可以保存数据并进行进一步的处理或展示。

【2】主站和后台管理：

在公司的网站中，通常会分为主站和后台管理两部分。
主站是向外部用户提供产品、服务和信息的界面，用于展示公司的形象和吸引客户。
后台管理则是为运营人员提供的具有控制权和权限管理的系统，用于管理和操作网站的各个功能和数据。
后台管理系统往往有更多的功能和权限，包括数据录入、编辑、删除、统计分析等。
而主站则是给予外部用户访问和使用的界面，不涉及敏感操作和权限管理。

【3】Simpleui后台管理:

Simpleui是一款简单易用的后台管理系统框架。
它基于Python的Django框架开发，并提供了一套美观、高效的用户界面。通过使用Simpleui，您可以快速搭建一个功能齐全、易于维护的后台管理系统。
Simpleui提供了丰富的组件和插件，可以方便地进行数据录入、表单校验、数据展示、样式定制等操作。
同时，Simpleui还支持响应式布局，可以适应不同屏幕尺寸的设备，提供更好的用户体验。
在使用Simpleui进行后台管理时，您可以根据具体需求进行配置和扩展。
例如，您可以创建自定义的数据模型，定义字段名称、类型和验证规则。
您还可以创建页面，用于展示和处理特定的数据信息。
Simpleui还提供了权限管理功能，可以根据用户角色和权限设置不同的访问权限。
通过Simpleui，您可以灵活地管理网站的各项功能和数据，提高运营效率和数据管理的准确性。

【4】安装Simpleui框架

需要以下命令：
- 首先，确保您的Python已经安装并配置好了环境。
- 打开终端（Windows用户可使用命令提示符或PowerShell），输入以下命令安装Simpleui：
```
pip install django-simpleui
```
- 执行上述命令后，pip会自动下载Simpleui框架及其所依赖的库，并进行安装。
- 等待安装完成后，即可在您的Django项目中开始使用Simpleui的功能。

【5】APP注册

INSTALLED_APPS = [
    # simpleui 后台管理
    'simpleui',
]

【6】切换时区和语言

LANGUAGE_CODE = 'zh-hans'

TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True

USE_TZ = False

【7】创建超级管理员并登录后台

python ../../manage.py createsuper

用户名:  admin
电子邮件地址:  
Warning: Password input may be echoed.
Password:  521

【8】模型表注册admin

from django.contrib import admin

from luffyCity.apps.home.models import Banner


# Register your models here.
@admin.register(Banner)
class UserAdmin(admin.ModelAdmin):
    list_display = ['title', 'image', 'link', 'info', 'created_time', 'updated_time', 'is_delete', 'is_show',
                    'orders']

切换后台显示 home ---> 首页功能
- luffyCity\luffyCity\apps\home\apps.py

from django.apps import AppConfig


class HomeConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'luffyCity.apps.home'
    verbose_name = '首页功能'

【五】轮播图接口

【1】路由分发

主路由分发到APP路由

from django.contrib import admin
from django.urls import path, include
from django.views.static import serve
from django.conf import settings

urlpatterns = [
    # 后台首页接口
    path('api/v1/home/', include('luffyCity.apps.home.urls')),
]

app路由自动注册路由

from rest_framework.routers import SimpleRouter

from luffyCity.apps.home.views import BannerView

router = SimpleRouter()
router.register('banner', BannerView, 'banner')

urlpatterns = [
]
urlpatterns += router.urls

【2】主视图

luffyCity\luffyCity\apps\home\views.py

from django.shortcuts import render
from rest_framework.viewsets import GenericViewSet
from django.conf import settings
from luffyCity.apps.home.models import Banner
from luffyCity.apps.home.serializers.Banner_serializer import BannerSerializer
from luffyCity.utils.common_mixin import CommonListModelMixin


class BannerView(GenericViewSet, CommonListModelMixin):
    # 过滤出没有被删除 + 可以显示 + 优先级排序
    queryset = Banner.objects.all().filter(is_delete=False, is_show=True).order_by('orders')[:settings.BANNER_COUNT]

    serializer_class = BannerSerializer

【补充】自定义响应数据格式

luffyCity\luffyCity\utils\common_response.py

# -*-coding: Utf-8 -*-
# @File : common_response .py
# author: Chimengmeng
# blog_url : https://www.cnblogs.com/dream-ze/
# Time：2023/8/8
from rest_framework.response import Response


class CommonResponse(Response):
    def __init__(self, code=100, msg="请求成功", status=None, headers=None, **kwargs):
        data = {"code": code, "msg": msg}
        # kwargs 可能会携带数据 {token:'...'}
        if kwargs:
            data.update(kwargs)

        # 调用父类(Response)的 __init__ 方法进行初始化
        super().__init__(data=data, status=status, headers=headers)

luffyCity\luffyCity\apps\home\serializers\Banner_serializer.py

# -*-coding: Utf-8 -*-
# @File : Banner_serializer .py
# author: Chimengmeng
# blog_url : https://www.cnblogs.com/dream-ze/
# Time：2023/8/8

from rest_framework import serializers

from luffyCity.apps.home.models import Banner


class BannerSerializer(serializers.ModelSerializer):
    class Meta:
        model = Banner
        fields = ['id', 'title', 'image', 'link']

【补充】自定义视图类

luffyCity\luffyCity\utils\common_mixin.py

# -*-coding: Utf-8 -*-
# @File : common_mixin .py
# author: Chimengmeng
# blog_url : https://www.cnblogs.com/dream-ze/
# Time：2023/8/8
from rest_framework.mixins import CreateModelMixin, ListModelMixin, RetrieveModelMixin, UpdateModelMixin, \
    DestroyModelMixin

from luffyCity.utils.common_response import CommonResponse


class CommonListModelMixin(ListModelMixin):
    def list(self, request, *args, **kwargs):
        result = super().list(request, *args, **kwargs)
        return CommonResponse(data=result.data)


class CommonCreateModelMixin(CreateModelMixin):
    def create(self, request, *args, **kwargs):
        result = super().create(request, *args, **kwargs)
        return CommonResponse(data=result.data)  # {code:100,msg:成功，data:{}}


class CommonUpdateModelMixin(UpdateModelMixin):
    def update(self, request, *args, **kwargs):
        result = super(CommonUpdateModelMixin, self).update(request, *args, **kwargs)
        return CommonResponse(data=result.data)


class CommonRetrieveModelMixin(RetrieveModelMixin):
    def retrieve(self, request, *args, **kwargs):
        result = super(CommonRetrieveModelMixin, self).retrieve(request, *args, **kwargs)
        return CommonResponse(data=result.data)


class CommonDestroyModelMixin(DestroyModelMixin):
    def destroy(self, request, *args, **kwargs):
        result = super().destroy(request, *args, **kwargs)
        return CommonResponse(msg='删除成功')

luffyCity\luffyCity\settings\dev.py

###############轮播图切片配置文件#################
from luffyCity.utils.common_settings import *

luffyCity\luffyCity\utils\common_settings.py

# -*-coding: Utf-8 -*-
# @File : common_settings .py
# author: Chimengmeng
# blog_url : https://www.cnblogs.com/dream-ze/
# Time：2023/8/8

BANNER_COUNT = 4

【补充】表模型继承

表模型继承是指在实现数据库表时，通过继承的方式使得子模型能够继承父模型的字段和方法。
在给出回答之前，我先解释一下上述内容中提到的几个概念。

【1】ModelMixin：

ModelMixin 是一个 Mixin 类，它定义了一些通用的方法，可以被其他表模型继承并使用。
其中包括 to_dict 方法，用于将表模型对象序列化为字典形式的数据。
通过在继承类的定义中添加 ModelMixin，子类就可以直接使用 to_dict 方法进行对象序列化操作。

【2】to_dict() 方法：

to_dict 方法是 ModelMixin 类中定义的方法，用于将表模型对象序列化为字典形式的数据。
该方法允许通过参数指定只序列化需要的字段，可以提高性能并避免暴露不必要的数据。

【3】开源项目 Spug：

https://gitee.com/openspug/spug
Spug 是一个开源的运维平台，由国内知名技术团队开发并维护。
其中的 ModelMixin 类提供了一套常用的方法，方便开发者在表模型中使用。

【4】表模型继承的应用场景和使用方法：

在开发过程中，经常会遇到多个表模型之间存在相似的字段和方法。
此时，我们可以将这些共享的属性和方法抽象到一个父类中，然后通过继承方式让子类继承这些属性和方法，以实现代码复用和减少冗余。
在上述补充内容中提到的示例中，通过继承 ModelMixin 类，子类便可以使用 to_dict 方法将对象序列化为字典。
其中的参数 a=['id','name'] 表示只序列化 ID 和名称字段，通过指定需要的字段可以避免暴露不必要的数据，提高性能。

【5】总结来说

表模型继承是一种通过抽象共享属性和方法到父类的方式，使得子类可以继承这些属性和方法，提高代码复用性和减少冗余。
具体到示例中的 ModelMixin 类，它包含了 to_dict 方法，可以用于将表模型对象序列化为字典形式的数据。

posted @ 2023-08-19 16:59 Chimengmeng 阅读(92) 评论(0) 编辑收藏举报

刷新页面返回顶部

Dream-Z

Hope Your Life Is Worth It !

【10.0】后台首页搭建和banner

【一】创建后台主页模块

【二】创建模型表(轮播图)

【三】注册APP并执行数据库迁移

【四】simpleui后台管理

【1】录入数据：

【2】主站和后台管理：

【3】Simpleui后台管理:

【4】安装Simpleui框架

【5】APP注册

【6】切换时区和语言

【7】创建超级管理员并登录后台

【8】模型表注册admin

【五】轮播图接口

【1】路由分发

【2】主视图

【补充】自定义响应数据格式

【补充】自定义banner序列化类

【补充】自定义视图类

【补充】自定义banner切片

【补充】表模型继承

【1】ModelMixin：

【2】to_dict() 方法：

【3】开源项目 Spug：

【4】表模型继承的应用场景和使用方法：

【5】总结来说

公告