如何在Wagtail的每个页面中添加formbuilder制作的表单?

时间:2017-03-08 13:53:45

标签: python django django-forms wagtail

有没有办法在CMS中的每个页面添加表单(例如反馈表单)?我真的很喜欢使用Wagtail FormBuilder,因此编辑可以改变字段。

我的第一个想法是创建自定义表单页面(继承自AbstractEmailForm)作为站点根子项并将其加载到base.html trough模板标记。我可以通过这种方式访问​​页面属性,但我无法呈现表单。

这是我的模板标签:

@register.assignment_tag(takes_context=True)
def get_feedback_form(context):
  return context['request'].site.root_page.get_children().type(FeedbackFormPage).first()

这就是我在base.html中使用它的方式:

{% get_feedback_form as feedback_form %}
...
{{ feedback_form.specific.title }} <-- this works
{{ feedback_form.specific.form.as_p }} <-- this doesnt work

以某种方式将表单创建为片段或将其添加到“网站设置”会很好,但我没有找到如何做到这一点。

2 个答案:

答案 0 :(得分:5)

主要问题是如何使用.form.as_p在模板中生成表单。

您需要使用.get_form函数生成表单,但最好在模板中执行,因为当前用户和页面需要像这样的参数进入。

        form = feedback_form_page.get_form(
        page=feedback_form_page, user=request.user)

您可以在此处查看如何为AbstractForm模型构建表单: https://github.com/wagtail/wagtail/blob/master/wagtail/wagtailforms/models.py#L278

下面的完整详细示例,以及如何将表单选择工作到“站点设置”模块中。

链接到网站设置中的表单

假设您指的是Site Settings contrib模块: http://docs.wagtail.io/en/v1.13/reference/contrib/settings.html

编辑处理程序&#39;文档部分介绍了链接到站点设置内页面的好方法。 http://docs.wagtail.io/en/v1.13/reference/contrib/settings.html?highlight=site%20settings#edit-handlers

示例(在models.py中):

from wagtail.contrib.settings.models import BaseSetting, register_setting
# ...
@register_setting
class MyCustomSettings(BaseSetting):
    feedback_form_page = models.ForeignKey(
        'wagtailcore.Page', null=True, on_delete=models.SET_NULL)

    panels = [
        # note the page type declared within the pagechooserpanel
        PageChooserPanel('feedback_form_page', ['base.FormPage']),
    ]

设置此模型后,您需要执行makemigrationmigrate以使更改在管理中有效。然后,您将在设置菜单中看到一个标题为“我的自定义设置”的子菜单

将链接表格添加到每个页面

添加一个块(因此可以在模板中覆盖)在基础模板中包含一个包含(例如myapp / templates / base.html)。

<!-- Footer -->
<footer>
    {% block feedback_form %}{% include "includes/feedback_form.html" %}{% endblock feedback_form %}
    {% include "includes/footer.html" %}
</footer>

创建包含模板(例如myapp / templates / includes / feedback_form.html)

{% load feedback_form_tags wagtailcore_tags %}

{% get_feedback_form as feedback_form %}

<form action="{% pageurl feedback_form.page %}" method="POST" role="form">
  <h3>{{ feedback_form.page.title}}</h3>
  {% csrf_token %}
  {{ feedback_form.form.as_p }}
  <input type="submit">
</form>

构建模板标记以获取表单和页面

您的模板标记需要使用页面的self.get_form()函数构建表单。例如。你的模板标签(base / templatetags / feedback_form)

from django import template
from myapp.models import MyCustomSettings

register = template.Library()
# https://docs.djangoproject.com/en/1.9/howto/custom-template-tags/


@register.assignment_tag(takes_context=True)
def get_feedback_form(context):
    request = context['request']
    my_custom_settings = MyCustomSettings.for_site(request.site)
    feedback_form_page = my_custom_settings.feedback_form_page.specific
    form = feedback_form_page.get_form(
        page=feedback_form_page, user=request.user)
    return {'page': feedback_form_page, 'form': form}

答案 1 :(得分:1)

这在wagtail 2.3中仍然有效,只需要替换

@register.assignment_tag(takes_context=True)

@register.simple_tag(takes_context=True) to conform with django 2.2

此外,{% load feedback_form_tags wagtailcore_tags %}还假设您的模板标记中的文件名为feedback_form_tags.py。我不确定模板标记文件夹中是否添加了__init__.py,尽管我不确定这样做是否确实必要。