FieldtypeFormSelect by FireWire

Select a form created via the Pro Form Builder module

Fieldtype Form Select

A ProcessWire Fieldtype for creating fields where a form built using Form Builder can be chosen via a select element.

Requirements


  • ProcessWire >= 3.0
  • FormBuilder
  • PHP >= 8.1

This module was developed using FormBuilder 0.5.5 and ProcessWire 3.0.235, however it should be compatible with other versions.

How To Use


Install in ProcessWire as a module from the ProcessWire directory.

Or install with composer using composer require firewire/fieldtype-form-select.

Ensure that FormBuilder is installed, then install this module. Create some forms. Create a Form Select field and then specify which forms you would like to appear in the field under the "Details" tab. The options to select which forms will appear in the select field are as follows:

  • All forms (default)
  • Include only forms you choose
  • Include all forms except those you choose to exclude
  • Include forms where the name starts with a specified string
  • Include forms where the name ends with a specified string
  • Include forms where the name contains a specified string

You may choose how the field outputs values both when a form is or isn't selected.

Optionally, choose how the form names will appear in the select element when rendered. Options include:

  • Default name: my-form-name
  • Lowercase and spaced: my form name
  • Capitalized and spaced: My Form Name
  • First letter capitalized and spaced: My form name

This field stores the ID of the for that is selected, or null otherwise.

If a form is deleted, all Form Select fields containing a reference/ID to that form will have their value cleared and set to null.

Nifty Tricks


Form Select provides another way to render your form. To render the markup for a form that was selected, call $page->render('your_form_select_field'), and voila- your form is rendered to the page.

This module is compatible with FormBuilderHtmx which adds AJAX submission abilities to forms built with FormBuilder.

Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Latest news

  • ProcessWire Weekly #555
    In the 555th issue of ProcessWire Weekly we're going to check out the latest core updates, introduce a new third party module that adds the ability to automatically convert email messages to pages, and more. Read on!
    Weekly.pw / 28 December 2024
  • Custom Fields Module
    This week we look at a new ProFields module named Custom Fields. This module provides a way to rapidly build out ProcessWire fields that contain any number of subfields/properties within them.
    Blog / 30 August 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