我想在 django-cms(在 django 管理面板中)的页面中添加一些额外的字段。如何以最简单的方式做到这一点?
5 回答
创建一个新应用程序(称为extended_cms
或其他)并models.py
创建以下内容:
from django.db import models
from django.utils.translation import ugettext_lazy as _
from cms.models.pagemodel import Page
class ExtendedPage(models.Model):
page = models.ForeignKey(Page, unique=True, verbose_name=_("Page"), editable=False, related_name='extended_fields')
my_extra_field = models.CharField(...)
然后创建一个admin.py
:
from models import ExtendedPage
from cms.admin.pageadmin import PageAdmin
from cms.models.pagemodel import Page
from django.contrib import admin
class ExtendedPageAdmin(admin.StackedInline):
model = ExtendedPage
can_delete = False
PageAdmin.inlines.append(ExtendedPageAdmin)
try:
admin.site.unregister(Page)
except:
pass
admin.site.register(Page, PageAdmin)
这会将您的扩展模型作为内联添加到您创建的任何页面。访问扩展模型设置的最简单方法是创建上下文处理器:
from django.core.cache import cache
from django.contrib.sites.models import Site
from models import ExtendedPage
def extended_page_options(request):
cls = ExtendedPage
extended_page_options = None
try:
extended_page_options = request.current_page.extended_fields.all()[0]
except:
pass
return {
'extended_page_options' : extended_page_options,
}
{{ extended_page_options.my_extra_field }}
现在您可以使用模板访问当前页面的额外选项
本质上,您所做的是创建一个带有额外设置的单独模型,该模型用作每个 CMS 页面的内联。我以前从博客文章中得到这个,所以如果我能找到我会发布它。
编辑
这是博客文章:http: //ilian.ini.org/extending-django-cms-page-model/
还有一种方法可以在不使用内联的情况下执行此操作,并且在页面表单上的任何位置都有字段。例如,我有一个“配色方案”的自定义设置,我希望它位于“基本设置”字段集下。这可以通过覆盖 ModelForm 和 ModelAdmin 的字段集来完成。另外,为了简单起见,我选择了 OneToOne 字段而不是 ForeignKey。
models.py
:
from django.db import models
from cms.models.pagemodel import Page
from django.conf import settings
class PageCustomSettings(models.Model):
page = models.OneToOneField(Page, editable=False,
related_name='custom_settings')
color_scheme = models.CharField(blank=True, choices=settings.COLOR_SCHEMES,
max_length=20)
admin.py
:
from django import forms
from django.conf import settings
from django.contrib import admin
from cms.admin.pageadmin import PageAdmin, PageForm
from cms.models.pagemodel import Page
from web.models import PageCustomSettings
color_scheme_choices = (('', '---------'),) + settings.COLOR_SCHEMES
class CustomPageForm(PageForm):
color_scheme = forms.ChoiceField(choices=color_scheme_choices,
required=False)
def __init__(self, *args, **kwargs):
# make sure that when we're changing a current instance, to set the
# initial values for our custom fields
obj = kwargs.get('instance')
if obj:
try:
opts = obj.custom_settings
kwargs['initial'] = {
'color_scheme': opts.color_scheme
}
except PageCustomSettings.DoesNotExist:
pass
super(CustomPageForm, self).__init__(*args, **kwargs)
def save(self, commit=True):
# set the custom field values when saving the form
obj = super(CustomPageForm, self).save(commit)
try:
opts = PageCustomSettings.objects.get(page=obj)
except PageCustomSettings.DoesNotExist:
opts = PageCustomSettings(page=obj)
opts.color_scheme = self.cleaned_data['color_scheme']
opts.save()
return obj
PageAdmin.form = CustomPageForm
PageAdmin.fieldsets[1][1]['fields'] += ['color_scheme']
admin.site.unregister(Page)
admin.site.register(Page, PageAdmin)
有一种官方的方式来扩展页面和标题模型,我强烈推荐这个官方文档:
- 从 docs.django-cms.org扩展页面和标题模型
如果可以的话,我还强烈建议使用占位符,因为写了这个答案,我现在更喜欢为封面图像的用例创建一个占位符。(如果您愿意,您甚至可以只获取模板中的图像 URL )。
链接摘要:
PageExtension
在您的文件中创建一个子类models.py
并注册它:class IconExtension(PageExtension): image = models.ImageField(upload_to='icons') extension_pool.register(IconExtension)
PageExtensionAdmin
在您的文件中创建一个子类admin.py
并注册它:class IconExtensionAdmin(PageExtensionAdmin): pass admin.site.register(IconExtension, IconExtensionAdmin)
最后,为了使它可以从工具栏访问,创建一个
ExtensionToolbar
in的子类cms_toolbars.py
并注册它:@toolbar_pool.register class IconExtensionToolbar(ExtensionToolbar): model = IconExtension def populate(self): current_page_menu = self._setup_extension_toolbar() if current_page_menu: page_extension, url = self.get_page_extension_admin() if url: current_page_menu.add_modal_item(_('Page Icon'), url=url, disabled=not self.toolbar.edit_mode)
官方文档进行了更详细的说明和解释。
有一个开放的 GitHub 问题,支持向普通和高级“页面设置”对话框添加元素。
我通过谷歌来到这里,答案让我走上了 Django CMS 3 Beta 的正确轨道。要扩展页面模型并将您的扩展挂接到工具栏,您可以按照官方文档进行操作:
http://django-cms.readthedocs.org/en/latest/how_to/extending_page_title.html
访问模板中的值
{{ request.current_page.<your_model_class_name_in_lowercase>.<field_name> }}
例如,我用这个模型扩展了页面模型:
from django.db import models
from cms.extensions import PageExtension
from cms.extensions.extension_pool import extension_pool
class ShowDefaultHeaderExtension(PageExtension):
show_header = models.BooleanField(default=True)
extension_pool.register(ShowDefaultHeaderExtension)
要在模板中访问其值:
{{ request.current_page.showdefaultheaderextension.show_header }}
由于我没有足够的声誉,我无法直接评论 Timmy O'Mahony 的帖子。但是我想指出,将StackedInline
对象添加到PageAdmin.inlines
列表的建议解决方案不再像预期的那样工作。
我正在使用 Djangocms 3.3 以及在 Timmy O'Mahony 版本之间的某个地方,作者更改了内联列表的语义。它的内容现在显示在该特定页面的权限菜单中(包括可能添加的更多StackedInline
或TabularInline
项目)。