You need to enable JavaScript to run this app. 如何在Django中创建仅支持单条数据的HomeConfig模型实现首页配置
优惠活动
大模型
产品
解决方案
定价
更多

如何在Django中创建仅支持单条数据的HomeConfig模型实现首页配置

Django单实例首页配置模型实现方案

1. 定义HomeConfig单例模型

直接通过模型层逻辑限制仅能存在1条数据,字段可根据你的首页元素需求自由扩展:

from django.db import models
from django.core.exceptions import ValidationError

class HomeConfig(models.Model):
    # 以下为示例字段,可根据实际需求自行增减
    site_logo = models.ImageField(upload_to="home/", verbose_name="站点Logo", blank=True)
    site_title = models.CharField(max_length=100, verbose_name="站点标题", default="首页")
    banner_img = models.ImageField(upload_to="home/", verbose_name="首页Banner图", blank=True)
    banner_desc = models.TextField(verbose_name="Banner宣传文案", default="")
    main_button_text = models.CharField(max_length=50, verbose_name="主按钮文本", default="了解更多")
    main_button_link = models.CharField(max_length=200, verbose_name="主按钮跳转路径", default="/")
    # 其他首页元素对应的字段都可以在此处添加

    class Meta:
        verbose_name = "首页配置"
        verbose_name_plural = verbose_name

    def clean(self):
        # 新增时校验是否已存在配置
        if not self.pk and HomeConfig.objects.exists():
            raise ValidationError("首页配置仅允许存在1条记录,请勿重复创建")

    def save(self, *args, **kwargs):
        self.clean()
        super().save(*args, **kwargs)

    def delete(self, *args, **kwargs):
        # 禁止删除唯一配置记录
        pass

    @classmethod
    def get_instance(cls):
        # 直接获取唯一配置实例,不存在时自动创建
        obj, _ = cls.objects.get_or_create(pk=1)
        return obj

2. 配置Admin后台优化操作体验

让后台只能编辑已有的配置,无法新增、删除,访问列表页直接跳转到编辑页:

from django.contrib import admin
from django.shortcuts import redirect
from .models import HomeConfig

@admin.register(HomeConfig)
class HomeConfigAdmin(admin.ModelAdmin):
    # 隐藏批量操作栏
    actions = None

    # 禁止新增权限
    def has_add_permission(self, request):
        return not HomeConfig.objects.exists()

    # 禁止删除权限
    def has_delete_permission(self, request, obj=None):
        return False

    # 列表页直接跳转到编辑页
    def changelist_view(self, request, extra_context=None):
        config = HomeConfig.get_instance()
        return redirect(f"../{config.pk}/change/")

3. 业务代码调用方式

视图中直接调用类方法获取配置实例即可,不需要做额外的查询判断:

from .models import HomeConfig

def home_page(request):
    home_config = HomeConfig.get_instance()
    return render(request, "home.html", {"home_config": home_config})

模板中直接通过变量调用对应字段即可,比如{{ home_config.site_title }}、{{ home_config.banner_desc }}。

注意事项

  • 后续扩展配置新增字段时,需要设置合理的默认值,避免调用get_instance()时触发字段非空报错
  • 涉及图片、文件字段的需要提前配置好Django的媒体文件存储规则

内容的提问来源于stack exchange,提问作者masdot

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 21:36:03