Release Notes

What's new

• Ability to make fields read only through the Blueprint builder. #5379 by @jackmcdade

What's improved

• Update German translations. #5511 by @helloDanuk

What's fixed

• Fix issue in Runtime parser where augmenting within an expression could alter the scope. #5525 by @JohnathonKoster
• Fix Grid fields not converting to JSON by making Values implement JsonSerializable. #5524 by @jasonvarga
• Fix error when determining slug language on non-entry forms. #5523 by @jasonvarga
• Fix nested query builder access in Regex parser. #5521 by @jasonvarga
• Fix Runtime parser not supporting dashes in variable names. #5516 by @JohnathonKoster
• Fix Flysystem error on Cache Manager utility page. #5509 by @jesseleite

Read First 👀

Be sure to read the Upgrade Guide first as manual changes (especially if you're running on Laravel 7) may be necessary. You can also read the Statamic 3.3 Launch Announcement blog post to learn about many of the new features in depth!

What's new

• New Antlers Parser.
• Laravel 9 support.
• Headless Live Preview.
• Frontend form field conditions.
• Improved Blade interoperability.
• Blade tag/modifier helpers.
• Statamic::query() aliases to query builders.
• Entries and other data objects can use magic property access to get augmented values.
• Entries and other data objects can use magic methods to get query builders.
• Entries and other data objects are Arrayable.
• The static:warm command may leverage the queue.
• Hidden blueprints now have visual indicators.
• You now have more control over how values should be stored for querying. (e.g. date fieldtypes store Carbon instances.)
• Date-based where clauses are now supported by query builders.

What's fixed

• The new parser fixes an impressively large number of issues.

Major changes

• PHP 7.2 and 7.3 are no longer supported.
• Laravel 6 and 7 are no longer supported.

Special note

• Control Panel forms now only submit visible fields (as originally intended) which fixes sometimes/required_if/etc validation rules, among other things. This could potentially be a breaking change if you were using field conditions purely for cosmetic showing/hiding of form fields.

Everything else

• Review the rest of the changes in the upgrade guide.

What's fixed

• Prevent filtering users by password hashes in the APIs. #5604 by @jasonvarga
• Fix error when determining slug language on non-entry forms. #5603 by @jasonvarga

What's new

• Support whereJsonContains, whereJsonDoesntContain, and whereJsonLength in the query builder. #4707 by @ryanmitchell
• Add ability to select assets in the link fieldtype. #4647 by @jacksleight
• Add origin_id to augmented entry data. #5455 by @jasonvarga

What's improved

• Updated French translations. #5465 by @ebeauchamps
• Slugification is language-aware. #5494 by @jasonvarga

What's fixed

• Fix division by zero error when calculating asset ratio. #5488 by @arthurperton
• Register Variables debugbar collector once. #5448 by @michaelr0
• Fix link fieldtype not updating when switching sites. #5447 by @jasonvarga
• Fix a few asset issues. #5433 by @jasonvarga
• Fix nav tag's is_current and is_parent variables. #5292 by @arthurperton

What's improved

• Updated Swedish translations. #5421 by @jannejava

What's fixed

• Fix validation related error in Grid fields. #5424 by @jasonvarga
• Fix user wizard icon size. #5423 by @duncanmcclean
• Fix rare GitHub auth error output in the starter-kit:install command. #5410 by @jesseleite

What's new

• The route tag can be used with a name parameter. #5407 by @ryanmitchell
• The CP updater will prevent you upgrading to a version that could require manual changes. #5401 by @jasonvarga

What's fixed

• Namespaced translation methods #5144 by @jasonvarga
• The range fieldtype will save integers. #5391 by @jackmcdade

What's fixed

• Fixed casing of pdfobject import.

(Assets are missing from this release. Fixed in 3.2.35)

What's new

• New PDF viewer that doesn't rely on Google Docs and allows previewing of PDFs in private containers. #5349 by @edalzell
• Add duration to asset augmentation. #5265 by @schmidex
• Form validation rules are queryable in GraphQL. #5344 by @arthurperton
• Support when, unless, and tap in the query builder. #5090 by @ryanmitchell
• Support taxonomy:term:not="something" syntax. #5206 by @jackmcdade
• Add ability to filter navigation trees. #5085 by @arthurperton
• The entry GraphQL query now supports the filter argument. #5119 by @strebl
• Add Malaysian translation. #5326 by @zunnurs01

What's improved

• Improve messaging around GitHub auth errors when installing Starter Kits. #5374 by @jesseleite
• Added a notification about an updated CLI tool when installing Starter Kits. #5338 by @jesseleite
• Provide a helpful exception if a site doesn't exist when viewing a collection. #5336 by @jackmcdade
• Update Swedish translations. #5330 #5329 #5328 by @jannejava
• Update German translations. #5321 by @helloDanuk
• Update French translations. #5261 by @ebeauchamps

What's fixed

• Fix issue where items would always be placed at the end of the tree when using numeric IDs (i.e. the Eloquent driver). #5283 by @ryanmitchell
• The reverse modifier will preserve keys when modifying a collection. #5340 by @Konafets
• Prevent replacements interfering with in regex validation rules. #5345 by @arthurperton
• Fix Grid UI when using date fields with time. #5364 by @arthurperton
• The entry GraphQL query will filter out drafts by default. #5119 by @strebl
• Fix incorrect query parameter replacement in the video fieldtype. #5317 by @arthurperton
• Remove null values from Grid. #5284 by @duncanmcclean
• The collection tag will respect the custom sort field and direction in the config. #5071 by @ryanmitchell
• Remove unused parameters from call to HTML::email() #5235 by @Konafets
• Remove unused replicator method. #5281 by @jasonvarga
• Bump ajv from 6.12.2 to 6.12.6 #5258 by @dependabot
• Bump url-parse from 1.5.6 to 1.5.10 #5359 by @dependabot
• Bump color-string from 1.5.3 to 1.9.0 #5276 by @dependabot
• Bump url-parse from 1.5.1 to 1.5.6 #5275 by @dependabot
• Bump ws from 5.2.2 to 5.2.3 #5274 by @dependabot
• Bump tmpl from 1.0.4 to 1.0.5 #5273 by @dependabot
• Bump follow-redirects from 1.14.1 to 1.14.8 #5263 by @dependabot

What's new

• Support whereBetween and whereNotBetween in the query builder. #4752 by @ryanmitchell
• Ability to add config fields to existing fieldtypes. #5077 by @aerni
• Add Polish translation. #5146 by @damianchojnacki
• Replicator/Bard/Grid fields can be validated against fields in the same set/row. #5047 by @arthurperton
• Add audio and video attributes to assets. #5045 by @edalzell

What's improved

• Improve performance of fetching user roles. #5120 by @jonassiewertsen
• The password protection page is translatable. #4894 by @jelleroorda

What's fixed

• Fix toggle fieldtype alignment issues. #5251 by @arthurperton
• Fix the list modifier not working with Collections. #5255 by @ryanmitchell
• Fix incorrect exception usage in Comb. #5223 by @Konafets
• Fix incorrect exception usage in the Agolia index. #5224 by @Konafets
• Fix the structures icon not inheriting color. #5230 by @aerni
• Removed duplicated logic in nav tag. #5210 by @arthurperton
• Revert type being a reserved word for field handles. #5184 by @jasonvarga
• Fix static caching not invalidating when a collection tree is deleted. #5170 by @Konafets
• Fix HTML snippet in Bard fieldtype related messages. #5145 by @Konafets
• Set the color fieldtype's color_modes default value correctly. #5137 by @Konafets
• Prevent additional data in blueprint YAML files being removed when saving. #5129 by @jasonvarga
• A bunch of code formatting fixes. #5218 #5214 #5219 #5215 #5189 #5158 #5134 #5142 by @Konafets

What's improved

• Improve performance of the nav tag. #4925 by @FrittenKeeZ
• Prevent entering negative values into max_items/max_files configs. #5044 by @edalzell
• Prevent using type as a field handle. #5088 by @arthurperton
• Default field names are suffixed to help prevent tag/variable collisions. #5084 by @arthurperton

What's fixed

• Fix infinite loop in UI when removing assets from asset fieldtype. #5070 by @arthurperton
• Fix widont inserting spaces into nested lists. #5115 by @benfreke
• Fix Replicator preview text generation. #5096 by @arthurperton
• Fix Eloquent query builder column selects. #5125 by @jasonvarga
• Fix "passed value cannot be an array" error. #5127 by @jasonvarga
• Fix unintentionally added new abstract query builder method. #5123 by @jasonvarga
• Fix nav tag's is_parent logic so it works better for Navs. #4969 by @arthurperton
• Throw a 404 instead of 500 on Glide asset URLs when there's an invalid container. #5094 by @edalzell
• Fix Replicator's "add set" button not inserting at the right position. #5107 by @arthurperton
• Fix the "delete" action confirmation translations. #5074 by @zsoltjanes
• Bump marked from 0.7.0 to 4.0.10 #5075 by @dependabot

What's new

• Ability to exclude certain fields from displaying in the REST API. #5041 by @arthurperton
• Ability to select fields in nav, locales, and collection tags. #5068 by @jasonvarga
• Add search to the user listing in the CP. #4084 by @arthurperton
• Support whereColumn in the query builder. #4754 by @ryanmitchell

What's fixed

• The static:warm command visits taxonomy URLs, excludes taxonomy URLs with no views, includes multisite taxonomy URLs, displays the URL count, and excludes excluded URLs. #5065 by @arthurperton
• Fix how localized terms and globals save their data and fall back to origin values. #4884 by @aerni
• Prevent nested Bard fields from going into fullscreen mode. #5059 by @jonassiewertsen
• Fix infinite loop when using nested Replicator fields. #5055 by @jasonvarga
• Replaced a hardcoded lang directory reference. #5054 by @Konafets
• Fix incorrect redirect when saving a taxonomy term. #5053 by @arthurperton
• Fix SVGs not displaying in private asset containers. #4991 by @arthurperton
• Fix saving not using the latest state when you hit save too quickly after typing. #5039 by @jackmcdade
• Fix some PHP 8.1 deprecation messages. #5063 by @edalzell
• Add allowed composer plugins. #5069 by @jasonvarga

What's new

• Support sub-field querying (JSON) in the query builder. #4758 by @ryanmitchell
• The collection tag (and others) can sort by sub-fields. #5030 by @jasonvarga
• Uploaded assets may be attached to form submission emails. #4726 by @jacksleight
• Provide errors indexed by fields for the user:reset_password_form tag. #4822 by @marcorieser
• DataCollection can use the first value of an array for sorting. #4967 by @arthurperton
• Add min_ and max_filesize validation rules for assets fieldtypes. #4980 by @arthurperton

What's improved

• The display field is auto-focused in the blueprint builder. #5026 by @jackmcdade

What's fixed

• Fix state mutations in Replicator, causing the page to freeze in some situations. #5031 by @arthurperton
• Fix the Asset's remove method not removing anything. #5038 by @arthurperton
• Fix inappropriate state mutations in Grid and Assets fieldtypes. #5005 by @arthurperton
• Fix terms not being sorted appropriately in other sites. #4982 by @arthurperton
• Fix the range field's derpy layout of uneven widths #5027 by @jackmcdade
• Fix View method chainability. #5020 by @jasonvarga
• Fix unnecessary dirty state when changing sites. #5013 by @jasonvarga
• Fix readonly sub-fields in localizable Grid and Bard fields. #4962 by @arthurperton

What's new

• Support where([...]) syntax in the query builder. #4899 by @ryanmitchell
• Added login throttling to user:login_form. #4971 by @arthurperton
• Add is_homepage variable to cascade. #4995 by @edalzell
• The pagination slider window can be adjusted. #5001 by @ryanmitchell

What's improved

• Updated French translations. #4976 by @ebeauchamps
• Updated German translations. #4998 by @helloDanuk

What's fixed

• Fix red error states when dealing with nested fields (Replicator, Grid, Bard). #5002 by @arthurperton
• Prevent error when when uploading assets in forms when there's no container configured. #4974 by @arthurperton
• Fix intersection error in iterator query builder, which search uses. #5006 by @jasonvarga
• In the fieldtype selector, hide empty sections, and hide slug for forms. #4948 by @jesseleite
• Link to docs in route config field. #4986 by @Konafets
• Fix reordering in a collection ending with the word "collection". #4978 by @arthurperton
• Fix changelog dates. #4973 by @markguleno

What's new

• Entries in a multi-level structured collection can be sorted by depth-first order. #4883 by @FrittenKeeZ
• Asset folder can be renamed/moved in the Control Panel. #4028 by @arthurperton
• The pool concurrency can be configured for the Static Cache warming command. #4931 by @jelleroorda
• Add compact modifier. #4933 by @JohnathonKoster
• Add increment:reset tag. #4932 by @JohnathonKoster

What's improved

• Improve augmentation performance by caching blueprint fields. #4923 by @FrittenKeeZ
• Updated Markdown icon. #4956 by @jackmcdade

What's fixed

• Allow group_by modifier to support stringable objects. #4955 by @jasonvarga
• Hide the handle field on the asset container edit screen. #4954 by @jasonvarga
• Alphabetically order asset container tabs, and fix the redirect. #4947 by @duncanmcclean
• Fix params not working on assets tag when it's an assets fieldtype. #4731 by @jelleroorda
• Fix error when attempting to view a revision. #4945 by @jasonvarga
• Fix noparse extractions with non-Antlers layouts. #4934 by @JohnathonKoster
• Adjust Replicator update logic, which fixes nested table fields losing data. #4903 by @jesseleite
• Fix site query param on tree API endpoints. #4907 by @jesseleite
• Replace JS lazyloading with native. #4943 by @jackmcdade
• Add ends_with validation rule to the autocompletion list. #4940 by @dmgawel
• Fix pasting into Bard image alt field. #4950 by @dmgawel
• Fix checkbox position. #4957 by @jackmcdade

What's new

• Entries may have autogenerated titles and/or optional slugs. #4667 by @jasonvarga
• Query builder can perform closure based nested wheres. #4555 by @ryanmitchell
• Added a current_user variable to views. #4888 by @jacksleight

What's improved

• Refreshed fieldtype selector design. #4929 by @jackmcdade

What's fixed

• Fieldtypes no longer get assigned to the text category by default. 447c27343 by @jackmcdade
• Links in instruction text are no longer red. #4905 by @jackmcdade
• Fix issue where the wrong entry's values could appear on the front-end. #4918 by @jasonvarga
• Bumped TailwindCSS to 1.9.6. #4929 by @jackmcdade