A look at FormBuilder v34

I'm still working on the latest version of ProcessWire (version 3.0.106) and don't have it quite ready to push to GitHub today, so we'll save that for next week. But I do have a fairly major FormBuilder release ready, and am placing it for download in the FormBuilder support board today. In this post, I'll cover what's new in this version of FormBuilder. After that, there is a how-to guide for using hooks in FormBuilder, though some might also find it also generally useful for any hooks in ProcessWire. Lastly, there's a FormBuilder hooks reference, which has been asked for a few times lately, so figured that was a good way to round out this FormBuilder blog post.

FormBuilder version 34

FormBuilder was the first ProcessWire Pro module, and it remains one of the most popular in the ProcessWire store. With each new version, FormBuilder gets more and more powerful, while remaining very simple to use. Today I'm posting version 34 (0.3.4) of FormBuilder to the support board download thread (available to FormBuilder subscribers), right after publishing this post. While I've been using this version quite a bit here (and we're using it on this site too), for the moment, I'm considering this a beta version, since there is so much that is new. So if you opt to use it, please let me know if you run into any issues. Below is a partial list of what's new in this version, along with screenshots were relevant.

New email files as attachments option. Previously files could only be accessed via protected URL on the server. Now you can optionally configure your forms to add user uploaded files as attachments to the email that gets sent to the administrator. This option is found under the Actions tab when editing a form, in the "Send email to administrators" fieldset, field: "How to handle uploaded files?"


The file attachment feature works when using the core built-in WireMail in ProcessWire 3.x. It should also work in any version of the core when paired with one of the following WireMail modules: WireMailSMTP, WireMailPHPMailer, WireMailMailgun or WireMailMandrill. As far as I can tell, WireMailSwiftMailer and WireMailMailChimp do not support attachments (though someone correct me if I'm wrong).

Support for automatically deleting form submissions (entries) from the server, after a specific number of days. This is useful if you don't want user-submitted data to live on the server indefinitely. The option can be found on the Actions tab when editing a form, in the "Save to entries database" fieldset, field: "Automatically delete entries after how many days?". FormBuilder performs entry maintenance twice per day via LazyCron.

Multi-language options are now available for Select, Checkboxes, Radios and AsmSelect Inputfields, as well as any others that extend them. Previously you had to use Page fields for multi-language options. Note however that in order to take advantage of it, you have to use ProcessWire 3.0.105 or newer.

Improved drop-down menus in Setup > Forms, now lets you drill down directly to form-specific entries or editor. In addition, the main form list (and dropdown) now shows when the last form entry was received for each form.

Support for form-specific custom email template files. While this support was actually added in the previous version, it was not yet documented. Documentation can now be found in those template files.

New markdown and HTML options for defining your success message in the form editor. Previously the success message was plain text, unless you used a hook to modify it.

New option to specify multiple auto-responder fields (fields containing email address to send auto-responder to).

Added ability to edit the tags that FormBuilder uses for embed methods A and B. It is editable in the FormBuilder module configuration “Output” fieldset. In addition, this enables you to do things like force it to always load forms from HTTPS, or use URL without scheme/host if you prefer it.

Several new hooks have been added to the form rendering, processing and saving events. We'll outline all the available hooks in this post.

In addition to the above, various improvements have been made throughout to improve appearance and UI in AdminThemeUikit. Visual improvements have been made to the FormBuilder module configuration screen. And of course this version also contains several other minor tweaks, fixes and adjustments not mentioned here.

FormBuilder hooks: how-to guide

This section has moved here: FormBuilder hooks

FormBuilder hooks reference

This section has moved to a new page: FormBuilder hooks

FormBuilder subscribers can download FormBuilder v34 in the FormBuilder support board (download thread, requires login). Check back here next week for ProcessWire 3.0.106 and be sure to check in at weekly.pw this weekend for the latest issue of ProcessWire Weekly. Thanks for reading and have a great weekend!

Comments

  • HMCB

    HMCB

    • 1 year ago
    • 40
    Thank you Ryan. As a designer, I’ve always wanted to dive into things beyond just building pages and doing more programmatic stuff. This post has just enough to get me started. Thanks again!
  • Peter Knight

    Peter Knight

    • 1 year ago
    • 70
    Thanks for the “Support for automatically deleting form submissions...”
    I was just showing a client how to log in and delete submissions. This will save her the trouble and help her stay GDPR compliant.
  • Sergio

    Sergio

    • 1 year ago
    • 20
    Thanks Ryan. It would be great to also add to the FormBuilder backend a field, maybe called "notes", intended for admins and editorial people so that them could write and keep important information related to each form e.g. advanced custom settings info
 

PrevProcessWire 3.0.105 core updates

4

This latest version on the dev branch adds a new site profile to the core, adds useful new functions to our $mail API variable, and makes significant enhancements to our $sanitizer API variable.  More 

NextProcessWire 3.0.106 core updates

3

Several updates this week including a new way to perform $pages->find() searches by using Field tags, a new Field tag manager, new methods added to our $input API variable, new Inputfield traversal methods, and more! More 

Twitter updates

  • ProcessWire 3.0.142 has a lot of updates but the biggest is the addition of custom fields support for file and image fields. In this post, we take a closer look at that, and also outline all of the new features in the just-released FormBuilder v40— More
    11 October 2019
  • This week’s dev branch version brings you improvements to ProcessWire’s input->cookie API variable, plus it adds the ability to modify system URLs and paths at runtime. This post also includes some examples to demonstrate just how useful this can be— More
    20 September 2019
  • New post: This week we’ll take a look at a new version of FormBuilder that's on the way (with a screencast), as well as the latest version of the core: ProcessWire 3.0.140— More
    6 September 2019

Latest news

  • ProcessWire Weekly #283
    The 283rd issue of ProcessWire Weekly introduces ProcessWire 3.0.142 and FormBuilder v40, highlights some conference content, and features a new weekly poll continuing with the #processwireworks theme. Read on!
    Weekly.pw / 12 October 2019
  • ProcessWire 3.0.142 core updates
    This latest version of the core on the dev branch has a lot of updates, bnd the biggest is the addition of custom fields support for file and image fields. In this post, we take a closer look and also outline all of the new features in the just-released FormBuilder v40.
    Blog / 11 October 2019
  • Subscribe to weekly ProcessWire news

“Indeed, if ProcessWire can be considered as a CMS in its own right, it also offers all the advantages of a CMF (Content Management Framework). Unlike other solutions, the programmer is not forced to follow the proposed model and can integrate his/her ways of doing things.” —Guy Verville, Spiria Digital Inc.