New: Learn Statamic on Laracasts!

Michael Aerni

Livewire Forms Release Notes

Michael Aerni

6.3.0

November 16th, 2022

What's fixed

  • Prevent random swap of conditional fields. Make sure to update your field.blade.php views according to the PR. #24

What's improved

  • Hide text fields with input_type: hidden #26

6.2.0

August 2nd, 2022

What's new

  • Adds new createdSubmission callback #21

6.1.0

July 28th, 2022

What's new

  • Adds support for the Hidden fieldtype. It's basically a shortcut to using a text field with show: false.

What's fixed

  • Fixed field conditions. This bug was introduced in v5.0.0. You should upgrade to this version to fix it.

What's improved

  • Hide form groups that don't contain any visible fields. Like when using the Hidden fieldtype or conditions.
  • Better alignment of checkbox and radio fields when displayed inline.

6.0.0

July 18th, 2022

What's new

  • You can now override messages like the form submit button and success message on a per form level. This is super useful, as you don't have to create a custom form component anymore to change a simple message string.

What's improved

  • The validation.php language file is now merged into the messages.php file

What's breaking

  • If you've published the language files, you'll have to manually migrate to the new structure. Simply publish the language files again and copy-paste the strings in question.

5.1.0

July 18th, 2022

What's fixed

  • Fixed showstopper because of accidentally changed method visibility
  • Fixed form reset on submission if the form doesn't contain a captcha field

What's improved

  • Improved field views by making field labels smaller when there is no instruction

5.0.0

July 17th, 2022

What's fixed

  • The captcha response is no longer saved to form submissions

What's improved

  • Field property methods are now executed on demand, allowing for dynamic use. This is helpful if you change a field property like options in the hydratedFields callback.
  • Make the inline_label property translatable
  • Make the show, view, and wire_model_modifier properties configurable through the form blueprint
  • Make the input_type property of Integer fields configurable

What's breaking

  • All field property methods are now protected. If you've accessed properties using their methods like defaultProperty(), you can simply remove Property and use default() instead.
  • If you've changed the view of a field through the @formField blade directive, you should remove fields., e.g. instead of 'view' => 'fields.nameInput' it should now be 'view' => 'nameInput'.

4.0.0

June 14th, 2022

What's new

  • Adds the ability to autoload custom components by form handle. Example: {{ livewire:form handle="contact" }} will load App\Http\Livewire\ContactForm.php if it exists. (#18)

Upgrade Guide

Required

  • Make sure your custom components extend Aerni\LivewireForms\Http\Livewire\BaseForm

Optional

The following changes are only necessary if you want to use the new autoloading capabilities.

  • Ensure your custom components end with Form, e.g. rename Contact to ContactForm.
  • Change your template to use the default form component, e.g. use {{ livewire:form handle="contact" }} instead of {{ livewire:contact }}.
  • You can safely remove the public string $handle property from your component.
  • If you've set the $view and $theme property, exchange them with protected static $VIEW and protected static $THEME.

3.4.0

May 27th, 2022

What's new

  • Added support for the Toggle fieldtype. This is super useful for single checkbox fields like terms and conditions.

What's improved

  • Labels and legends are now available for screen readers even if a field has show_label: false. This only applies to newly created themes. Feel free to copy-paste the field stubs into your existing themes.

3.3.0

May 25th, 2022

What's fixed

  • Fixed mail attachments (requires Statamic 3.3.12+)
  • Fixed an issue that wouldn't let you select a new file in an asset field with max_files: 1
  • Asset fields are now reset after the form has been submitted

What's new

  • Required Statamic 3.3.12+

3.2.0

March 17th, 2022

What's new

  • Added support for Laravel 9

3.1.0

March 17th, 2022

What's new

  • Added support for Statamic 3.3

3.0.0

January 21st, 2022

What's new

  • Added support for field conditions. Go nuts!
  • Added support for the assets fieldtype.
  • Complete refactor introducing a whole bunch of new concepts and customization options like themes, components, hooks, callbacks, and more. Make sure to read the docs.

What's breaking

  • Dropped support for PHP 7.4
  • Changed the form parameter on the component to handle.
  • The component view now defaults to default and not the handle of the form anymore. Use the view parameter on the component to use a different view.
  • You now need a theme. Run php please livewire-forms:theme to create one.
  • There are lots of breaking changes in the form views. Migrate your old views to the views in the theme you just created.
  • There are probably other changes as well. Just make sure to read the docs and follow the instructions. It should be pretty easy to upgrade.

2.0.0

August 4th, 2021

What's new

  • Added support for Google reCAPTCHA v2.
  • You can now use show_label on all fieldtypes.
  • select fields now also render their instructions.

What's fixed

  • Avoid name collisions when using multiple forms on the same page.

What's breaking

  • Removed support for Antlers views. You can still import your form component in your Antlers views, but the form views themselves are only provided in Blade now. If you published your form views in Antlers, they will no longer work. You will need to publish the form views afresh and update the markup according to your changes.
  • Multiple changes to the form views. If you published the views, you have to manually update them.

1.1.0

June 23rd, 2021

What's new

  • You can now define the form view using the new view parameter.

What's improved

  • The form views are now stored in their own directory views/livewire/forms. Make sure to move your existing views there.

1.0.0

May 15th, 2021

🎉 Initial release!