如何在django-cms中创建Page子类并使其显示在常规菜单与页面树？

首先明确：django-cms官方不建议直接子类化Page模型，因为它的页面树、版本控制、发布流程等核心逻辑都是基于原生Page设计的，子类化可能引发兼容性问题（比如插件适配、页面状态同步异常等）。如果一定要实现，可按以下步骤操作：

1. 创建Page子类（多表继承） #

使用多表继承扩展Page，添加自定义字段：

# yourapp/models.py
from django.db import models
from cms.models.pagemodel import Page
from cms.models.pagemodel import PageManager

class CustomPage(Page):
    # 自定义字段示例
    custom_description = models.TextField(blank=True, verbose_name="自定义描述")
    
    # 复用Page管理器，确保查询时关联子类数据
    objects = PageManager()

2. 注册子类到CMS Admin #

要让自定义页面出现在后台页面树和管理界面，需要将CustomPage注册到admin，并继承CMS的页面管理类：

# yourapp/admin.py
from django.contrib import admin
from cms.admin.pageadmin import CMSPageAdmin
from .models import CustomPage

# 自定义表单，将子类字段加入编辑界面
class CustomPageForm(CMSPageAdmin.form):
    class Meta(CMSPageAdmin.form.Meta):
        model = CustomPage

class CustomPageAdmin(CMSPageAdmin):
    form = CustomPageForm

# 注册自定义页面类
admin.site.register(CustomPage, CustomPageAdmin)

3. 确保菜单显示自定义页面 #

django-cms的菜单系统默认会遍历所有Page实例（包括子类），但如果菜单未正常显示，可添加自定义菜单修饰器强制包含：

# yourapp/cms_menus.py
from cms.menu_bases import CMSAttachMenu
from menus.base import NavigationNode
from menus.menu_pool import menu_pool
from .models import CustomPage

class CustomPageMenu(CMSAttachMenu):
    name = "自定义页面菜单"

    def get_nodes(self, request):
        nodes = []
        for page in CustomPage.objects.published():
            nodes.append(NavigationNode(
                page.get_menu_title() or page.get_title(),
                page.get_absolute_url(),
                page.pk,
                parent_id=page.parent_id,
            ))
        return nodes

menu_pool.register_menu(CustomPageMenu)

关键注意事项 #

• 多表继承会生成单独的CustomPage表，与原生Page表通过外键关联，需做好数据迁移。
• 原生Page的部分操作（比如页面复制、版本发布）不会自动同步子类字段，需自定义信号或重载方法处理。
• 第三方CMS插件可能仅适配原生Page，子类页面使用插件时可能出现异常。

如果不想承担这些风险，官方推荐的PageExtension仍是更稳妥的方案——它通过关联表扩展页面字段，完全兼容CMS的核心流程。

内容的提问来源于stack exchange，提问作者Stefan