基于 Nette Forms 的 WordPress 表单库 Wenprise Forms 使用文档

关于WenpriseForms

小本本在WordPress主题开发过程中，发现WordPress一直没有提供开发者足够方便的表单生成类。因此，基于NetteForms表单库，我们开发了WordPress表单生成库——WenpriseForms，旨在提高开发效率，增加WordPress主题和插件的项目质量。

WenpriseForms提供了流畅的API，支持Web表单的生成、后端验证、前端验证、根据表单选项显示或隐藏等操作，并和WordPress结合，支持随机数验证、颜色选择、可视化编辑器、Ajax上传等高级功能。

如果您对WenpriseForms感兴趣，欢迎加入开发，也可以在Github中提Issue。

WenpriseForm安装

WenpriseForms已发布到Packagist中，如果您已使用Composer管理您的主题或插件依赖，只需运行以下命令即可安装。

composer require wenprise/forms

如果您尚未使用Composer，我们建议您使用Composer管理您的项目依赖，因为WenpriseForm库目前不提供包含入口文件引入的方式，以后也不会支持。

WenpriseForm快速使用指南

在需要显示表单的页面使用以下代码，即可添加一个action为POST，包含一个名为first_name和一个提交按钮。表单提交成功后，直接在页面显示提交的表单内容。

use Wenprise\Forms\Form;

$form = new Form;

// 设置表单渲染方法，可以根据您使用的前端框架，设置自定义渲染方法
wprs_form($form);

// 设置表单提交方法
$form->setMethod('POST');

// 设置表单字段
$form->addText('first_name', esc_html__('FirstName', 'wprs'));
$form->addSubmit('send', esc_html__('Save', 'wprs'));

// 验证表单并显示表单值
if ($form->isSuccess()) {
  // 获取前端提交过来的表单值
  $values = $form->getValues();

  // 通过访问类属性的方式获取表单值
  $first_name = $values->first_name;

  echo $first_name;
}

echo $form;

WenpriseForm表单方法

WenpriseForms中包含多种非常方便的表单方法，可以用来设置表单属性。除了下面介绍的方法之外，还有一些高级表单方法，因为不常用，我们在此不会过多介绍，详细用法请参考源代码使用。

// 设置可接收插件提交的Url

$form->setAction('/submit.php');

// 设置表单提交方法

$form->setMethod('POST');
$form->addText('first_name', esc
                        

                            

                                
                                

                                    

                                        扫码添加UTHEME微信为好友
                                    
                                    

                                        · 分享WordPress相关技术文章，主题上新与优惠动态早知道。
                                        

                                        · 微信端最大WordPress社群，限时免费入群。