Select 每个站点的基本模板

Select base template per site

我正在构建一个包含主站点和多个微型站点的设置。每个微型网站都将有一个单独的品牌,但使用相同的页面类型。

鉴于 Wagtail 已经有一个 Site 对象链接到适当的 Page 树,是否还有内置功能来配置模板加载器以选择适当的 base.html 或者将我必须编写自定义模板加载程序吗?

Wagtail 对此没有任何内置功能,因为它不会对模板的组合方式做出任何假设。但是,您可以使用 wagtail.contrib.settings 模块自己相当轻松地实现这一点,该模块提供了将自定义属性附加到各个站点的能力。例如,您可以定义一个带有 base_template 字段的 TemplateSettings 模型 - 然后您的模板可以检查此设置并动态扩展适当的模板,使用类似:

{% load wagtailsettings_tags %}
{% get_settings %}
{% extends settings.my_app.TemplateSettings.base_template %}

我扩展了 以提供对 {% extends ... %} 标记的覆盖以使用 template_dir 参数。

myapp.models:

from wagtail.contrib.settings.models import BaseSetting, register_setting

@register_setting
class SiteSettings(BaseSetting):
    """Site settings for each microsite."""

    # Database fields
    template_dir = models.CharField(max_length=255,
                                    help_text="Directory for base template.")

    # Configuration
    panels = ()

myapp.templatetags.local:

from django import template
from django.core.exceptions import ImproperlyConfigured
from django.template.loader_tags import ExtendsNode
from django.template.exceptions import TemplateSyntaxError


register = template.Library()


class SiteExtendsNode(ExtendsNode):
    """
    An extends node that takes a site.
    """

    def find_template(self, template_name, context):

        try:
            template_dir = \
                context['settings']['cms']['SiteSettings'].template_dir
        except KeyError:
            raise ImproperlyConfigured(
                "'settings' not in template context. "
                "Did you forget the context_processor?"
            )

        return super().find_template('%s/%s' % (template_dir, template_name),
                                     context)


@register.tag
def siteextends(parser, token):
    """
    Inherit a parent template using the appropriate site.
    """

    bits = token.split_contents()

    if len(bits) != 2:
        raise TemplateSyntaxError("'%s' takes one argument" % bits[0])

    parent_name = parser.compile_filter(bits[1])
    nodelist = parser.parse()

    if nodelist.get_nodes_by_type(ExtendsNode):
        raise TemplateSyntaxError(
            "'%s' cannot appear more than once in the same template" % bits[0])

    return SiteExtendsNode(nodelist, parent_name)

myproject.settings:

TEMPLATES = [
    {
        ...
        'OPTIONS': {
            ...
            'builtins': ['myapp.templatetags.local'],
        },
    },
]