InputfieldForm class

Contains one or more fields in a form

Here is an example of creating an InputfieldForm using Inputfield modules. This particular example is an email subscription form.

$form = $modules->get('InputfieldForm');

$f = $form->InputfieldText;
$f->attr('name', 'your_name');
$f->label = 'Your Name';

$f = $form->InputfieldEmail;
$f->attr('name', 'your_email');
$f->label = 'Your Email Address';
$f->required = true;

$f = $form->InputfieldSubmit;
$f->attr('name', 'submit_subscribe');

// ProcessWire versions 3.0.205+
if($form->isSubmitted('submit_subscribe')) {
  if($form->process()) {
    $name = $form->getValueByName('your_name');
    $email = $form->getValueByName('your_email');
    echo "<h3>Thank you, you have been subscribed!</h3>";
  } else {
    echo "<h3>There were errors, please fix</h3>";
    echo $form->render();
} else {
  // form not submitted, just display it
  echo $form->render();

// same as above but works in any ProcessWire version
if($input->post('submit_subscribe')) {
  // form submitted
  $errors = $form->getErrors();
  if(count($errors)) {
    // unsuccessful submit, re-display form
    echo "<h3>There were errors, please fix</h3>";
    echo $form->render();
  } else {
    // successful submit (save $name and $email somewhere)
    $name = $form->getChildByName('your_name')->attr('value');
    $email = $form->getChildByName('your_email')->attr('value');
    echo "<h3>Thank you, you have been subscribed!</h3>";
} else {
  // form not submitted, just display it
  echo $form->render();

Click any linked item for full usage details and examples. Hookable methods are indicated with the icon. In addition to those shown below, the InputfieldForm class also inherits all the methods and properties of: InputfieldWrapper, Inputfield, WireData and Wire.

Show class?             Show args?        


InputfieldForm::action string Form action attribute (default="./") 
InputfieldForm::appendMarkup string Optional markup to append to the form output 
InputfieldForm::columnWidthSpacing int Optionally set the column width spacing (pixels) 
InputfieldForm::confirmText string Confirmation text that precedes list of changes when class InputfieldFormConfirm is active 
InputfieldForm::description string Optionally set a description headline for the form 
stringGet name for this form 
WireInputData nullReturn WireInputData provided to processInput() method or null if not yet applicable 
bool stringIs form submitted and ready to process? 
InputfieldForm::method string Form method attribute (default="post") 
InputfieldForm::prependMarkup string Optional markup to prepend to the form output 
boolProcess the form
InputfieldForm::processInput(WireInputData $input)
InputfieldWrapperProcess input
InputfieldForm::protectCSRF bool Set to false to disable automatic CSRF protection 
stringRender form
(nothing)Hook called before form render or process (3.0.171+)


arrayReturn an array of errors that occurred on any of the children during input processing. 

Additional methods and properties

In addition to the methods and properties above, InputfieldForm also inherits the methods and properties of these classes:

API reference based on ProcessWire core version 3.0.236

Latest news

  • ProcessWire Weekly #520
    In the 520th issue of ProcessWire Weekly we'll check out some of the latest additions to the ProcessWire module's directory, share some highlights from the latest weekly update from Ryan, and more. Read on! / 27 April 2024
  • ProFields Table Field with Actions support
    This week we have some updates for the ProFields table field (FieldtypeTable). These updates are primarily focused on adding new tools for the editor to facilitate input and management of content in a table field.
    Blog / 12 April 2024
  • Subscribe to weekly ProcessWire news

“ProcessWire is like a breath of fresh air. So powerful yet simple to build with and customise, and web editors love it too.” —Margaret Chatwin, Web developer