README

这是一个简单的包，用于HTML Forms插件，允许您使用Sage 10的相应Blade视图（如果存在）轻松渲染表单。

一些额外的有见地的调整包括

• 将HTML Forms管理菜单项移动到选项子菜单。
• 隐藏管理员页面侧边栏中显示的广告。

要求

• Sage >= 10.0
• HTML Forms
• PHP >= 7.3
• Composer

安装

通过Composer安装

$ composer require log1x/sage-html-forms

用法

入门

如果您还没有，请从HTML Forms管理菜单页面创建一个表单。

您可以将“表单代码”留空，因为如果存在相应的Blade视图，则不会使用它。

创建视图

您的表单创建完成后，只需使用分配给您的表单的slug生成一个视图。

$ wp acorn make:form contact-us

您将在resources/views/forms/contact-us.blade.php中找到生成的表单视图，其中包含一个简单的表单组件。

<x-html-forms :form="$form" class="my-form">
  <input
    name="name"
    type="text"
    placeholder="Full Name"
    required
  >

  <input
    name="emailAddress"
    type="email"
    placeholder="Email Address"
    required
  >

  <input
    type="submit"
    value="Submit"
  />
</x-html-forms>

当HTML Forms处理“表单操作”时，它只是获取每个输入名称以创建可用的变量。

也就是说，默认视图将提供[NAME]和[EMAILADDRESS]。

错误信息

除了在选项页面上定义您的错误信息之外，您还可以选择将它们直接提供给<x-html-forms />组件。

<x-html-forms
  :form="$form"
  :messages="['success' => 'Thank you!', 'error' => 'Yikes! Try again.']"
  class="my-form"
/>

防止移动仪表板菜单项

默认情况下，HTML Forms菜单项被移动到选项子菜单。可以通过使用hf_hide_admin_menu钩子来防止这种情况。

add_filter('hf_hide_admin_menu', '__return_false');

错误报告

如果您在Sage HTML Forms中发现错误，请打开一个issue。

贡献

无论通过PR、报告问题还是提出建议，都鼓励并感谢贡献。

许可证

Sage HTML Forms是在MIT许可证下提供的。