自定义表单

Note

此页面的内容需要进行重大更新。旧页面包含过时且可能不准确的信息。您仍然可以在 Mautic Developer Documentation archived repository 中访问它。

如果您有兴趣帮助开发此页面和其他新内容的，请考虑加入文档编写工作。

请阅读 Contributing Guidelines 和 Contributing to Mautic’s documentation 以开始贡献。

要提供自定义表单字段模板或操作表单主体，请创建以下目录结构：

Field/ <– 用于自定义表单字段类型 html/

MauticFormBundle/
Builder/

_style.html.twig <– 用于自定义表单的 CSS

form.html.twig <– 用于自定义表单本身的结构

将 app/bundles/FormBundle/Resources/views/form.html.twig 的内容复制到主题的 Builder 目录中，以及一个或多个字段模板从 app/bundles/FormBundle/Views/Field/*.html.php 复制到主题的 field 目录中。然后进行自定义以获得所需的布局。

您可以向表单添加自定义样式表，方法是将包含自定义 CSS 的 _style.html.twig 文件添加到 html/MauticFormBundle/Builder 中。最好的方法是复制默认表单样式的原始内容并对其进行修改以满足您的需求。

自定义字段类型

要更改字段类型生成的 HTML，请在 Field 目录中创建一个新模板。 最好的方法是从 app/bundles/FormBundle/Resources/views/Field/*.html.twig 复制原始模板并进行修改。

如何修改包括基本 text.html.twig 模板的文件

几个模板包含基本 text.html.twig 模板，因此您可能需要修改它。在这种情况下，您还需要修改包含它的模板。更改 include 语句。

例如，email.html.twig 包含：

您需要将 @MauticForm 更改为您的主题，例如：