Release Notes

What's new

• Norwegian translation. #5722 by @espenlg
• When there's a syntax error inside an Antlers-enabled field, the exception will show the contents. #5659 by @JohnathonKoster

What's improved

• German translations. #5715 by @helloDanuk
• French translations. #5705 by @ebeauchamps

What's fixed

• Fix runtime parser not maintaining query builder results accurately in subsequent tags. #5716 by @JohnathonKoster
• Fix the groupby operator not supporting modifiers in the runtime parser. #5716 by @JohnathonKoster
• Fix runtime parser outputting a replacement string when a stack is used with nothing pushed into it. #5716 by @JohnathonKoster
• Fix runtime parser support for multibyte characters. #5704 by @JohnathonKoster
• Fix runtime parser support for tags with parameters in Antlers-enabled fields. #5659 by @JohnathonKoster
• Fix Glide cache disk permissions. #5724 by @jasonvarga
• Fix URL typo in Dutch translation. #5772 by @MarcelWeidum
• Fix slugification not using appropriate language on the create term form. #5738 by @arthurperton
• Fix issue where Flysystem could return pathless FileAttributes response. #5726 by @jesseleite
• Fix runtime parser support for PHP assignments inside loops. #5734 by @JohnathonKoster
• Add attribute to suppress deprecation notice #5719 by @marcorieser
• Add ReturnTypeWillChange attribute #5701 by @jasonvarga

What's improved

• The site filter's badge will display the name instead of the handle. #5683 by @j3ll3yfi5h
• Show a more graceful error when hitting a rate limit on the licensing page. #5678 by @jesseleite
• The users fieldtype will show the first/last name in listings when applicable. #5677 by @j3ll3yfi5h
• The "Site selected." toast message is localizable. #5687 by @j3ll3yfi5h

What's fixed

• Fix issue where the date fieldtype could not be cleared. #5682 by @potentweb
• The cache is bypassed for tokenized GraphQL requests. #5693 by @jasonvarga
• Fix 404 handling for entries/terms in the REST API. #5690 by @notnek
• Fix an error when you have a comment at the start of a partial slot. #5651 by @JohnathonKoster
• Fix issue where the updates badge shows the wrong count in some cases. #5678 by @jesseleite
• Fix asset editor overflow issues. #5689 by @jackmcdade
• Fix issue where collections were unnecessarily converted to arrays in modifiers. #5642 by @JohnathonKoster
• A handful more Antlers bug fxies. #5571 by @JohnathonKoster
• Tidy up some Blade echo statements. #5645 by @michaelr0
• Fix the initial height of textareas. #5649 by @wiebkevogel
• Prevent slug error when used on forms without containers. #5657 by @jasonvarga
• Fix Global Variables in GraphQL not resolving query builders #5640 by @jasonvarga
• Upgraded to PHP CS Fixer v3. #5541 by @jesseleite

What's new

• Live Preview is supported in the REST API. #5623 by @jasonvarga
• Query builders can accept page name and number. #5602 by @mattmurtaugh
• Added csrf parameter to form tag. #5626 by @robdekort
• Added has_focus variable to assets. #5638 by @jasonvarga
• Added playtime variable to assets. #5586 by @jackmcdade

What's improved

• Redesigned Search Index Utility. #5625 by @jackmcdade
• Removed primary style on the Asset browser's "Create Container" button. #5629 by @jackmcdade
• Expanded Windows testing. #5613 by @jesseleite
• Updated Swedish translations. #5615 #5620 #5617 #5616 by @jannejava
• Made asset editor full width. #5608 by @jackmcdade
• Asset fields will auto-select the container when only one exists. #5498 by @duncanmcclean

What's fixed

• The to_json modifier can handle query builders. #5635 by @jasonvarga
• Fix is_external check for anchors. #5631 by @grandpalacko
• Fix Asset Editor not showing HTML5 players. #5607 by @jackmcdade

What's improved

• Update French translations. #5540 by @ebeauchamps
• Link to automatic titles section in the docs. #5553 by @jackmcdade

What's fixed

• Prevent filtering users by password hashes in the APIs. #5568 by @jasonvarga
• Prevent usage of null as filesystem paths. #5562 by @jasonvarga
• The glide tag pair can handle query builders. #5552 by @jasonvarga
• Fix Flysystem 3 support in Glide. #5551 by @jasonvarga
• Make isset on properties work. #5530 by @jasonvarga
• Range fields can now use 0 as a value or default. #5538 by @jasonvarga

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