django CMS 表单构建器 0.1.1

反馈

该项目处于早期阶段。所有反馈都受欢迎！请通过fsbraun(at)gmx.de给我发邮件。

此外，也欢迎所有贡献。

贡献

这是一个开源项目。我们很高兴收到您以问题和拉取请求形式提供的反馈。在提交您的拉取请求之前，请查阅我们的贡献指南。

我们感谢所有帮助创建和维护此包的贡献者。贡献者名单在贡献者部分。

使用django CMS的结构板创建表单

首先创建一个 Form 插件以添加表单。使用结构板创建的每个表单都需要一个唯一的标识符（格式化为slug）。

通过向表单插件添加子类来添加表单字段。子类可以是表单字段，也可以是任何其他CMS插件。CMS插件可以用于添加自定义格式化或向表单添加附加的帮助文本。

from djangocms_form_builder import actions

@actions.register
class MyAction(actions.FormAction):
    verbose_name = _("Everything included action")

    def execute(self, form, request):
        ...  # This method is run upon successful submission of the form

使用djangocms-form-builder与（现有的）Django表单

Form 插件还提供了访问已与djangocms-form-builder注册的Django表单的方法

from djangocms_form_builder import register_with_form_builder

@register_with_form_builder
class MyGreatForm(forms.Form):
    ...

或者您也可以在代码的任何其他地方通过运行 register_with_form_builder(AnotherGreatForm) 进行注册。

默认情况下，类名被转换为人类可读的表单（MyGreatForm -> "My Great Form"）。可以使用Meta类添加其他信息

@register_with_form_builder
class MyGreatForm(forms.Form):
    class Meta:
        verbose_name = _("My great form")  # can be localized
        redirect = "https://somewhere.org"  # string or object with get_absolute_url() method
        floating_labels = True  # switch on floating labels
        field_sep = "mb-3"  # separator used between fields (depends on css framework)

详细名称将在表单插件的Select字段中显示。

表单提交后，将执行表单的 save() 方法（如果有的话）。在执行 save() 方法后，用户将被重定向到 redirect 属性中给出的URL。

Django表单不可用操作。应在其 save() 方法中执行提交时应执行的所有操作。