Release Notes for Craft CMS 4

Unreleased

Improved craft\helpers\FileHelper::getExtensionByMimeType() for some ambiguous, web-friendly MIME types.
Fixed a bug where reverting an entry’s content from a revision could omit some Matrix blocks.
Fixed an error that could occur when adding a new site to an entry which contained Matrix blocks, if the same site had been added and removed previously.
Fixed a bug where Matrix blocks nested within Neo or Super Table fields could be omitted when propagating an entry to a new site. (#13207)
Fixed two XSS vulnerabilities.

4.4.11 - 2023-05-15

Fixed a bug where Matrix blocks weren’t getting propagated to newly-added sites for entries. (#13181)
Fixed a SQL error that could occur when updating to Craft 4.4 on PostgreSQL. (#13186)
Fixed a bug where craft\helpers\StringHelper::isUtf8() was unreliable.
Fixed a styling issue with Date fields. (#13182)

4.4.10.1 - 2023-05-10

Fixed a bug where it wasn’t possible to add new Matrix blocks via the “Add a block” menu. (#13177)

4.4.10 - 2023-05-09

PHP warnings and notices no longer halt execution when Dev Mode is disabled. (#13164)
Fixed a “Double-instantiating a menu button on an element” console warning that occurred on pages with Matrix fields. (#6338)
Fixed a bug where Quick Post widget settings weren’t filtering custom field options for the selected entry type.
Fixed a bug where Matrix blocks could get detached from entries when sections were enabled for a new site. (#13155)
Fixed an error that could occur when entrifying a global set without a field layout. (#13156)
Fixed a bug where Single entries’ edit pages could have “Save and add another” actions. (#13157)
Fixed styling issues with Date fields. (#13167)
Fixed the vertical alignment of element labels. (#13168)
Fixed a bug where the System Report utility could display MariaDB’s MySQL-equivalent version, if it was listed first in the server version string.
Added craft\helpers\ArrayHelper::containsRecursive().
craft\helpers\App::normalizeVersion() now returns the highest version found before distribution info.

4.4.9 - 2023-05-02

Volumes no longer validate if their field layout contains a field called extension, filename, height, kind, size, or width.
It’s now possible for plugins to register errors to entries’ typeId, parentId, and authorId attributes. (#13138)
Stack traces returned by craft\helpers\App::backtrace() now more closely resemble exception stack traces.
“Element query executed before Craft is fully initialized” warnings now include a stack trace.
Fixed a bug where queue-runner Ajax requests triggered on the front end weren’t getting closed before running the queue, potentially causing long front-end load delays.
Fixed a bug where long element titles weren’t wrapping. (#13143)
Fixed a user enumeration timing attack vulnerability.
Fixed a SQL error that could occur when upgrading to Craft 4, if any matrixblocks table rows referenced nonexistent element IDs. (#13121)
Fixed a SQL error that could occur when upgrading to Craft 4, if anything triggered an asset or volume query. (#13130)
Fixed a SQL error that occurred when deleting a category group on PostgreSQL, when configured with a table prefix. (#13127)
Fixed a bug where it was possible to query for elements with soft-deleted site IDs.
Fixed a JavaScript error that could occur on the control panel login form.

4.4.8 - 2023-04-25

Category/tag/global set reference tags now map to entries, if no category groups/tag groups/global sets exist. (#13082)
HTML Purifier now allows data-oembed-url attributes on div tags. (craftcms/ckeditor#80)
Added craft\queue\Queue::EVENT_AFTER_EXEC_AND_RELEASE. (#13096)
craft\services\Elements::propagateElements() now returns the element in the target site.
A globally-defined element thumb loader is now available in the control panel via Craft.cp.elementThumbLoader.
Fixed a bug where it was possible to select a disallowed volume as the Default Asset Location in Assets field settings. (#13072)
Fixed a bug where it was possible to upload files to Assets fields outside of the allowed volumes, if the Default Upload Location was set to a disallowed volume. (#13072)
Fixed an error that could occur if a Plain Text field had over 1,000,000 bytes. (#13083)
Fixed a bug where relational field values weren’t yielding any results for event handlers immediately after a draft had been merged. (#13087)
Fixed a bug where element labels could bleed out of their container. (#13099)
Fixed an error that occurred if yii\web\UrlManager::addRules() was called on a console request. (#13109)
Fixed a bug where it was possible to select the current folder as the target when moving a volume folder, resulting in the folder and its contents being lost. (#13118)
Fixed an error that could occur when running tests. (#13076)
Fixed an error that occured when sending the activation email for a new user, if there were any validation errors due to new group assignments. (#13060)
Fixed a bug where the “Send an activation email now” user account checkbox was losing its value if there were any validation errors.
Fixed an error that could occur when creating a database backup on MySQL and MariaDB. (#12996)
Fixed a bug where Edit Category screens were including a Parent field, even if the category group’s Max Levels was set to 1. (#13097)
Fixed a bug where the uploader’s user photo wasn’t always loading on Edit Asset pages.
Fixed a bug where the “Delete for site” bulk element action was deleting disabled elements and drafts across all sites. (#13116)
Fixed a bug where Entries and Categories fields with “Maintain hierarchy” enabled could lose relations to elements that didn’t exist in the primary site. (#13057)

4.4.7.1 - 2023-04-15

Locked the Yii 2 PSR Log Target library to 1.1.3 to avoid a PHP error that occurs on 1.1.4.

4.4.7 - 2023-04-11

Improved the control panel styling when the Debug Toolbar is enabled.
The image transformer now verifies that transforms don’t exist if the index record is missing, before queuing up the transform generation, for local filesystems. (#13052)
Added the --propagate-to and --set-enabled-for-site options to the resave/entries command.
Craft’s bootstrap script now defines a CRAFT_ENVIRONMENT environment variable, as a safety measure for plugins that may be checking for it rather than Craft::$app->env.
Added craft\helpers\ElementHelper::siteStatusesForElement().
craft\elements\Asset::EVENT_BEFORE_DEFINE_URL now sends a craft\events\DefineAssetUrlEvent object, rather than craft\events\DefineUrlEvent. (#13018)
craft\web\View::renderObjectTemplate() now trims the returned template output.
Fixed a bug where users were “View other users’ drafts” section permissions weren’t being enforced for unpublished drafts.
Fixed a bug where Matrix fields weren’t counting disabled blocks when enforcing their Min Blocks settings. (#13059)
Fixed a bug where volume folder modals’ sidebars and content were being cut off. (#13074)
Fixed a bug where element editors were showing provisional changes, even if the user didn’t have permission to save them.
Fixed a bug where the control panel could be inaccessible if a mutex lock couldn’t be acquired for the queue. (#13052)
Fixed a bug where it wasn’t possible to update a Matrix block on a revision without a new block ID being assigned. (#13064)
Fixed a JavaScript error that could occur on field layout designers, if any tabs didn’t have any elements. (#13062)
Fixed a bug where selecting an image with a transform within an asset selector modal wasn’t ever resolving.
Fixed a PHP error that could occur if there was a problem sending a password-reset email. (#13070)
Fixed a bug where users’ User Groups and Permissions settings were getting cleared in the UI when sending an activation email, if the email failed to send. (#13061)
Fixed XSS vulnerabilities.
Updated yii2-debug to 2.1.22. (#13058)

4.4.6.1 - 2023-04-04

Fixed a bug where Categories fields weren’t retaining custom sort orders when “Maintain hierarchy” was disabled. (#10560)

4.4.6 - 2023-04-04

Content tab menus now reveal when a tab contains validation errors, and invalid tabs’ menu options get the same warning icon treatment as inline tabs do. (#12971)
Selectize menus now expand upwards when there’s not ample space below them. (#12976)
Element index bulk action spinners are now centered on the viewport. (#12972)
All control panel errors are new presented via error notifications rather than browser alerts. (#13024)
The up command now sets its default --isolated option value to true, and no longer creates a redundant mutex lock.
Added craft\base\Element::EVENT_BEFORE_DEFINE_URL. (#13018)
Added craft\utilities\AssetIndexes::volumes().
craft\controllers\AssetIndexesController::actionStartIndexing() now cross-references the selected volumes with those allowed by craft\utilities\AssetIndexes::EVENT_LIST_VOLUMES event handlers. (#13039, #12819)
Fixed a bug where Assets fields weren’t respecting their View Mode setting when viewing entry revisions. (#12948)
Fixed a bug where asset pagination was broken when there was more than 100 subfolders. (#12969)
Fixed a bug where entry index pages’ “Revision Notes” and “Last Edited By” columns weren’t getting populated for disabled entries. (#12981)
Fixed a bug where assets were getting relocated to the root volume folder when renamed. (#12995)
Fixed a bug where it wasn’t possible to preview entries on another domain when the system was offline. (#12979)
Fixed a bug where users were able to access volumes they didn’t have permission to view via Assets fields. (#13006)
Fixed a bug where zero-width spaces, invisible plus signs, and byte order marks weren’t getting stripped from sanitized asset filenames. (#13022)
Fixed a bug where the Plugin Store wasn’t accurately reporting installed plugins’ license statuses. (#12986)
Fixed a bug where the Plugin Store wasn’t handling 403 API responses for cart operations properly, once a cart had been handed off to Craft Console and assigned to an organization. (#12916)
Fixed a bug where craft\helpers\FileHelper::absolutePath() wasn’t treating Windows file paths beginning drive letters as absolute. (craftcms/generator#16)
Fixed a bug where it wasn’t possible to sort Categories fields with “Maintain hierarchy” disabled. (#10560)
Fixed a bug where selectize inputs didn’t have a minimum width. (#12950)
Fixed a bug where the wrong tab would appear to be initially selected after an autosave, if the selected tab had changed during the autosave. (#12960)
Fixed a bug where it wasn’t possible to add a Dropdown field without a blank option to a global set. (#12965)
Fixed a bug where automatically-added Matrix blocks (per the field’s Min Blocks setting) were getting discarded if no changes were made to them. (#12973)
Fixed an error that could occur when installing Craft with an existing project config, if any image transforms were defined that didn’t specify the upscale property.
Fixed a bug where nested folders in asset search results weren’t showing their relative path.
Fixed a bug where admin tables’ default delete icon title text wasn’t getting translated. (#13030)
Fixed a bug where it was possible to save a Local filesystem pointed at a system directory (e.g. the templates/ or vendor/ folders), which mitigates a potential RCE vulnerability.
Fixed XSS vulnerabilities.

4.4.5 - 2023-03-21

Fixed a bug where relation data was getting deleted when running garbage collection on PostgreSQL. (#9905)
Fixed a bug where Lightswitch fields’ “OFF Label” and “ON Label” settings weren’t getting translated. (#12942)
Fixed a bug where craft\events\DefineUserContentSummaryEvent::$userId was never set for craft\controllers\EVENT_DEFINE_CONTENT_SUMMARY events. (#12944)
Fixed a bug where element edit pages weren’t displaying layout tabs that didn’t have a unique name. (#12928)
Fixed a bug where the CRAFT_LOG_PHP_ERRORS constant/environment variable wasn’t being respected when set to false. (#12862)
Fixed a bug where the entrify/categories command wasn’t converting disabled categories. (#12945)
Updated svg-sanitizer to 0.16. (#12943)

4.4.4 - 2023-03-20

Input autofocussing has been reintroduced throughout the control panel. (#12921)
The |json_encode Twig filter now calls craft\helpers\Json::encode() internally, improving error handling. (#12919)
craft\helpers\Json::encode() no longer sets the JSON_UNESCAPED_SLASHES flag by default.
Fixed a JavaScript error that occurred when resolving an asset move conflict. (#12920)
Fixed a bug where volume subfolders were being shown when viewing soft-deleted assets. (#12927)
Fixed a bug where structure data was getting deleted when running garbage collection on PostgreSQL. (#12925)
Fixed an error that could occur when rebuilding the project config, if there were any custom source definitions for element types that weren’t Composer-installed. (#12881)
Fixed an XSS vulnerability.

4.4.3 - 2023-03-16

Customize Sources modals no longer hide when the Esc key is pressed on the surrounding area is clicked on. (#12895)
Sections created via entrify commands no longer get a “Primary entry page” preview target by default, unless it was sourced from a category group with URLs. (#12897)
entrify commands and the sections/create command now prompt for the initial entry type name and handle. (#12894)
Added craft\helpers\FileHelper::uniqueName().
Added craft\helpers\StringHelper::emojiToShortcodes().
Added craft\helpers\StringHelper::shortcodesToEmoji().
Fixed an error that occurred when uploading an asset with a filename over 250 characters long. (#12889)
Fixed an error that could occur when preparing licensing alerts, if any licenses were invalid. (#12899)
Fixed a bug where it wasn’t possible to drag nested Neo blocks. (#12896)
Fixed a bug where fields with reduced widths in Matrix blocks were becoming full-width while dragged. (#12909)
Fixed a bug where multi-edition plugins weren’t showing their edition labels within the Plugin Store cart. (#12910)
Fixed a bug where private plugins’ control panel templates weren’t directly accessible by URL.
Fixed a bug where element selector modals were persisting parts of their state in the query string. (#12900)
Fixed a PHP error that occurred if a field type stored enum values. (#12297)
Fixed an error that could occur when generating transforms for images stored in Google Cloud Storage. (#12878)
Fixed a bug where some unicode characters were getting removed by LitEmoji. (#12905)

4.4.2 - 2023-03-14

The entrify/categories and entrify/global-set commands now update user permissions for the new sections. (#12849)
Variable dumps now use a light theme for web requests by default. (#12857)
Added the dumper application component and craft\base\ApplicationTrait::getDumper(). (#12869)
Added craft\models\ImageTransform::getConfig().
Fixed a bug where it wasn’t always possible to access entry or category edit pages if the slugWordSeparator config setting was set to /. (#12871)
Fixed a bug where craft\helpers\Html::parseTagAttribute() wasn’t decoding attribute values, which could lead to double-encoded attributes, e.g. when using the |attr filter. (#12887)
Fixed a bug where multi-value field inputs would be considered modified even if they weren’t, if the field type’s isValueEmpty() method returned true. (#12858)
Fixed a bug where asset thumbnails within secondary slideout tabs weren’t loading immediately. (#12859)
Fixed a bug where rebuilding the project config would lose track of image transforms’ fill and upscale settings. (#12879)
Fixed a bug where blank Dropdown options weren’t showing up in the Selectize menu. (#12880)
Fixed a bug where it was possible to save a Dropdown field without a value, even if the field didn’t have any blank options. (#12880)
Fixed a bug where element action triggers weren’t centered for element sources that don’t define any exporters. (#12885)
Fixed an error that could occur when generating a transform URL for an image in the temp folder.
Fixed XSS vulnerabilities.
Fixed an SSRF vulnerability.

4.4.1 - 2023-03-09

Fixed a bug where it wasn’t possible to select subfolders on the Assets index page. (#12802)
Fixed a bug where element index search inputs were losing focus when the element listing was updated. (#12846)
Fixed a bug where the database driver was being referenced as “MySQL” when using MariaDB. (#12827)
Fixed a bug where users weren’t able to select assets within Assets fields, if they didn’t have full permissions for the volume. (#12851)
Fixed a bug where the Assets index page’s URL would get updated incorrectly when renaming a subfolder.
Fixed a bug where non-admin users weren’t able to view Single section entries. (#12838)
Fixed an error that could occur when saving an element with eager-loaded relations. (#12839)
Fixed a bug where Customize Sources modals weren’t showing source headings with no subsequent sources. (#12840)
Fixed a bug where entrify commands could leave the database and project config data in inconsistent states, if aborted prematurely. (#12850)
Fixed a bug where the entrify/global-set command wasn’t always suggesting the command to run on other environments.
Fixed a bug where the Assets index page would appear to keep loading indefinitely after renaming a subfolder.
Fixed a bug where folders within asset indexes were getting the current site name appended to them, on multi-site installs. (#12852)
Fixed a SQL error that could occur when updating to Craft 4.4 on PostgreSQL. (#12855)
Added craft\db\Connection::getDriverLabel().

4.4.0 - 2023-03-08

Content Management

Volume subfolders are now displayed within the element listing pane on asset indexes, rather than as nested sources in the sidebar. (#12558, #9171, #5809)
Asset indexes now display the current subfolder path above the element listing. (#12558)
Assets and folders can now be drag-and-dropped simultaneously. (#12792)
Reduced the likelihood of accidentally triggering an asset drag operation. (#12792)
Reduced the likelihood of accidentally dropping dragged assets/folders on an unintended target. (#12792)
It’s now possible to move volume folders and assets to a new location via a new “Move…” bulk element action, rather than via drag-and-drop interactions. (#12558)
It’s now possible to sort asset indexes by image width and height. (#12653)
Structured element index sources now have a dedicated view mode option for showing elements as a structured table. (#12722, #12718)
Entry and category indexes can now have “Ancestors” and “Parent” columns. (#12666)
All element sources now have a “Duplicate” action, even if the element type’s defineActions() method didn’t include one. (#12382)
Element index pages now track the search term in a query param, so the results can be shared. (#8942, #12399)
Entries with more than 10 revisions now include a “View all revisions” item within their revision menu, which links to a new revisions index page for the entry that paginates through all its revisions. (#8609)
Entries and Categories fields now have “Maintain hierarchy” settings, which become available when a single structured source is selected. (#8522, #8748, #10560, #11749)
Entries fields now have a “Branch Limit” setting, which becomes available when “Maintain hierarchy” is enabled, replacing “Min Relations” and “Max Relations”.
Categories fields now have “Min Relations” and “Max Relations” settings, which become available when “Maintain hierarchy” is disabled, replacing “Branch Limit”.
Added “Viewable” asset and entry condition rules. (#12240, #12266)
Renamed the “Editable” asset and entry condition rules to “Savable”. (#12266)
Assets, categories, and entries will now redirect to the last-selected source on their index pages when saved. (#11996)
Dropdown fields that don’t have a blank option and are missing a value will now include and select a blank option at the beginning of their menu. (#12235)
Tip and Warning field layout UI elements can now be marked as dismissible, giving authors the ability to hide them. (#12188)
All assets now get thumbnails in the control panel, even if they don’t have a transform filesystem with a base URL. (#12531)
Dropdown and Multi-select fields now use Selectize. (#8403)
Improved the styling of bulk element action triggers. (#12793)

Accessibility

Improved the announcement menu for screen readers. (#12361)
Improved keyboard control of the Updates utility. (#12189)
Improved the color contrast and keyboard control of the Customize Sources modal. (#12233)
Improved info icons for screen readers. (#12272)
Removed input autofocussing throughout the control panel. (#12324, #12332, #12406)
Improved the login screen for screen readers. (#12386)
Improved conditional and required field indicators for screen readers. (#12509)
Improved element index pages for screen readers. (#12731)
Improved bulk element action triggers on element index pages. (#12415)
Improved the color contrast of element indexes. (#12213)
Asset preview modals now show videos’ alt text. (#12637)
Improved element indexes’ “Export” buttons for screen readers. (#12754)
Improved Quick Post widgets’ “Fields” settings for screen readers. (#12772)
Improved some element selector modals for screen readers. (#12783)
Fixed a bug where it wasn’t possible to vertically scroll element index filter HUDs. (#12751)
Fixed a bug where translated locale names within users’ “Language” and “Formatting Locale” preference menus didn’t have lang attributes. (#12773)
Fixed a bug where search icons on element indexes weren’t hidden from screen readers. (#12785)

Administration

Most licensing isuses are now consolidated into a single control panel alert, with a button to resolve them all with a single purchase on Craft Console. (#12768)
Conditional layout components are now identified using a condition icon within field layout designers. (#12250)
All CLI commands now support an --isolated option, which ensures the command is run in isolation. (#12337, #12350)
Added the entrify/categories, entrify/tags, and entrify/global-set commands, for converting categories, tags, and global sets to entries. (#12689, #9781)
Added the sections/create and sections/delete commands. (#12689)
The plugin/install, plugin/uninstall, plugin/enable, and plugin/disabled commands now support an --all option, which applies the action to all applicable Composer-installed plugins. (#11373, #12218)
The project-config/apply command now supports a --quiet option, which reduces the command output. (#12568)
Added the users/unlock console command. (#12345)
The Asset Indexes utility no longer skips volumes if the root folder was completely empty. (#12585, #12604)
The Asset Indexes utility now has a “List empty folders” setting, which determines whether empty folders sholud be listed for deletion from the index. (#12604)
The Asset Indexes utility now lists missing/empty folders and files separately in the review screen. (#12604)
Relational condition rules for conditions that are saved to the project config now accept a Twig template which outputs a related element ID dynamically. (#12679, #12676)
Image transform settings no longer show the “Default Focal Point” setting when Mode is set to “Fit”, as the setting had no effect. (#12774)
Improved the CLI output for index-assets commands. (#12604)

Development

Added the “Letterbox” (letterbox) image transform mode. (#8848, #12214)
Added the preloadSingles config setting, which causes front-end Twig templates to automatically preload Single section entries which are referenced in the template. (#12698)
Control panel-defined image transforms now have an “Allow Upscaling” setting, which will initially be set to the upscaleImages config setting for existing transforms. (#12214)
Template-defined image transforms can now have an upscale setting. The upscaleImages config setting will be used by default if not set. (#12214)
Added the exec command, which executes an individual PHP statement and outputs the result. (#12528)
Added the editable and savable asset query params. (#12266)
Added the savable entry query param. (#12266)
The editable entry query param can now be set to false to only show entries that can’t be viewed by the current user. (#12266)
Added the {% dump %} tag, which dumps variables into a new “Dumps” Debug Toolbar panel. (#12506)
Added the base64_decode and base64_encode Twig filters. (#12696)
The dump() Twig function now utilizes Craft::dump(), and no longer requires Dev Mode to be active. (#12486, #12479)
The {% dd %} Twig tag can now output the entire context array, if no variable is passed to it. (#12486)
Added the revisionNotes field to elements queried via GraphQL. (#12610)
Added ancestors and descendants fields to categories queried via GraphQL. (#12427)
Added craft\elements\Asset::getFormat() and the format field for assets queried via GraphQL. (#12398, #12521)
Craft::dump(), Craft::dd(), the dump() Twig function, and the {% dd %} Twig tag now use Symfony’s VarDumper. (#12479)
Craft::dump() now has a $return argument, which will cause the resulting dump to be returned as a string rather than output, if true.
craft\elements\Asset::getMimeType() now has a $transform argument, and assets’ mimeType GraphQL fields now support a @transform directive. (#12269, #12397, #12522)
craft\helpers\App::env() now returns null if the original value was 'null'. (#12742)
craft\helpers\Db::escapeParam() now escapes :empty: and :notempty: strings. (#12691)

Extensibility

Added support for private plugins. (#12716, #8908)
Added the elements/revisions action. (#12211)
Console controllers that directly use craft\console\ControllerTrait no longer need to call $this->checkTty() or $this->checkRootUser() themselves; they are now called from ControllerTrait::init() and beforeAction().
Element source definitions can now include a defaultSourcePath key.
Element custom field validation now respects the list of attributes passed to validate().
Improving IDE autocompletion for chained query param calls. (#12656)
Added craft\base\ApplicationTrait::getEditionHandle().
Added craft\base\BaseFsInterface. (#12709)
Added craft\base\Batchable.
Added craft\base\Element::cpRevisionsUrl().
Added craft\base\Element::indexElements().
Added craft\base\ElementInterface::findSource().
Added craft\base\ElementInterface::getCpRevisionsUrl().
Added craft\base\ElementInterface::getUiLabelPath().
Added craft\base\ElementInterface::indexElementCount().
Added craft\base\ElementInterface::setUiLabelPath().
Added craft\base\Event, which provides a once() static method for registering an event handler that will only be triggered up to one time.
Added craft\console\ControllerTrait::beforeAction().
Added craft\console\ControllerTrait::failure().
Added craft\console\ControllerTrait::init().
Added craft\console\ControllerTrait::markdownToAnsi().
Added craft\console\ControllerTrait::note().
Added craft\console\ControllerTrait::options().
Added craft\console\ControllerTrait::runAction().
Added craft\console\ControllerTrait::success().
Added craft\console\ControllerTrait::tip().
Added craft\console\ControllerTrait::warning().
Added craft\db\QueryBatcher.
Added craft\debug\DumpPanel.
Added craft\elements\conditions\assets\ViewableConditionRule. (#12266)
Added craft\elements\conditions\ElementCondition::$referenceElement.
Added craft\elements\conditions\entries\ViewableConditionRule. (#12266)
Added craft\elements\Entry::EVENT_DEFINE_PARENT_SELECTION_CRITERIA. (#12475)
Added craft\events\DefineInputOptionsEvent. (#12351)
Added craft\events\ListVolumesEvent.
Added craft\events\UserPhotoEvent. (#12360)
Added craft\fields\BaseOptionsField::EVENT_DEFINE_OPTIONS. (#12351)
Added craft\fields\BaseRelationField::$branchLimit.
Added craft\fields\BaseRelationField::$maintainHierarchy.
Added craft\helpers\Db::rawTableShortName().
Added craft\helpers\ImageTransforms::generateTransform().
Added craft\helpers\ImageTransforms::parseTransformString().
Added craft\helpers\StringHelper::toHandle().
Added craft\helpers\Template::fallback().
Added craft\helpers\Template::fallbackExists().
Added craft\helpers\Template::preloadSingles().
Added craft\image\Raster::scaleToFitAndFill().
Added craft\image\Raster::setFill().
Added craft\imagetransforms\FallbackTransformer.
Added craft\models\CategoryGroup::$dateDeleted.
Added craft\models\ImageTransform::$fill.
Added craft\models\ImageTransform::$upscale.
Added craft\models\TagGroup::$dateDeleted.
Added craft\models\VolumeFolder::getHasChildren().
Added craft\models\VolumeFolder::setHasChildren().
Added craft\queue\BaseBatchedJob. (#12638)
Added craft\queue\jobs\GenerateImageTransform. (#12340)
Added craft\services\Assets::createFolderQuery().
Added craft\services\Assets::foldersExist().
Added craft\services\Elements::deleteElementForSite().
Added craft\services\Elements::deleteElementsForSite().
Added craft\services\Elements::EVENT_AFTER_DELETE_FOR_SITE. (#12354)
Added craft\services\Elements::EVENT_BEFORE_DELETE_FOR_SITE. (#12354)
Added craft\services\Entries::getSingleEntriesByHandle(). (#12698)
Added craft\services\Fields::getFieldsByType(). (#12381)
Added craft\services\Path::getImageTransformsPath().
Added craft\services\Search::normalizeSearchQuery().
Added craft\services\Users::EVENT_AFTER_DELETE_USER_PHOTO. (#12360)
Added craft\services\Users::EVENT_AFTER_SAVE_USER_PHOTO. (#12360)
Added craft\services\Users::EVENT_BEFORE_DELETE_USER_PHOTO. (#12360)
Added craft\services\Users::EVENT_BEFORE_SAVE_USER_PHOTO. (#12360)
Added craft\utilities\AssetIndexes::EVENT_LIST_VOLUMES. (#12383, #12443)
Renamed craft\elements\conditions\assets\EditableConditionRule to SavableConditionRule, while preserving the original class name with an alias. (#12266)
Renamed craft\elements\conditions\entries\EditableConditionRule to SavableConditionRule, while preserving the original class name with an alias. (#12266)
craft\services\AssetIndexer::startIndexingSession() and createIndexingSession() now have a $listEmptyFolders argument. (#12604)
craft\base\ElementQuery::joinElementTable() now accepts table names in the format of {{%tablename}}.
craft\models\Volume now implements craft\base\BaseFsInterface. (#12709)
craft\services\Categories::getGroupByHandle() now has a $withTrashed argument.
craft\services\Globals::getSetByHandle() now has a $withTrashed argument.
craft\services\Tags::getTagGroupByHandle() now has a $withTrashed argument.
craft\services\Users::sendActivationEmail(), sendNewEmailVerifyEmail(), sendPasswordResetEmail(), getActivationUrl(), getEmailVerifyUrl(), getPasswordResetUrl(), and setVerificationCodeOnUser() will now throw a craft\errors\InvalidElementException if the user has a non-unique email. (#12431, #12712)
Deprecated craft\elements\Asset::getFs(). getVolume() should be used instead.
Deprecated craft\helpers\Assets::sortFolderTree().
Deprecated craft\imagetransforms\ImageTransformer::ensureTransformUrlByIndexModel(). getTransformUrl() should be used instead.
Deprecated craft\imagetransforms\ImageTransformer::procureTransformedImage(). generateTransform() should be used instead.
Deprecated craft\queue\jobs\GeneratePendingTransforms. GenerateImageTransform should be used instead. (#12340)
Deprecated craft\services\Assets::getFolderTreeByFolderId().
Deprecated craft\services\Assets::getFolderTreeByVolumeIds.
Added Craft.Accordion. (#12189)
Added Craft.AssetMover.
Added Craft.BaseElementIndex::getSourcePathActionLabel().
Added Craft.BaseElementIndex::getSourcePathActions().
Added Craft.BaseElementIndex::getSourcePathLabel().
Added Craft.BaseElementIndex::onSourcePathChange().
Added Craft.BaseElementIndex::sourcePath.
Added Craft.BaseElementSelectorModal::getElementIndexParams().
Added Craft.BaseElementSelectorModal::getIndexSettings().
Added Craft.BaseElementSelectorModal::hasSelection().
Added Craft.ElementFieldSettings.
Added Craft.VolumeFolderSelectorModal.
Added Garnish.MultiFunctionBtn.
The custom activate jQuery event will now trigger when the Return key is pressed.
The custom activate jQuery event will no longer trigger for Ctrl/Command-clicks.
Deprecated Craft.CategorySelectInput. Craft.BaseElementSelectInput should be used instead. (#11749)

System

Improved element deletion performance. (#12223)
Improved queue performance. (#12274, #12340)
“Applying new propagation method to elements”, “Propagating [element type]”, and “Resaving [element type]” queue jobs are now splt up into batches of up to 100 items. (#12638)
Assets’ alternative text values are now included as search keywords.
Entry type, section, category group, and tag group deletion no longer involves looping through all affected entries/categories/tags and deleting each one individually via craft\services\Elements::deleteElement(). (#12665)
Updated LitEmoji to v4. (#12226)
Fixed a database deadlock error that could occur when updating a relation or structure position for an element that was simultaneously being saved. (#9905)
Fixed a bug where element query select() and orderBy() params could resolve element extension table column names to custom field columns, if a custom field had a conflicting handle. (#12652)
Fixed a bug where it was possible to activate inactive users with non-unique emails. (#12431, #12712)
Fixed a bug where hint text within Selectize menus had extremely low contrast on hover. (#12829)

4.3.11 - 2023-03-07

Fixed a bug where craft\events\RegisterElementSourcesEvent::$context wasn’t always set to modal when defining the available element sources for an element selection modal.
Fixed a styling bug where multi-line checkbox labels within the Customize Sources modal and View menu weren’t wrapping properly. (#12717)
Fixed a bug where asset thumbnails within collapsed Matrix blocks weren’t loading when the block was expanded. (#12720)
Fixed a bug where user activation/verification/reset-password URLs could be root-relative, if the @web alias was explicitly set to a root-relative URL.
Fixed a PHP error that could occur if an options field’s condition rule wasn’t configured with any values. (#12713)
Fixed a bug where control panel notifications weren’t being announced to screen readers. (#12714)
Fixed a bug where localized relations could be moved to a newly-added site rather than copied, when applying project config changes. (#12702)
Fixed a bug where element indexes’ “View” buttons could be inconsistently positioned in the toolbar.
Fixed a bug where element selector modal footers could hide the modal contents. (#12708)
Fixed a bug where asset thumbnails weren’t respecting the generateTransformsBeforePageLoad config setting. (#12750)
Fixed a bug where soft hyphens, non-breaking spaces, zero-width characters, invisible times characters, and invisible separators weren’t getting stripped from sanitized asset filenames. (#12741, #12759)
Fixed a bug where custom fields’ database columns would get deleted when applying project config changes, if the field type wasn’t present. (#12760)
Fixed an error that could occur if a non-numeric value was entered into an image transform’s Width or Height settings. (#12776)
Fixed a bug where Assets, Categories, and Tags fields weren’t respecting their “Allow self relations” settings. (#12769)
Fixed a bug where dynamically-generated entry titles weren’t always generated with the site’s formatting locale in place. (12780)
Fixed a bug where element titles weren’t getting a pointer cursor or underlines on hover, when selected on an element index page.
Fixed a bug where it wasn’t possible to close modals that were opened by a custom select menu via the Esc key. (#12814)
Fixed an error that could occur when saving an element with an eager-loaded Matrix field. (#12815)
Fixed a bug where the “send to Developer Support” links within the Craft Support widget weren’t working. (#12822)

4.3.10 - 2023-02-17

Fixed a bug where clicking on the scrollbar of a disclosure menu would close it. (#12681)
Fixed an error that could occur when loading the Plugin Store, if there wasn’t a .env file. (#12687)
Fixed a bug where large asset thumbnails weren’t centered within Assets fields. (#12682)
Fixed a PHP error that could occur when versioning asset URLs. (#12678)
Fixed a bug where the “Site” element condition rule was available for non-localizable element types’ conditions. (#12601)
Fixed a bug where it wasn’t possible to sort assets within subfolders by anything besides the asset title. (#12688)

4.3.9 - 2023-02-14

Image thumbnails and previews are no longer versioned if their image URL doesn’t begin with one of the asset’s base filesystem URLs. (#12663)
HTML Purifier now allows oembed tags. (craftcms/ckeditor#59)
Added craft\htmlpurifier\VideoEmbedUrlDef.
craft\helpers\Assets::revUrl() now has an $fsOnly argument.
Fixed a bug where entries that aren’t propagated to the primary site weren’t showing revision notes. (#12641)
Fixed a bug where HTML tags weren’t getting stripped from auto-generated Handle and URI Format setting values.
Fixed a JavaScript error that could occur if an object with null values was passed to Craft.compare().
Fixed a bug where craft\elements\db\ElementQuery::toArray() was calling getter methods whose names conflicted with custom field handles. (#12635)

4.3.8.2 - 2023-02-08

Fixed a PHP error that could occur if relational fields were getting eager-loaded for elements that the fields didn’t belong to. (#12648)

4.3.8.1 - 2023-02-08

Fixed a PHP error that occurred after performing a Composer action within Craft. (#12647)
Fixed a bug where element attributes weren’t getting eager-loaded. (#12646, #12645)
Fixed a bug where image previews weren’t getting versioned, unless the revAssetUrls config setting was enabled. (#12603)

4.3.8 - 2023-02-07

Updated Composer to 2.2.19, fixing a PHP error that could occur when performing a Composer action within Craft, when the autoload classmap was generated with Composer 2.5. (#12482)
Fixed a bug where Matrix blocks weren’t getting eager-loaded. (#12631)
Fixed a PHP error that could occur when calling craft\services\Assets::getAllDescendantFolders() for the root folder. (craftcms/feed-me#1231)
Fixed a bug where revision notes weren’t always being retained for provisional drafts. (#12641)
Fixed a bug where it wasn’t possible to access the Customize Sources modal on element index pages, if all sources were disabled. (#12634)

4.3.7.1 - 2023-02-05

The _includes/forms/checkbox.twig, select.twig, and text.twig templates no longer add an aria-labelledby attribute to the input if an aria-label attribute is also specified.
craft\helpers\Cp::dateTimeFieldHtml() now returns inputs contained within a fieldset.
Fixed a bug where some inputs were getting aria-labelledby attributes that referenced a nonexistent label ID.
Fixed a bug where the first changes to entries weren’t saving properly. (#12623, #12592)
Fixed a bug where craft\behaviors\CustomFieldBehavior::$owner was getting nullified by craft\base\Element::fieldByHandle(). (#12624)

4.3.7 - 2023-02-03

Improved the performance of the “Generating pending image transforms” queue job. (#12274)
Removed the “Timeout” setting from the Gmail and SMTP mailer transporters, as they aren’t supported by Symfony Mailer’s transport configuration.
Removed the “Encryption Method” setting from the SMTP mailer transporter, as Symfony Mailer already uses TLS when port 465 is used (as it is by default).
The “Port” setting on the SMTP mailer transporter is no longer required. It will default to 465 or 25 depending on whether OpenSSL is installed.
Added more reserved field handles to avoid conflicts with craft\base\Element properties. (#12577)
Assets’ alt properties are now automatically trimmed of leading/trailing whitespace.
Asset element components in the control panel now include a data-alt attribute. (#12600)
Control panel requests no longer override the pageTrigger config setting value to 'p'. (#12598, #12614)
Fixed field status badge styling in some contexts. (#12403)
Fixed a bug where exporting elements with multiple field layouts as a CSV file using the “Expanded” export type would result in mismatched column values.
Fixed a bug where cancelling a conflicting volume folder move would result in the moved folder getting deleted.
Fixed a bug where craft\elements\Category::canDuplicate() wasn’t factoring in save permissions.
Fixed a bug where the horizontal scroll position wasn’t being retained when refreshing Live Preview. (#12504)
Fixed a bug where user group condition rules for the default user group weren’t getting matched properly during public registration. (#12283)
Fixed a bug where HTML tags within field labels, instructions, tips, and warnings weren’t always getting escaped.
Fixed a bug where the sidebar scroll position wasn’t retained when selecting a new source on element index pages. (#12523)
Fixed a bug where resave/* commands’ output didn’t take the offset into account. (#12526)
Fixed a bug where warnings were getting logged for video assets that were “missing” their dimensions.
Fixed a bug where craft\services\Assets::getAllDescendantFolders() could return unexpected results for folders that contained an underscore.
Fixed a bug where accessing a custom field’s magic property on an element would return the field’s raw database value rather than null, if it didn’t belong to the element’s field layout anymore. (#12539, #12578)
Fixed a bug where previewing an asset could wipe out all h1 tags within Redactor fields. (#12545)
Fixed a bug where craft\image\Raster::getIsTransparent() wasn’t working. (#12565)
Fixed a bug where textual condition rules were still showing a text input when the “is empty” or “has a value” operators were selected. (#12587)
Fixed a bug where the component name comments in project config YAML files would always lag behind the current project config a little. (#12576, #12581)
Fixed a SQL error that occurred when creating a database backup using the default backup command, when running MySQL 5.7.41+ or 8.0.32+. (#12557, #12560)
Fixed a bug where database backups weren’t respecting SSL database connection settings if they were specified when using MySQL. (#10351, #11753, #12596)
Fixed a bug where element indexes could stop showing their loading spinner prematurely if the element listing needed to be reloaded multiple times in rapid succession. (#12595)
Fixed a bug where element editors wouldn’t show tabs that didn’t contain any characters that could be converted to ASCII. (#12602)
Fixed a bug where asset thumbnails weren’t getting versioned in the control panel, unless the revAssetUrls config setting was enabled. (#12603)
Fixed a bug where entry relations could be lost when switching entry types, for relational fields that didn’t exist on the prior entry type. (#12592)
Fixed a bug where Matrix blocks weren’t getting duplicated to other sites when first editing an unpublished draft. (#11366)
Fixed a bug where element indexes would show show an expand/collapse toggle for structured elements that only had unsaved draft children, which aren’t actually shown. (#11253)
Fixed a SQL error that occurred when running the index-assets command on PostgreSQL. (#12617)
Added craft\helpers\Assets::revUrl().
Added craft\helpers\Db::escapeForLike().
Added craft\web\twig\variables\Paginate::$pageTrigger. (#12614)
craft\helpers\Assets::revParams() no longer takes the revAssetUrls config setting into account. That should be factored in by whatever is calling it.
craft\services\Assets::getAllDescendantFolders() now has a $withParent argument, which can be passed false to omit the parent folder from the results. (#12536)
craft\services\Matrix::duplicateBlocks() now has a $force argument.
Deprecated craft\helpers\DateTimeHelper::timeZoneAbbreviation().
Deprecated craft\helpers\DateTimeHelper::timeZoneOffset().

4.3.6.1 - 2023-01-09

Element edit pages now retain their previous scroll position when they’re automatically refreshed to keep up with changes from another browser tab.
Fixed a bug where editing certain Matrix/Neo/Super Table fields could result in content loss. (#12445)

4.3.6 - 2023-01-04

Template caching is no longer enabled for tokenized requests. (#12458)
Elisions are now stripped from search keywords. (#12467, #12474)
Added support for HEIC/HEIF images. (#9115)
The allowedFileExtensions config setting now includes heic, heif, and hevc by default. (#12490)
It’s now possible to assign aliases children fields queried via GraphQL. (#12494)
Added craft\helpers\Image::isWebSafe().
Added craft\services\Images::getSupportsHeic().
Craft.MatrixInput now fires blockSortDragStop, beforeMoveBlockUp, moveBlockUp, beforeMoveBlockDown, and moveBlockDown events. (#12498)
Fixed a bug where deleting a field layout tab could result in duplicated tabs. (#12459)
Fixed a bug where Feed widgets weren’t showing feed items when they were first loaded. (#12460)
Fixed an error that occurred when a Date field’s condition rule was set to a relative range, “has a value”, or “is empty”. (#12457)
Fixed an error that could occur when processing template caches in a console request, if a globally-scoped template cache was processed before it.
Fixed styling issues with large element thumbnail views. (#12455)
Fixed a bug where it wasn’t possible to retry all failed jobs when using a proxy queue. (#12471)
Fixed a bug where the selected table columns would be forgotten if modified from a nested source. (#12477)
Fixed a bug where some custom field property types in craft\behaviors\CustomFieldBehavior were incorrect.
Fixed an error that could occur if a Matrix sub-field’s handle was too long. (#12422)
Fixed a bug where element editor slideouts’ submit buttons weren’t always consistent with the full-page edit form. (#12487)
Fixed an XSS vulnerability.

4.3.5 - 2022-12-13

Fixed a bug where entry tab contents could remain visible when switching to other tabs, after changing the entry type.
Fixed a bug where it wasn’t possible to enter 0 in Number fields, Money fields, and numeric column cells within editable tables, using certain keyboard layouts. (#12412)
Fixed a bug where the default MySQL restore command would attempt to use credentials from ~/.my.cnf if it existed, instead of Craft’s configured database connection settings. (#12349, #12430)
Fixed a JavaScript error that could occur when autosaving an entry draft. (#12445)
Added craft\base\ApplicationTrait::onInit(). (#12439)
Added craft\console\Controller::createDirectory(). (#12438)
Added craft\console\Controller::do(). (#12438)
Added craft\console\Controller::failure(). (#12438)
Added craft\console\Controller::note(). (#12438)
Added craft\console\Controller::success(). (#12438)
Added craft\console\Controller::tip(). (#12438)
Added craft\console\Controller::warning(). (#12438)
Added craft\console\Controller::writeJson(). (#12438)
Added craft\console\Controller::writeToFile(). (#12438)
Added craft\helpers\FileHelper::absolutePath().
Added craft\helpers\FileHelper::findClosestFile().
Added craft\helpers\FileHelper::isWithin().
Added craft\helpers\FileHelper::relativePath().
Added craft\helpers\Json::decodeFromFile().
Added Craft.filterInputVal().
Added Craft.filterNumberInputVal().

4.3.4 - 2022-11-29

The serve command now routes requests for nonexistent files to Craft. (#12310)
craft\base\Element::includeSetStatusAction() now returns false by default regardless of what hasStatuses() returns, fixing a bug where some element indexes were unexpectedly getting “Set Status” actions.
Query conditions generated by craft\helpers\Db::parseParam() no longer account for null values, due to a heavy performance impact. (#11931)
Fixed a bug where the default MySQL backup command would attempt to use credentials from ~/.my.cnf if it existed, instead of Craft’s configured database connection settings. (#12349)
Fixed a bug where it wasn’t possible to access the Customize Sources modal if all sources were disabled. (#12369)
Fixed a bug where Assets fields weren’t taking their “Show unpermitted volumes” setting into account when defining the available input sources. (#12364)
Fixed a bug where user slideouts included status toggles.
Updated Yii to 2.0.47.

4.3.3 - 2022-11-17

Fixed an error that occurred if an arrow function was passed to the |sort Twig filter. (#12334)
Fixed a bug where nested fields set to numbers could be inadvertently changed when an entry draft was created.
craft\services\Fields::getFieldsWithContent() and getFieldsWithoutContent() now have $context arguments.

4.3.2.1 - 2022-11-16

Fixed a PHP error that could occur when generating an image transform. (#12333)

4.3.2 - 2022-11-16

firstName and lastName are now reserved field handles for the user field layout. (#12241, #12316)
Asset filenames are truncated in large thumbnail views, as they were before 4.3.0. (#12236)
Fixed an information disclosure vulnerability.
Fixed an XSS vulnerability.
Fixed asset indexing for Local filesystems that were configured to use a symlinked server path.
Fixed an error that could occur when calling craft\base\Element::getCanonicalUid() on a draft loaded for a site that the canonical element didn’t exist on yet. (#12228)
Fixed a bug where long words in asset titles weren’t wrapping in the large thumbnail view. (#12237)
Fixed a bug where the Users index page was showing a “Set Status” bulk action, making it possible to disable users.
Disabled users now identify themselves as disabled, and Edit User pages now provide a way for them to be re-enabled.
Fixed a layout issue that could occur on Assets fields using the “Large Thumbnails” view mode. (#12230)
Fixed a bug where elements that weren’t viewable by the current user could still be hyperlinked in element indexes.
Fixed a bug where craft\helpers\DateTimeHelper::toDateInterval() could return a DateInterval that was off by an hour around daylight savings time changes.
Fixed a bug where sticky element index footers were obstructed when the Debug Toolbar was enabled. (#12242)
Fixed a bug where it wasn’t possible to change the sort attribute on element indexes while searching. (#12256)
Fixed a bug where resave/* commands weren’t catching exceptions thrown when applying the --set and --to options. (#12262)
Fixed the position of field status indicators within Matrix fields in Live Preview. (#12287)
Fixed PHP errors that could occur when executing GraphQL queries. (#12271, #12275)
Fixed a bug where it was possible to add a “Status” condition rule to relational fields’ selectable element conditions. (#12289)
Fixed a PHP error that occurred if a field type stored enum values. (#12297)
Fixed a bug where PHP errors and exceptions thrown when formatting a control panel screen response weren’t being handled properly. (#12308)
Fixed a bug where element indexes were showing the labels of empty Dropdown options when selected. (#12319)
Fixed condition builder styling issues that occurred if any rules had exceptionally long names. (#12311)
Fixed an error that occurred when saving an entry via GraphQL, if a parent entry was assigned that didn’t exist on the requested site. (#12291)
Fixed a bug where conditional fields weren’t always saving for elements that didn’t support autosaved drafts. (#12166)
Fixed a bug where fields set to numbers could be inadvertently changed when an entry draft was created.
Added craft\base\Element::includeSetStatusAction().
Added craft\services\Fields::getFieldsWithoutContent().

4.3.1 - 2022-10-27

Numeric values are no longer automatically formatted within element indexes. (#12205)
When craft\base\Element::EVENT_DEFINE_URL event handlers set craft\events\DefineUrlEvent::$url to null, that will no longer be respected unless $handled was also set to true. (#12210, nystudio107/craft-imageoptimize#359)
Asset folder and file names are now converted to ASCII using the primary site’s language for character mappings, regardless of the current user’s preferred language, when the convertFilenamesToAscii config setting is enabled. (#12207)
Fixed a bug where locked users’ remaining cooldown times could be calculated incorrectly on PHP 8.0.
Fixed an infinite recursion bug that occurred when editing a Matrix field with a custom propagation method. (#12176)
Fixed a bug where element index source lists were showing headings that didn’t have any visible nested sources. (#12193)
Fixed a JavaScript 404 error that occurred when users’ Language was set to Chinese. (#12194)
Fixed a bug where users couldn’t delete their own addresses. (craftcms/commerce#3011)
Fixed a bug where the users/save-address action wasn’t validating addresses properly.
Fixed an error that could occur during garbage collection, if any nested volume folders were missing their path. (#12195)

4.3.0 - 2022-10-25

Content Management

Added a “View” menu to element indexes, which enable users to customize the visible table columns for themselves, without affecting other users. (#11915)
Added source setting menus to element index pages, which now contain the “Customize sources” option when allowed, and “New subfolder”, “Rename folder”, and “Delete folder” actions on the Assets index page. (#11906)
Added the “Editable” rule to asset and entry conditions. (#11995)
Improved control panel mobile support. (#11963, #12005)
Element indexes now respect field layouts’ user conditions when determining which custom field columns to show. (#11913)
Element index URLs now include the selected source key in a source query param, so all sources are now deep-linkable, including custom sources. (#11996)
Notifications are now shown after executing folder actions on the Assets index page. (#11906)
Date range condition rules now support “Today”, “This week”, “This month”, “This year”, “Past 7 days”, “Past 30 days”, “Past 30 days”, “Past year”, “Before…”, and “After…” relative range types, in addition to specifying a custom date range. (#10749, #11888)
Number condition rules now support an “is between…” operator. (#11950)
All text, number, and date range condition rules now support “has a value” and “is empty” operators. (#11070)
“Save as a new [element type]” actions will now discard any unsaved changes on the original element after the new element is created. (#10204, #11959, #12102, #12165)
If Live Preview is triggered while a draft is saving, it will now wait until the save completes before opening. (#11858, #11895)
Addresses now support change tracking.
It’s now possible to restore assets that were deleted programmatically with craft\elements\Asset::$keepFile set to true. (#11761)

Accessibility

Improved the styling of selected sidebar navigation items to meet contrast requirements. (#11589)
Improved the styling of slideouts for screens under 600 pixels wide. (#11636)
Improved the styling of the primary button on element index pages for small screens. (#11963)
Improved the contrast of modal resize handles. (#11727)
Improved the contrast of fields’ searchable and translatable indicator icons on the Fields index page. (#12169)
Improed the contrast of the “Same as language” text within the “Formatting Locale” user preference. (#11767)
Improved the contrast of the selected options within combo boxes. (#11662)
Improved the readability of the global navigation and date pickers when text is resized to 200%. (#11767)
Improved focus management for HUD components. (#11985)
Improved focus management for element index pagination links. (#11565).
Improved focus management for editable tables. (#11662)
Custom slider components now support Home and End key presses. (#11578)
Improved the markup and keyboard control for exclusive button groups. (#11942)
Improved keyboard control for the widget manager HUD on the Dashboard. (#11578)
Improved New Widget and Quick Post action menus for screen readers. (#11611)
Improved the widget manager HUD for screen readers. (#11945)
Improved the Craft Support widget for screen readers. (#11703)
Improved element index view mode buttons for screen readers. (#11613)
Improved element type selects within “Related To” condition rules for screen readers. (#11662)
Improved element action modals for screen readers. (#11905)
Improved field instructions, errors, and other visually-related text for screen readers. (#11763)
Improved field translation indicators for screen readers. (#11662)
Improved the parent selection button on structured entries’ and categories’ edit pages for screen readers. (#11662)
Improved the Rotate button within Live Preview for screen readers. (#11953)
Improved Date fields for screen readers. (#10546)
Fixed a mismatch between the visible and accessibile text on the site name in the global sidebar. (#11767)
Added alternative text to element status indicators. (#11604)
Feed, Recent Entries, and Drafts widgets now use use semantic lists instead of tables. (#11952)
Added autocomplete attributes to several address fields. (#11767)
Implemented fieldsets and descriptive headings on user accounts’ “Preferences” tab. (#11534)
The “All” status option within element index toolbars now uses a differentiated gradient icon. (#11911)
Improved status indicator shapes, when the “Use shapes to represent statuses” user preference is enabled. (#11911)
Boolean table columns within element indexes now use check icons to indicate true values. (#11911)
Element titles are no longer truncated on edit pages. (#11768)
Asset titles are no longer truncated in asset indexes. (#11775)
Element source navigation now programmatically conveys structure imparted by headings. (#11777)
Added a warning icon to related elements that contain validation errors. (#11610)
Element index footers now stick to the bottom of the window, and element action triggers are now inserted into the footer rather than replacing the contents of the page’s toolbar. (#11844)

Administration

Added the extraLastNamePrefixes config setting. (#11903)
Added the extraNameSalutations config setting. (#11903)
Added the extraNameSuffixes config setting. (#11903)
Element sources now have a “Default Sort” setting in the Customize Sources modal. (#12002)
Control panel-defined image transforms can now have custom quality values. (#9622)
Added support for the CRAFT_DOTENV_PATH PHP constant. (#11894)
Added support for CRAFT_WEB_URL and CRAFT_WEB_ROOT environment variables/PHP constants, which can be used to set the default @web and @webroot alias values. (#11912)

Development

Added the canCreateDrafts() Twig function. (#11797, #11808)
Added the canDelete() Twig function. (#11797, #11808)
Added the canDeleteForSite() Twig function. (#11797, #11808)
Added the canDuplicate() Twig function. (#11797, #11808)
Added the canSave() Twig function. (#11797, #11808)
Added the canView() Twig function. (#11797, #11808)
Added the |boolean Twig filter. (#11792)
Added the |float Twig filter. (#11792)
Added the |integer Twig filter. (#11792)
Added the |string Twig filter. (#11792)
Twig templates now have today, tomorrow, and yesterday global variables available to them.
Element query date params now support passing today, tomorrow, and yesterday. (#10485)
Element queries’ relatedTo params now only check for relations in the same site as siteId, if set. (#12000, #12072)
Element queries now support passing ambiguous column names (e.g. dateCreated) and field handles into select(). (#11790, #11800)
Element queries’ collect() methods eager-loaded elements now return craft\elements\ElementCollection objects, which extends Illuminate\Support\Collection with ids() and with() methods. (#12113)
{% cache %} tags now store any HTML registered with {% html %} tags. (#11811)
{% cache %} tags and GraphQL query caches now get a max cache duration based on the fetched/referenced entries’ expiry dates. (#8525, #11901)
Added the siteHandle field to elements queried via GraphQL. (#10829)
users/session-info responses now include a csrfTokenName key. (#11706, #11767)
The elements/save-draft action now supports being called from the front end. (#12131)
The users/upload-user-photo action now includes a photoId key in the response data. (#12175)

Extensibility

Added craft\base\conditions\BaseTextConditionRule::inputOptions().
Added craft\base\Element::EVENT_DEFINE_URL. (#12168)
Added craft\base\ExpirableElementInterface. (#11901)
Added craft\controllers\ElementsController::$element.
Added craft\db\ActiveQuery::collect(). (#11842)
Added craft\elements\actions\Restore::$restorableElementsOnly.
Added craft\elements\conditions\assets\EditableConditionRule.
Added craft\elements\conditions\entries\EditableConditionRule.
Added craft\elements\ElementCollection. (#12113)
Added craft\events\AuthorizationCheckEvent::$element.
Added craft\events\CreateTwigEvent.
Added craft\events\DefineAddressFieldLabelEvent.
Added craft\events\DefineAddressFieldsEvent.
Added craft\events\DefineUrlEvent. (#12168)
Added craft\events\ImageTransformerOperationEvent::$tempPath.
Added craft\events\SearchEvent::$scores. (#11882)
Added craft\events\UserGroupPermissionsEvent.
Added craft\events\UserPermissionsEvent.
Added craft\helpers\DateRange.
Added craft\helpers\DateTimeHelper::firstWeekDay().
Added craft\helpers\DateTimeHelper::lastMonth().
Added craft\helpers\DateTimeHelper::lastWeek().
Added craft\helpers\DateTimeHelper::lastWeekDay().
Added craft\helpers\DateTimeHelper::lastYear().
Added craft\helpers\DateTimeHelper::nextMonth().
Added craft\helpers\DateTimeHelper::nextWeek().
Added craft\helpers\DateTimeHelper::nextYear().
Added craft\helpers\DateTimeHelper::thisMonth().
Added craft\helpers\DateTimeHelper::thisWeek().
Added craft\helpers\DateTimeHelper::thisYear().
Added craft\helpers\DateTimeHelper::today().
Added craft\helpers\DateTimeHelper::tomorrow().
Added craft\helpers\DateTimeHelper::yesterday().
Added craft\helpers\ElementHelper::attributeHtml().
Added craft\helpers\Html::svg(). (#11932)
Added craft\i18n\FormatConverter::convertDatePhpToHuman(). (#10546)
Added craft\i18n\Locale::FORMAT_HUMAN.
Added craft\nameparsing\CustomLanguage.
Added craft\services\Addresses::EVENT_DEFINE_FIELD_LABEL. (#11788)
Added craft\services\Addresses::EVENT_DEFINE_USED_FIELDS. (#11788)
Added craft\services\Addresses::EVENT_DEFINE_USED_SUBDIVISION_FIELDS. (#11788)
Added craft\services\Addresses::getFieldLabel().
Added craft\services\Addresses::getUsedFields().
Added craft\services\Addresses::getUsedSubdivisionFields().
Added craft\services\Elements::EVENT_AUTHORIZE_CREATE_DRAFTS. (#11759, #11808)
Added craft\services\Elements::EVENT_AUTHORIZE_DELETE_FOR_SITE. (#11759, #11808)
Added craft\services\Elements::EVENT_AUTHORIZE_DELETE. (#11759, #11808)
Added craft\services\Elements::EVENT_AUTHORIZE_DUPLICATE. (#11759, #11808)
Added craft\services\Elements::EVENT_AUTHORIZE_SAVE. (#11759, #11808)
Added craft\services\Elements::EVENT_AUTHORIZE_VIEW. (#11759, #11808)
Added craft\services\Elements::canCreateDrafts().
Added craft\services\Elements::canDelete().
Added craft\services\Elements::canDeleteForSite().
Added craft\services\Elements::canDuplicate().
Added craft\services\Elements::canSave().
Added craft\services\Elements::canView().
Added craft\services\Elements::getIsCollectingCacheInfo(). (#11901)
Added craft\services\Elements::setCacheExpiryDate(). (#11901)
Added craft\services\Elements::startCollectingCacheInfo(). (#11901)
Added craft\services\Elements::stopCollectingCacheInfo(). (#11901)
Added craft\services\Search::EVENT_BEFORE_SCORE_RESULTS. (#11882)
Added craft\services\UserPermissions::EVENT_AFTER_SAVE_GROUP_PERMISSIONS. (#12130, #12146)
Added craft\services\UserPermissions::EVENT_AFTER_SAVE_USER_PERMISSIONS. (#12130, #12146)
Added craft\web\Controller::currentUser(). (#11754, #11916)
Added craft\web\View::EVENT_AFTER_CREATE_TWIG. (#11774)
craft\elements\Asset::EVENT_DEFINE_URL now gets triggered after the default URL has been generated, and the URL will be passed to craft\events\DefineAssetUrlEvent::$url.
craft\elements\db\ElementQuery::collect() and craft\base\Element::getEagerLoadedElements() now return craft\elements\ElementCollection instances. (#12113)
craft\events\DraftEvent::$creatorId is now nullable. (#11904)
craft\fieldlayoutelements\BaseField::statusClass() and statusLabel() now return status info from the element for the attribute specified by attribute().
craft\helpers\Component::iconSvg() now namespaces the SVG contents, and adds aria-hidden="true". (#11703)
craft\services\Drafts::createDraft() now accepts null passed to its $creatorId argument. (#11904)
craft\services\Search::EVENT_AFTER_SEARCH now includes the computed search result scores, set to craft\events\SearchEvent::$scores, and any changes made to it will be returned by searchElements(). (#11882)
craft\services\Search::EVENT_BEFORE_INDEX_KEYWORDS is now cancellable by setting $event->isValid to false. (#11705)
Deprecated craft\base\Element::EVENT_AUTHORIZE_CREATE_DRAFTS. craft\services\Elements::EVENT_AUTHORIZE_CREATE_DRAFTS should be used instead.
Deprecated craft\base\Element::EVENT_AUTHORIZE_DELETE_FOR_SITE. craft\services\Elements::EVENT_AUTHORIZE_DELETE_FOR_SITE should be used instead.
Deprecated craft\base\Element::EVENT_AUTHORIZE_DELETE. craft\services\Elements::EVENT_AUTHORIZE_DELETE should be used instead.
Deprecated craft\base\Element::EVENT_AUTHORIZE_DUPLICATE. craft\services\Elements::EVENT_AUTHORIZE_DUPLICATE should be used instead.
Deprecated craft\base\Element::EVENT_AUTHORIZE_SAVE. craft\services\Elements::EVENT_AUTHORIZE_SAVE should be used instead.
Deprecated craft\base\Element::EVENT_AUTHORIZE_VIEW. craft\services\Elements::EVENT_AUTHORIZE_VIEW should be used instead.
Deprecated craft\elements\Address::addressAttributeLabel(). craft\services\Addresses::getFieldLabel() should be used instead.
Deprecated craft\events\DefineAssetUrlEvent::$asset. $sender should be used instead.
Deprecated craft\services\Elements::getIsCollectingCacheTags(). getIsCollectingCacheInfo() should be used instead. (#11901)
Deprecated craft\services\Elements::startCollectingCacheTags(). startCollectingCacheInfo() should be used instead. (#11901)
Deprecated craft\services\Elements::stopCollectingCacheTags(). stopCollectingCacheInfo() should be used instead. (#11901)
checkboxSelect inputs without showAllOption: true now post an empty value if no options were selected. (#11748)
Added the Craft.useMobileStyles() JavaScript method. (#11636)
Added Craft.BaseElementIndex::getParentSource().
Added Craft.BaseElementIndex::getRootSource().
Added Craft.BaseElementIndex::getSourceActions(). (#11906)
Added Craft.BaseElementIndex::getSourceLevel().
Craft.BaseElementSelectInput now triggers a change event when elements are added programmatically or removed.

System

Name parsing now checks for common German salutations, suffixes, and last name prefixes.
“Generating pending image transforms” jobs no longer attempt to process transforms that had previously failed. (#11970)
The default system email template now sets the lang attribute on the <html> tag. (#12156)
The default system email template now includes a Content-Type tag. (#12156)
Improved GraphQL cache reliability. (#11994, #12086)
Control panel .twig templates are now prioritized over .html. (#11809, #11840)
Updated Yii to 2.0.46.
Fixed a bug where addresses weren’t validating their country codes. (#12161)
Fixed a bug where Entry URI Format, Template, and Default Status switches were focusable within sections’ Site Settings tables, for disabled sites.
Fixed a bug where craft\helpers\Db::parseParam() wasn’t generating conditions that would include null values when it should have. (#11931)

4.2.8 - 2022-10-18

Changed

The setup/keys command will now set the application ID if Craft::$app->id is empty. (#12103)

Fixed

Fixed an error that could occur when running tests. (#12088, #12089)
Fixed a bug where the db/restore command would output a warning about a missing info row, even if one existed in the imported database. (#12101)
Fixed a bug where the “Your session has ended” modal could be shown on the control panel’s login page. (#12121)
Fixed a permission error that could occur when uploading a file to an Assets field.
Fixed a bug where custom log targets were getting removed when processing queue jobs. (#12109)
Fixed a bug where Money fields weren’t distinguishing between 0 and empty values. (#12122, #12132)
Fixed an error that could occur in the control panel. (#12133)
Fixed a bug where assets uploaded from Assets fields weren’t retaining their original filename for all but the initial site. (#12142)
Fixed a bug where non-admin users couldn’t always see the Temporary Uploads source when selecting assets from an Assets field. (#12128)
Fixed a bug where image transforms that used the fit mode but didn’t specify a width or height weren’t getting their missing dimension set on the asset. (#12137)

4.2.7 - 2022-10-11

Added

Added the setup/keys command, which ensure Craft is configured with an application ID and security key.

Changed

The install/craft command now runs setup/keys before doing anything else.

4.2.6 - 2022-10-11

Added

Added the --as-json option to the help command. (#12017, #12074)
Added craft\helpers\ElementHelper::isAttributeEmpty().
Added craft\queue\jobs\ResaveElements::$ifEmpty.
Added craft\queue\jobs\ResaveElements::$set.
Added craft\queue\jobs\ResaveElements::$to.
Added craft\queue\jobs\ResaveElements::$touch.

Changed

When passing a PHP callback function to the --to option of a resave/* command, the $element argument is now optional.

Deprecated

Deprecated craft\web\assets\focusvisible\FocusVisibleAsset. (#12037)

Fixed

Fixed an error that could occur when editing a draft of an element type that didn’t have change tracking enabled.
Fixed an error that could occur when saving an entry with Matrix blocks, if the entry had been deleted for a site.
Fixed a bug where resave/* commands weren’t respecting the --set, --to, or --touch options when --queue was passed. (#11974)
Fixed a bug where relatedTo params didn’t support collections.
Fixed an error that could occur when passing an element query to a relatedTo param, if the parent element query contained any closures. (#11981)
Fixed a bug where craft\log\MonologTarget::$allowLineBreaks wasn’t getting a default value. (#12004)
Fixed a PHP error that occurred when attempting to edit an element by an invalid ID or UUID.
Fixed a bug where unsaved drafts could be unintentionally deleted when saved, if a plugin or module was blocking the save via EVENT_BEFORE_SAVE. (#12015)
Fixed a bug where “Propagating tags” jobs would fail if two tags had similar titles.
Fixed a bug where pressing “Disable focal point” within asset preview modals would only reset the focal point position, but not delete it. (#12030)
Fixed a bug where image transforms weren’t getting sized correctly in some cases when upscaleImages was disabled. (#12023)
Fixed a bug where table cells within Redactor fields could appear to be focused when they weren’t. (#12001, #12037)
Fixed a bug where alerts saying a folder can’t be renamed due to a naming conflict were showing the old folder name instead of the new one. (#12049)
Fixed a bug where custom fields nested within Matrix fields weren’t always updating properly within slideout editors. (#11988, #12058)
Fixed an error that could occur when adding new textual condition rules to a condition. (#12077)
Fixed a bug where Table fields’ Default Values settings were always showing at least one row, even if the setting had been saved without any rows. (#12071)
Fixed a bug where existing rows in Table fields’ Default Values settings were losing the ability to be reordered or deleted when the table columns were changed.
Fixed a bug where sending a password reset email for an inactive user would set them to a pending state. (#12080)
Fixed a bug where some GraphQL results could be missing if multiple sets of nested elements were being queried using the same alias. (#11982)

Security

Fixed information disclosure vulnerabilities.

4.2.5.2 - 2022-10-03

Security

Updated Twig to 3.4. (#12022)

4.2.5.1 - 2022-09-21

Fixed

Fixed a bug where the “New category” button could be missing from the Categories index page. (#11977)
Fixed a bug where Craft::t() and the |t Twig filter were modifying digit-dash-digit sequences. (#11980)
Fixed PHP errors that occurred if webonyx/graphql-php 14.11.17 was installed. (#11979, webonyx/graphql-php#1221)
Fixed a PHP error that could occur when working with a draft. (#11976)

4.2.5 - 2022-09-20

Added

Added craft\helpers\Image::targetDimensions().

Changed

Edit Asset pages now show the “View” button for all file types, not just images, PDFs, and text files. (#11936)

Removed

Removed the Punycode PHP library. (#11948)

Fixed

Fixed a bug where image transforms weren’t always getting applied properly to all animation frames. (#11937)
Fixed a bug where animated WebP images would lose their animation frames when transformed. (#11937)
Fixed a bug where image transform dimensions could be calculated incorrectly when upscaleImages was false. (#11837)
Fixed a bug where the users/send-password-reset-email action wasn’t passing errors back to the template. (#11933)
Fixed an error that occurred when setting a non-numeric width or height on an image transform. (#11837)
Fixed a bug where the database connection wasn’t being configured properly when fluent config methods and environment variable overrides were being used in combination. (#11941)
Fixed a bug where slideouts lost their shadows when focused.
Fixed a bug where relatedTo* arguments weren’t supported by children fields in GraphQL. (#11918)
Fixed a bug where Image Editor and slideout action buttons were obstructed when the Debug Toolbar was enabled. (#11965)
Fixed an error that occurred when installing Craft when MySQL’s sql_require_primary_key setting was enabled. (#11374)
Fixed a bug subfolders created by Assets fields could be reported as missing when updating asset indexes, even if they contained assets. (#11949)
Fixed a PHP error that could occur in a potential race condition when calling craft\helpers\FileHelper::clearDirectory().
Fixed a bug where Structure section entries that were duplicated via the “Save as a new entry” action on a provisional draft weren’t being placed within the structure properly.
Fixed a bug where element’s searchScore properties would be set to null when their original score was below 1, rather than rounding to 0 or 1. (#11973)

4.2.4 - 2022-09-13

Changed

The “New entry” and “New category” buttons on the Entries and Categories index pages now support Ctrl/Command/middle-clicking to open the edit page in a new window. (#11870)
Control panel menus now automatically reposition themselves when the window is resized.
Improved the performance of some element queries on MySQL. (#11825)
resave/* commands now have a --touch option. When passed, elements’ dateUpdated timestamps will be updated as they’re resaved. (#11849)
Underscores within query param values that begin/end with * are now escaped, so they aren’t treated as wildcard characters by the like condition. (#11898)
craft\services\Elements::resaveElements() now has a $touch argument.
Disable the preview button while drafts are saving (#11858)

Fixed

Fixed an error that could occur when upgrading to Craft 4, if any Matrix blocks contained null sortOrder values. (#11843)
Fixed a bug where image transform dimensions could be calculated incorrectly when upscaleImages was false. (#11837)
Fixed an error that occurred when parsing an image transform string that was missing an interlace type. (#11834)
Fixed a bug where element caches weren’t being invalidated during garbage collection, so hard-deleted elements could appear to still exist.
Fixed a bug where image transforms were always getting saved with dateIndexed set to null. (#11863)
Fixed an error that could occur when rendering front-end templates if there was a problem connecting to the database. (#11855)
Fixed a bug where Edit Asset pages were showing the “View” button for assets in volumes without public URLs. (#11860)
Fixed a bug where the Assets index page wasn’t handling failed uploads properly. (#11866)
Fixed a bug where it was possible to save an asset with a focal point outside its cropped area. (#11875)
Fixed a bug where element index filter HUDs were unresponsive if another one was already active for a different site/source. (#11880)
Fixed a bug where newly-created subfolders on the Assets index page could appear to have the wrong indentation.
Fixed a UI bug where renaming a newly-created volume subfolder didn’t appear to have any effect.
Fixed a bug where empty URL fields would be marked as changed, even when no change was made to them. (#11908)
Fixed a UI bug where autosuggest menus weren’t getting filtered when first opened for inputs with existing values. (#11896)
Fixed a bug where Entry Type condition rules weren’t working for conditions that were applied to a single element. (#11914)
Fixed a bug where Related To condition rules weren’t working for conditions that were applied to a single element, for cross-site relations. (#11892)
Fixed a bug where form action keyboard shortcuts weren’t available when a custom select menu was focused. (#11919)
Fixed a bug where transforming an animated GIF into a WebP file would only include the first frame. (#11889)
Fixed a bug where craft\models\FieldLayout::createFromConfig() was ignoring id, uid, type, and reservedFieldHandles keys, if set. (#11929)

Security

Fixed XSS vulnerabilities.
Password inputs no longer temporarily reveal the password when the Alt key is pressed. (#11930)

4.2.3 - 2022-08-26

Changed

If a plugin’s license key is set to an empty environment variable, its trial license key will now be stored in .env rather than the project config. (#11830)

Fixed

Fixed a PHP error that occurred when garbage collection was run on web requests. (#11829)

4.2.2 - 2022-08-23

Added

Added the utils/fix-field-layout-uids command. (#11746)

Changed

Improved the styling of Categories fields.
The first field group is now automatically selected by default when creating a new custom field.
Improved console output for the gc command.
The gc command now runs garbage collection for data caches.
Exception JSON responses now include name and code keys. (#11799)
elements/* actions no longer include custom field values in the failure response data, improving performance. (#11807)

Fixed

Fixed a bug where keyboard focus wasn’t being maintained when changing the element type within a “Related To” condition rule.
Fixed a bug where keyboard focus wasn’t being maintained when changing the country within an address’s “Administrative Area” condition rule.
Fixed a bug where Date fields’ Timezone menus could be clipped. (#11780)
Fixed an error that could occur when saving an unpublished draft, if any custom validation errors were added to it after its draft status had been removed. (#11407)
Fixed a bug where custom validation errors would be shown twice for unpublished drafts, if they were added to it after its draft status had been removed. (#11407)
Fixed PHP warnings that would occur when passing 0 into craft\helpers\DateTimeHelper::humanDuration(). (#11787)
Fixed a bug where selected assets weren’t getting automatically replaced when an image was edited and “Save as a new asset” was chosen. (#11805)
Fixed a JavaScript error that occurred when editing a user via a slideout, if the user had any addresses. (#11810)
Fixed a bug where some invalid slideout submissions weren’t being handled properly. (#11812)
Fixed a bug where craft\helpers\DateTimeHelper::toDateInterval() was returning negative interval durations when integers were passed in. (#11814)
Fixed a bug where iframeResizer.contentWindow.js was getting loaded for all preview requests, not just Live Preview, and even when useIframeResizer was disabled. (#11778)
Fixed a bug where deleted relations and Matrix blocks could persist if the edit form was submitted before they had been fully animated away. (#11789)
Fixed a PHP error that could occur if craft\services\Assets::getUserTemporaryUploadFolder() was called when there was no logged-in user account. (#11751)

4.2.1.1 - 2022-08-10

Fixed

Fixed a bug where saving an element with invalid field values could result in some field values being forgotten. (#11756)
Fixed a bug where it wasn’t always possible to serve asset bundles via webpack-dev-server over SSL. (#11758)

4.2.1 - 2022-08-09

Added

Added the project-config/export command. (#11733)
Added craft\config\GeneralConfig::getRememberedUserSessionDuration().
Added craft\helpers\DateTimeHelper::toDateInterval().

Changed

“Related To” condition rules are now available for conditions that are stored in the project config. (#11740)
Element index filters are now managed for each site and source, rather than just for each source. (#11719)
craft\config\DbConfig::dsn() now parses the DSN string and populates the other DSN-settable config properties.
craft\helpers\DateTimeHelper::humanDuration() no longer returns the number of weeks, unless the number of days is divisible by 7. (#11594)
craft\helpers\DateTimeHelper::humanDuration() now accepts date interval strings to be passed in.
craft\helpers\Db::url2config() now returns driver, server, port, and database keys, when possible. (#11735)
craft\services\Assets::getImagePreviewUrl() now throws a yii\base\NotSupportedException if a preview URL could not be generated for the asset, rather than causing a PHP error.

Deprecated

Deprecated craft\helpers\DateTimeHelper::secondsToInterval(). toDateInterval() should be used instead.

Fixed

Fixed a bug where database connections would always use port 3306 by default if craft\config\DbConfig had been configured via fluent methods, even for PostgreSQL.
Fixed a bug where system messages provided by Yii weren’t getting translated in some cases. (#11712)
Fixed a bug where the “Keep me signed in” checkbox label wasn’t always accurately representing the rememberedUserSessionDuration config setting. (#11594)
Fixed a bug where the Craft.cp.setSiteId() JavaScript method wasn’t updating Craft.siteId, or the base URLs used by Craft.getActionUrl(), Craft.getCpUrl(), and Craft.getUrl().
Fixed an error that occurred when removing a Single section from the primary site, if it contained any Matrix blocks. (#11669)
Fixed a bug where Matrix sub-fields weren’t showing their validation errors when autosaveDrafts was false. (#11731)
Fixed a bug where saving an element with invalid field values could result in the invalid values being forgotten, rather than re-validated. (#11731)
Fixed a bug where the database connection would be misconfigured if the url connection setting was used. (#11735)
Fixed a bug where the element index filter HUDs weren’t always visually aligned with the search input. (#11739)
Fixed a bug where it wasn’t possible to preview or edit image assets if their filesystem and transform filesystem didn’t have public URLs. (#11686, #11687)
Fixed a bug where not all project config changes would be applied if a site was deleted. (#9567)
Fixed a bug where $ characters in database connection passwords weren’t being escaped property when backing up/restoring the database. (#11750)

Security

Fixed XSS vulnerabilities.

4.2.0.2 - 2022-07-27

Fixed

Fixed a bug where Garnish.uiShortcutManager was getting double-instantiated, causing some keyboard shortcuts to be triggered multiple times.
Fixed a JavaScript error that occurred when switching sites in the control panel. (#11709)
Fixed a bug where some config settings set via fluent setters weren’t getting normalized.
Fixed a bug where the database connection DSN string wasn’t getting built properly when the connection settings were set via fluent setters.

4.2.0.1 - 2022-07-26

Fixed

Fixed an error that could occur when passing an object into craft\helpers\ArrayHelper::removeValue() or the |without filter.

4.2.0 - 2022-07-26

Added

The control panel is now translated into Ukrainian.
Element conditions can now include condition rules for Matrix fields. (#11620)
Element conditions can now include condition rules for Money fields. (#11560)
Added the “Notification Duration” user accessibility preference. (#11612)
The accessibilityDefaults config setting now supports a notificationDuration key.
Added craft\behaviors\SessionBehavior::getSuccess().
Added craft\behaviors\SessionBehavior::setSuccess().
Added craft\config\BaseConfig. (#11591, #11656)
Added craft\controllers\UsersController::EVENT_AFTER_FIND_LOGIN_USER. (#11645)
Added craft\controllers\UsersController::EVENT_BEFORE_FIND_LOGIN_USER. (#11645)
Added craft\events\DefineFieldLayoutCustomFieldsEvent.
Added craft\events\FindLoginUserEvent.
Added craft\events\IndexKeywordsEvent.
Added craft\fields\conditions\EmptyFieldConditionRule.
Added craft\helpers\DateTimeHelper::humanDuration().
Added craft\helpers\Template::resolveTemplatePathAndLine().
Added craft\models\FieldLayout::EVENT_DEFINE_CUSTOM_FIELDS. (#11634)
Added craft\services\Config::getLoadingConfigFile().
Added craft\services\Elements::EVENT_INVALIDATE_CACHES. (#11617)
Added craft\services\Search::EVENT_BEFORE_INDEX_KEYWORDS. (#11575)

Changed

Redesigned user notifications. (#11612)
Most element notifications now include a link to the element. (#11612)
Improved overall control panel accessibility. (#11563, #11543, #11688, #11699)
Improved condition builder accessibility. (#11588, #11643)
Improved Image Editor accessibility. (#11496)
The “Keep me signed in” checkbox label on the control panel’s login page now includes the remembered session duration, e.g. “Keep me signed in for 2 weeks”. (#11594)
Dashboard widgets no longer show a confirmation dialog when deleted. Their delete notifications include an “Undo” button instead. (#11573)
Element edit pages no longer jump down when the “Showing your unsaved changes” notice is added, unless there’s not enough content to require a scroll bar. (#11586)
Matrix block previews now show selected option labels rather than their raw values. (#11659)
Improved the behavior of some console commands for non-interactive shells. (#11650)
The utils/prune-revisions console command now has a --section option. (#8783)
Deprecation warnings’ stack traces now show source templates’ paths and line numbers.
Exception JSON responses now include the previous exception details, recursively. (#11694)
config/general.php and config/db.php can now return craft\config\GeneralConfig/DbConfig objects, which can be defined using new fluent setter methods. (#11591, #11656)
The |duration Twig filter can now be used with an integer representing a number of seconds, and its showSeconds argument is no longer required. Seconds will be output if the duration is less than one minute by default.
The |length Twig filter now checks if the variable is a query, and if so, returns its count. (#11625)
The |without Twig filter no longer uses strict value comparisons by default. It has a new $strict argument that can be set to true to enforce strict comparisons if desired. (#11695)
craft\base\conditions\BaseConditionRule::inputHtml() is no longer abstract, and returns an empty string by default.
craft\behaviors\SessionBehavior::setError() now has a $settings argument.
craft\behaviors\SessionBehavior::setNotice() now has a $settings argument.
craft\db\Query now implements the ArrayAccess and IteratorAggregate interfaces, so queries (including element queries) can be treated as arrays.
craft\helpers\ArrayHelper::removeValue() no longer uses strict value comparisons by default. It has a new $strict argument that can be set to true to enforce strict comparisons if desired.
craft\web\Controller::asSuccess() now has a $notificationSettings argument.
craft\web\Controller::setFailFlash() now has a $settings argument.
craft\web\Controller::setSuccessFlash() now has a $settings argument.

Deprecated

Deprecated craft\helpers\DateTimeHelper::humanDurationFromInterval(). humanDuration() should be used instead.
Deprecated craft\helpers\DateTimeHelper::secondsToHumanTimeDuration(). humanDuration() should be used instead.

Fixed

Fixed a bug where new condition rules’ type selectors weren’t getting auto-focused.
Fixed a bug where Quick Post widgets weren’t submitting custom field values.
Fixed a bug where assets’ getImg() methods were returning null for assets in volumes without URLs, even if a transform was being used. (#11614)
Fixed a bug where sensitive data wasn’t getting redacted in the logs when Dev Mode was enabled. (#11618)
Fixed a SQL error that could occur on MySQL 5. (#11596)
Fixed an error that could occur when upgrading to Craft 4. (#11644)
Fixed a bug where the green color used in lightswitches was too dark. (#11653)
Fixed a bug where relational and Matrix fields were assuming their values hadn’t been eager-loaded on element save. (#11667, #11670)
Fixed a bug where deprecation warnings for treating an element query as an array weren’t getting logged with an origin, if they involved Twig’s |batch filter. (#11597)
Fixed a bug where {% js %}, {% script %}, and {% css %} tags weren’t registering JavaScript and CSS code properly when used within a {% cache %} tag that contained an ungenerated image transform. (#11602)
Fixed a bug where the “User saved” notification was translated for the former language, when changing the current user’s language preference.
Fixed a JavaScript error that occurred when removing a category from a Categories field, if any of its descendants were selected as well. (#11641)
Fixed a bug where links to config settings from Settings → General didn’t include the correct setting anchors. (#11665)
Fixed styling issues with Live Preview in Firefox.

Security

Fixed an information disclosure vulnerability.

4.1.4.1 - 2022-07-13

Fixed

Fixed a bug where craft\services\Assets::getRootFolderByVolumeId() wasn’t returning the root folder. (#11593)

4.1.4 - 2022-07-12

Added

Added craft\models\FieldLayout::getVisibleCustomFieldElements().

Changed

Relation fields now focus on the next related element’s “Remove” button when an element is removed. (#11577)

Deprecated

Deprecated craft\base\FieldTrait::$required. craft\fieldlayoutelements\BaseField::$required should be used instead.

Fixed

Fixed a bug where assets’ native Alternative Text fields were getting mislabeled as translatable. (#11576)
Fixed a bug where fields nested within Neo fields could be incorrectly validated as required. (#11574)
Fixed a PHP error that occurred when editing a Date field with a Min Date setting set.
Fixed a bug where date range inputs weren’t working on mobile. (#11571)
Fixed a bug where the “Craft Support” Dashboard widget wasn’t being labeled properly in the widget settings HUD and delete confirmation dialog. (#11573)
Fixed a bug where the project config cache was getting invalidated on each public GraphQL API request.

4.1.3 - 2022-07-07

Changed

Address fields now show required indicators based on the configured validation rules. (#11566)

Fixed

Fixed a JavaScript error that occurred on the Updates utility. (#11567)
Fixed a bug where Craft’s Composer commands could produce a malformed composer.json file. (#11564)

4.1.2 - 2022-07-06

Added

Added craft\helpers\ProjectConfig::ensureAllFilesystemsProcessed().

Changed

Relational field condition rules now have the “is related to” operator selected by default. (#11550)

Fixed

Fixed a bug where the Updates utility wasn’t checking for updates properly. (#11552)
Fixed an error that could occur when deploying a Craft 4 upgrade to another server. (#11558)
Fixed a bug where Assets fields were relocating assets when saving a revision.
Fixed a bug where asset bundles weren’t getting registered on the front end. (#11555)

4.1.1 - 2022-07-05

Changed

Improved the control panel tab design. (#11524)
Changed the order of relational field condition rule operators, so “is related to” is listed first. (#11550)
Template caching is now supported for console requests, for {% cache %} tags that have the globally param. (#11551)
Updated Composer to 2.2.15. (#11538)

Fixed

Fixed an error that could occur if any custom fields were missing their field group. (#11522)
Fixed a bug where custom selects weren’t scrolling to the visually-focused option.
Fixed errors that could occur if an element condition contained any rules for deleted custom fields. (#11526)
Fixed a bug where the “Deactivate users by default” user setting wasn’t working. (#11519)
Fixed a styling issue with the Edit Route modal. (#11528)
Fixed a bug where assets uploaded from Assets fields weren’t retaining their original filename. (#11530)
Fixed a bug where project config changes made at the end of the request lifecycle weren’t getting saved.
Fixed a bug where toggling entries’ and categories’ site-specific statuses from element editor slideouts wasn’t working. (#11547)
Fixed a SQL error that occurred when running the utils/prune-provisional-drafts command. (#11548)
Fixed focus styling issues with the Edit Route modal.

4.1.0.2 - 2022-06-28

Fixed

Fixed a PHP error. (#11518)

4.1.0.1 - 2022-06-28

Fixed

Fixed an infinite recursion bug. (#11514)

4.1.0 - 2022-06-28

Added

Field layouts can now have “Line Break” UI elements. (#11328)
Added the db/drop-all-tables command. (#11288)
Added the elements/delete command.
Added the elements/restore command.
Added the project-config/get command. (#11341)
Added the project-config/remove command. (#11341)
Added the project-config/set command. (#11341)
The AdminTable Vue component can now be included into other Vue apps, in addition to being used as a standalone app. (#11107)
Added a one() alias for first() to collections. (#11134)
Added craft\base\Element::EVENT_DEFINE_CACHE_TAGS. (#11171)
Added craft\base\Element::cacheTags().
Added craft\base\FieldInterface::getLabelId().
Added craft\console\controllers\UsersController::$activate.
Added craft\elements\conditions\ElementCondition::$sourceKey.
Added craft\elements\db\ElementQuery::EVENT_AFTER_POPULATE_ELEMENTS. (#11262)
Added craft\elements\db\ElementQuery::EVENT_DEFINE_CACHE_TAGS. (#11171)
Added craft\events\PopulateElementsEvent.
Added craft\fieldlayoutelements\BaseField::labelId().
Added craft\fieldlayoutelements\LineBreak.
Added craft\helpers\DateTimeHelper::now().
Added craft\helpers\DateTimeHelper::pause(). (#11130)
Added craft\helpers\DateTimeHelper::resume(). (#11130)

Changed

Improved overall control panel accessibility. (#11297, #11296, #11414, #11452)
Improved pagination UI accessibility. (#11126)
Improved element index accessibility. (#11169, #11200, #11251)
Improved Dashboard accessibility. (#11217, #11297)
Improved address management accessibility. (#11397)
Improved Matrix field accessibility. (#11306)
Improved mobile support. (#11323, #11430)
Improved keyboard support for custom selects. (#11414)
It’s now possible to remove all selected elements from relational fields by pressing Backspace or Delete while one of them is focused.
Improved the UI of condition builders. (#11386)
Entry Type condition rules now allow multiple selections. (#11124)
Element index filters now only show condition rules for the custom fields that are used by the field layouts in the selected source, if a native source is selected. (#11187)
Element index filters now only show condition rules for custom fields used by field layouts created for the target element type, if no native source is selected.
Condition builders can now include multiple rules with the same label, as long as they’re in different groups.
Asset indexes now have a “Location” table attribute option. (#11450)
It’s now possible to sort entries by their section and type. (#9192, #11335)
It’s now possible to sort assets by their file kind.
Element editor metadata now lists elements’ IDs.
Live Preview now always shows a “Refresh” button, regardless of whether the preview target has auto-refresh enabled. (#11160)
Sites’ Language settings now display the locale IDs as option hints, rather than the languages’ native names. (#11195)
Selectize options can now specify searchable keywords that won’t be visible in the UI.
Selectize inputs will now include their options’ values as search keywords.
Newly-created entries now get placeholder Post Date set on them, so they get sorted appropriately when querying for entries ordered by postDate. (#11272)
Element queries can now pass columns into the orderBy param in addition to score when searching. (#11470, #11457)
Field layout elements within field layout designers now support double-clicking to open their settings slideout. (#11277)
The control panel’s JavaScript queue is now paused when the browser tab isn’t visible. (#10632)
The db/restore command now asks whether the database should be backed up, and whether all existing database tables should be dropped, prior to restoring the backup. (#11288)
The users/create command now asks whether the user should be activated when saved.
The maxBackups config setting now impacts .sql.zip files in addition to .sql files. (#11241)
Deprecation messages are now consistently referred to as “deprecation warnings” in the control panel.
Callback functions returned by elements’ sortOptions()/defineSortOptions() methods are now passed a craft\db\Connection object as a second argument.
All element sources now have a “Set Status” action, even if the element type’s defineActions() method didn’t include one, if the element type’s hasStatuses() method returns true. (#11383)
All element sources now have a “View” action, even if the element type’s defineActions() method didn’t include one, if the element type’s hasUris() method returns true. (#11383)
All element sources now have “Edit” and “Delete” actions, even if the element type’s defineActions() method didn’t include them. (#11383)
The “Set Status” and “Edit” element actions are now only available for elements whose canSave() method returned true.
Assets fields now reject uploaded files which don’t pass their “Selectable Assets Condition” setting. (#11433)
It’s now possible to save new assets without setting their filename or kind attributes, as long as newLocation or newFilename is set. (#11439)
The searchindex table is now uses the InnoDB storage engine by default for MySQL installs. (#11374)
The _layouts/elementindex control panel template now sets the page title based on the element’s pluralDisplayName() method by default. (#11502)
craft\test\ActiveFixture::$data is now populated with the active record instances, making them accessible to tests via $this->tester->grabFixture('my-fixture', 'data-key'). (#11445)
Address validation rules are now defined by defineRules(). (#11471)
Garnish.DELETE_KEY now refers to the actual Delete key code, and the Backspace key code is now referenced by Garnish.BACKSPACE_KEY.

Deprecated

Deprecated craft\elements\actions\DeleteAssets. craft\elements\actions\Delete should be used instead.

Removed

Removed craft\elements\conditions\entries\EntryTypeCondition::$sectionUid.
Removed craft\elements\conditions\entries\EntryTypeCondition::$entryTypeUid.

4.0.6 - 2022-06-28

Added

Added craft\fields\BaseOptionsField::encodeValue().

Changed

Improved the install command’s error output when invalid options were passed.
canonical is now a reserved field handle. (#11503)
craft\fields\BaseOptionsField::translatedOptions() now has an $encode argument.

Fixed

Fixed a bug where self relations within relational fields were being forgotten. (#11461)
Fixed a bug where the install command required --site-name, --site-url, and --language options to be passed when project config YAML was already present. (#11513)
Fixed a bug where Garnish.setFocusWithin() wasn’t working if the first focusable element was a checkbox. (#11498)
Fixed a bug where Matrix blocks could be saved in the wrong order.
Fixed a bug where Checkboxes, Dropdown, Multi-select, and Radio Buttons fields could lose their values if their option values were set to integers. (#11461)

4.0.5.2 - 2022-06-24

Fixed

Fixed a SQL error that could occur on MySQL 5. (#11493)
Fixed a bug where Craft’s Composer commands weren’t ensuring that config.allow-plugins.yiisoft/yii2-composer was true in composer.json. (#11399)

4.0.5.1 - 2022-06-22

Fixed

Fixed a bug where not all changes to entries and categories created via the “Save and add another” action were propagating to other sites. (#11476)
Fixed a bug where it wasn’t possible to rename assets.
Fixed a bug where a provisional draft could be created for an entry if its form was interacted with before the page had fully initialized. (#11466)
Fixed exact phrase searching on PostgreSQL. (#11486)

4.0.5 - 2022-06-21

Added

Added craft\helpers\Number::isIntOrFloat().

Changed

Categories now support change tracking.
Improved performance when working with temp asset folders.
Temp asset folders are no longer created until they’re actually needed. (#11427)
Element index queries are no longer cached if they contain a search term.
Search inputs within field layout designers now prevent the containing form from being submitted when the Return key is pressed. (#11415)

Deprecated

Deprecated craft\services\Categories::pruneDeletedField(). (#11054)
Deprecated craft\services\Globals::pruneDeletedField(). (#11054)
Deprecated craft\services\Sections::pruneDeletedField(). (#11054)
Deprecated craft\services\Tags::pruneDeletedField(). (#11054)
Deprecated craft\services\Users::pruneDeletedField(). (#11054)
Deprecated craft\services\Volumes::pruneDeletedField(). (#11054)

Fixed

Fixed an error that could occur when saving an element to a disabled site. (#10499)
Fixed a bug where newly-added condition rules’ types were still selectable for preexisting condition rules, when they shouldn’t have been.
Fixed a bug where field layout designers were checking the wrong setting when determining whether to include UI elements (customizableTabs instead of customizableUi).
Fixed a bug where the Asset Indexes utility was analyzing image transform directories and files. (#11362, #11384)
Fixed a bug where focus was getting trapped within element editor slideouts’ sidebars even for wide viewports where there was enough room to display the sidebar side-by-side with other slideout content. (#11358)
Fixed a bug where users’ Formatting Locale preferences weren’t always being respected.
Fixed a bug where address card menus would linger around after an address was deleted.
Fixed a bug where the index-assets command could produce unexpected output. (#11194).
Fixed a bug where video controls within asset preview modals were inaccessible via the keyboard. (#11371)
Fixed a bug where transform GraphQL directives weren’t working for Assets fields. (#10299)
Fixed a PHP error that could occur when running the help command. (#11423)
Fixed a bug where craft\helpers\App::env() was converting some values to integers or floats unexpectedly. (#11422)
Fixed a bug where changes to existing Matrix blocks weren’t saving for element types that supported drafts but not change tracking. (#11419)
Fixed a bug where double-clicking on a related asset’s thumbnail could open the asset’s preview modal. (#11424)
Fixed a bug where the control panel wasn’t displaying file upload failure messages.
Fixed a bug where action query params were taking precedence over actionTrigger URI matches, when handling action requests. (#11435)
Fixed a bug where image fields within Edit User pages and the Settings → General page weren’t resetting properly after an image was deleted. (#11436)
Fixed a bug where User Group condition rules set to the “is not one of” operator weren’t being applied to individual elements correctly. (#11444)
Fixed a JavaScript error that occurred on element indexes for users that didn’t have permission to edit any sites.
Fixed a bug where users without permission to create new entries in a section could duplicate existing entries. (#11447)
Fixed a bug where element selection condition rules weren’t working if an element ID was provided. (#11451)
Fixed a PHP error that occurred when executing a GraphQL query using a token that wasn’t set to a schema. (#11453)
Fixed a PHP error that could occur when unserializing a craft\validator\DateTimeValidator, LanguageValidator, StringValidator, or TimeValidator object. (#11454)
Fixed a bug where element types’ actions() methods were getting called for all element-indexes/* action requests.
Fixed a bug where the install command would run non-interactively even if not all needed options were passed, resulting in an error after the database tables had been added. (#11305)
Fixed a viewport clipping bug on the control panel’s Login page. (#11372)
Fixed a bug where filtering an element query by a relational field using :empty:/:notempty: wasn’t factoring in the field’s “Which site should entries be related from?” setting properly.
Fixed a bug where filtering an element query by a relational field using :empty:/:notempty: wasn’t factoring in the source elements’ site IDs, for fields set to manage relations on a per-site basis. (#11418)
Fixed a bug where the Temporary Uploads asset source wasn’t including subfolders.
Fixed a bug where file upload progress bars weren’t always going away when an upload error occurred.
Fixed a bug where Pashto was not being treated as an RTL langauge. (#11428)
Fixed a bug where the upscaleImages config setting wasn’t being respected for transforms where only a single image dimension was specified. (#11398)
Fixed an error that could occur when executing a GraphQL query, if a section didn’t have any entry types. (#11273)
Fixed an error that could occur when changing the primary site on installs with a large number of users. (#11459)
Fixed a bug where Assets fields within Vizy fields weren’t getting relocated from the user’s temp uploads folder. (#11462)

Security

Environment-aware control panel fields no longer suggest environment variables that begin with HTTP_.
The Sendmail mailer no longer validates if the Sendmail Command setting is set to an enivornment variable that begins with HTTP_.

4.0.4 - 2022-06-03

Added

Added support for querying for users with a credentialed status.
Added craft\elements\db\UserQuery::STATUS_CREDENTIALED.
Added craft\errors\FieldNotFoundException.
Added craft\helpers\Html::encodeSpaces().
Added craft\web\twig\variables\Cp::getRequestedSite(). (#11082)

Changed

temp is now a reserved volume handle.
Improved the performance of field layout designers. (#11298)
All control panel pages now have a site--<siteHandle> class name on the <body>, based on the currently-selected site. (#11303)
Warnings are no longer logged when instantiating a field layout that references a deleted custom field. (#11333)
Read/write splitting is now disabled for all console requests.
The db/restore command now prompts to clear data caches after the import is complete. (#11327)
Entry queries no longer factor in seconds when looking for currently-live entries, without excluding entries that were published in the past minute. (#5389)
craft\elements\Asset::getUrl() now encodes any spaces in the URL as %20 entities.

Fixed

Fixed a bug where it wasn’t possible to disable all table columns for an element source. (#11291)
Fixed a bug where the Assets index page wasn’t allowing any bulk actions for assets in the temporary volume. (#11293)
Fixed a bug where PHP errors thrown while rendering a template weren’t being handled properly. (#11108)
Fixed a bug where site status labels were inconsistent on element edit pages. (#11307)
Fixed a bug where addresses’ County fields were mislablled. (#11314)
Fixed a bug where the control panel’s login form wasn’t handling errors properly. (#11319)
Fixed a bug where it wasn’t possible to use a {% redirect %} tag in an error template. (#11336)
Fixed an error that occurred when saving an entry via a GraphQL mutation. (#11312)
Fixed a bug where all web requests were getting no-cache headers. (#11346)
Fixed a bug where user caches weren’t getting invalidated when users were changed to a pending or inactive state.
Fixed a bug where querying for users with an active status was returning suspended users. (#11370)
Fixed a bug where it wasn’t possible to drag assets within Assets fields by their thumbnails. (#11364)
Fixed a bug where asset thumbnails weren’t loading if their filename contained a space. (#11350)
Fixed a bug where craft\services\AssetIndexer::indexFile() wasn’t removing the filename from the file path when setting the directory on the listing. (#11365)
Fixed a bug where links within custom field instructions were getting mangled. (#11377)
Fixed a bug where project config paths that contained slashes weren’t getting handled properly. (#10774)
Fixed a bug where the Login page had a tab-focusable “Skip to content” button. (#11375)

4.0.3 - 2022-05-20

Added

Added craft\elements\db\ElementQuery::prepareSubquery().

Changed

Element edit pages now disable pointer events on the content container for 300 milliseconds after the “Showing your unsaved changes” notice is displayed. (#11229)
Users can now create drafts for entries they have permission to view, but not save. (#11249)
User Group condition rules are no longer available in element conditions when no user groups exist. (#11252)
Matrix blocks now have data-type-name attributes. (#11286)
Reversed the order of Lightswitch fields’ “ON Label” and “OFF Label” settings. (#11259)
craft\services\Elements::duplicateElement() now has a $trackDuplication argument.
craft\services\Matrix::duplicateBlocks() now has a $trackDuplications argument.

Fixed

Fixed a bug where dynamically-defined image transforms weren’t respecting the format param, unless the generateTransformsBeforePageLoad config setting was enabled.
Fixed a bug where Table fields with Min Rows and Max Rows set to 1 were still showing a delete button. (#11211)
Fixed an error that could occur when saving an Assets field that was restricted to a single location, at the root of a volume. (#11212)
Fixed an error that could occur after a queue job execution had finished. (#11213)
Fixed an error that could occur when saving an entry with Matrix blocks. (#11155)
Fixed an error that occurred when saving a GraphQL schema without a scope. (#11240)
Fixed an error that could occur when editing the public GraphQL schema, if a public token existed in the project config, but not the database. (#11218)
Fixed some bugs with inconsistent asset indexing on Windows. (#11174), (#11219)
Fixed a bug where custom fields weren’t available to be included as table attributes. (#11222)
Fixed a bug where Alternative Text wasn’t available to be included as a table attribute. (#11222)immediately
Fixed a JavaScript error that broke Matrix fields with Min Blocks and Max Blocks both set to 1. (#11233)
Fixed a bug where request context logs could appear when nothing else was logged. (#11141)
Fixed a bug where stack traces could be erroneously filtered from logs.
Fixed a bug where removing an element from a relational field within an element editor could cause the editor to create a provisional draft, even if the element type didn’t support drafts. (#11242)
Fixed a bug where draft editor pages had two identical “Save and continue editing” alternate form actions.
Fixed a JavaScript warning that occurred when viewing an element edit page, if the user didn’t have permission to edit it.
Fixed a bug where asset selector modals weren’t fully initializing for Assets fields, if they were targeting the user’s temp folder. (#11254)
Fixed an error that occurred when saving an entry via a GraphQL mutation. (#11258)
Fixed a bug where Matrix block types’ layout elements were getting new UUIDs assigned each time the Matrix field was edited. (#11248)
Fixed a bug where the web-based installation wizard was throwing an exception if a database connection couldn’t be established, and there was no config/db.php file. (#11245)
Fixed a bug where editable tables’ delete buttons’ aria-label attributes weren’t getting updated when table rows were reordered or deleted.
Fixed a bug where editable tables’ delete buttons weren’t visually disabled when the minimum number of rows had been reached.
Fixed a bug where all eager-loaded srcset-style transform sizes were relative to the first eager-loaded transform, rather than the prior one. (#11209)
Fixed a bug where eager-loaded srcset-style transform sizes didn’t reference the prior eager-loaded transform’s format, interlace, mode, position, or quality settings. (#11264)
Fixed a bug where the web-based installation wizard wouldn’t show the database connection screen if a connection could be established but no database was selected. (#11245)
Fixed an error that could occur when applying a multi-site draft with relational fields. (#11220)
Fixed a bug where Matrix blocks could be deleted from newly-created multi-site entries, if the edit page was reloaded. (#10906)

4.0.2 - 2022-05-11

Added

Added craft\events\LocateUploadedFilesEvent.
Added craft\fields\Assets::EVENT_LOCATE_UPLOADED_FILES. (#11123)

Changed

elements/* actions no longer include custom field values in the response data, improving performance.
Garnish menu buttons are now aware of the disabled attribute. (#11128)
Improved save performance for multi-site elements (#11113)
Built-in Composer actions now ensure that composer.json allows the craftcms/plugin-installer Composer plugin.

Fixed

Fixed an error that occurred when searching for elements by a custom field. (#11120)
Fixed a bug where asset upload failures weren’t being handled properly. (#11156)
Fixed a bug where warning and error logs were being sent to both stdout and stderr when CRAFT_STREAM_LOG was enabled. (#11189)
Fixed an error that occurred when exporting elements with relational fields using the “Expanded” export type. (#11127)
Fixed a PHP deprecation warning that occurred if the tablePrefix database connection setting was null.
Fixed a bug where category groups were being identified as “{name}” in user permission lists. (#11132)
Fixed a bug where Assets fields’ “Upload files” buttons weren’t wrapping when there wasn’t enough space to show them alongside “Add an asset”. (#11133)
Fixed a bug where Craft.getUrl() was appending empty query strings to URLs when they weren’t needed. (#11159)
Fixed a bug where addresses could validate the wrong set of required fields, if the validation rules were invoked before the country code was set. (#11162)
Fixed an error that could occur when viewing the Temporary Uploads volume, if the Temp Uploads Location asset setting was set to “In the local temp folder”. (#11192)
Fixed an error that could occur when deleting a volume, if its filesystem had been deleted.
Fixed an error that could occur when rendering the thumbnail preview for an asset, if its file was missing. (#11196)
Fixed a bug where soft-deleted drafts’ search keywords weren’t getting re-indexed if they were restored.
Fixed an error that occurred when transforming an SVG image without specifying a width or height. (#11122)
Fixed an error that occurred when saving a Number field with a non-numeric value. (#11164)
Fixed a bug where it wasn’t possible to drag an item to the top in admin tables. (#10781)
Fixed a bug where entries within Structure sections weren’t expandable if their only descendants were unpublished drafts.
Fixed a bug where expanding a collapsed Structure section entry wouldn’t reveal its descendants, if the parent was a draft. (#11186)
Fixed a bug where element caches weren’t getting cleared for elements when they were propagated to a newly-created site.

4.0.1 - 2022-05-06

Fixed

Fixed a bug where Money field labels’ for attributes weren’t referencing the correct input ID. (#11016)
Fixed a bug where Money field inputs weren’t getting aria-describedby attributes. (#11016)
Fixed an error that occurred when loading an edit screen for an element type that didn’t have a field layout. (#11110)
Fixed a bug where condition rules that weren’t selectable (per isSelectable()) were still visible in the rule dropdown menu. (#11104)
Fixed a bug where element edit pages could reload themselves immediately after saving the element. (#11084)
Fixed a bug where tabs weren’t interactive after changing an entry’s type, if the new entry type didn’t have a tab of the same name as the previously-selected tab. (#11093)
Fixed a bug where Twig syntax errors weren’t being handled properly. (#11108)
Fixed an error that occurred when attempting to delete a global set. (#11100)
Fixed an error that could occur when applying a draft. (#11083)
Fixed a bug where element queries weren’t returning any results if an element attribute table wasn’t joined in, and the element query was set to an abstract element class. (#11105)

4.0.0.1 - 2022-05-04

Changed

The setup command now writes the application ID to a CRAFT_APP_ID environment variable.
The setup command now writes the security key to a CRAFT_SECURITY_KEY environment variable.

4.0.0 - 2022-05-04

Added

Entries’, categories’, and assets’ edit pages, and all element types via slideouts, now use a unified editing experience. (#10467)
Categories now support drafts. (#10467)
Element slideouts now support provisional drafts and autosaving, for element types that support them. (#10467)
Element indexes can now be filtered by element attributes and custom field values. (#9192, #9450, #9462, #9483)
Admins can now create custom element sources from the Customize Sources modal. (#8423)
It’s now possible to disable native element sources from the Customize Sources modal. (#10676)
Field layout tabs, fields, and UI elements can now be conditionally shown based on properties of the current user and/or element being edited. (#8099, #8154)
Assets, Entries, and Users fields have new condition settings that can be used to further limit which elements should be relatable, beyond the existing field settings. (#10393)
Assets, Entries, and Users fields have new “Min Relations” settings, and their former “Limit” settings have been renamed to “Max Relations”. (#8621)
Added a dedicated “Full Name” field to users. “First Name” and “Last Name” are now parsed out from the full name automatically when a user is saved. (#10405)
Added the “Inactive” user status, which can be used by users which can’t be signed into. (#8963)
Added “Credentialed” and “Inactive” user sources.
Added the “Deactivate…” user action for pending and active users.
Users can now have an “Addresses” field. (#10507)
Added the concept of “filesystems”, which handle file operations, either locally or on a remote service like Amazon S3.
It’s now possible to set sites’ Status settings to environment variables. (#3005)
Added the Money field type.
Craft now provides a native “Alternative Text” (alt) field for assets. (#10302)
Asset thumbnails in the control panel now have alt attributes, for assets with a filled-in Alternative Text value.
Added the index-assets/cleanup command.
Added the “Deactivate users by default” user registration setting, which replaces “Suspend users by default”. (#5830)
Element source settings are now stored in the project config. (#8616)
Improved element index accessibility. (#10629, #10660)
Improved Live Preview accessibility for screen readers. (#10688)
Slideouts, Live Preview, and Matrix blocks are no longer animated for browsers that have requested reduced motion. (#10665)
Added support for JSON columns. (#9089)
It’s now possible to edit images’ focal points from their preview modals. (#8489)
Added support for Monolog and the PSR-3 logging interface. (#10659)
Added the |address Twig filter.
Added the |money Twig filter.
Added the collect() Twig function.
Added the assetUploaders, authors, and fullName user query params.
Added the primaryOwner and primaryOwnerId Matrix block query params.
Added the hasAlt asset query param.
Added the button, submitButton, fs, fsField, volume, and volumeField macros to the _includes/forms control panel template.
Added the buildId general config. (#10705)
Added support for setting custom config settings from config/custom.php, which are accessible via Craft::$app->config->custom. (#10012)
Added the addresses, address, and addressCount GraphQL queries.
Added the hasAlt argument to asset GraphQL queries.
Added the alt field to assets queried via GraphQL.
Added the fullName, assetUploaders, and authors arguments to user GraphQL queries.
Added the addresses field to user GraphQL queries.
GraphQL schemas now include settings that determine which sites elements can be queried from. (#10610)
Added the assets/icon action.
Added the assets/update-focal-point action.
Added the categories/create action.
Added the elements/apply-draft action.
Added the elements/create action.
Added the elements/delete-draft action.
Added the elements/delete-for-site action.
Added the elements/delete action.
Added the elements/duplicate action.
Added the elements/edit action.
Added the elements/redirect action.
Added the elements/revert action.
Added the elements/save-draft action.
Added the elements/save action.
Added the users/delete-address action.
Added the users/save-address action.
Added the app/render-element control panel controller action.
Added the element-indexes/element-table-html control panel controller action.
Added craft\base\ApplicationTrait::getConditions().
Added craft\base\ApplicationTrait::getElementSources(), which replaces getElementIndexes().
Added craft\base\ApplicationTrait::getFs().
Added craft\base\ApplicationTrait::getImageTransforms(), which replaces getAssetTransforms().
Added craft\base\conditions\BaseCondition.
Added craft\base\conditions\BaseConditionRule.
Added craft\base\conditions\BaseDateRangeConditionRule.
Added craft\base\conditions\BaseElementSelectConditionRule.
Added craft\base\conditions\BaseLightswitchConditionRule.
Added craft\base\conditions\BaseMultiSelectConditionRule.
Added craft\base\conditions\BaseNumberConditionRule.
Added craft\base\conditions\BaseSelectConditionRule.
Added craft\base\conditions\BaseTextConditionRule.
Added craft\base\conditions\ConditionInterface.
Added craft\base\conditions\ConditionRuleInterface.
Added craft\base\Element::EVENT_AUTHORIZE_CREATE_DRAFTS.
Added craft\base\Element::EVENT_AUTHORIZE_DELETE_FOR_SITE.
Added craft\base\Element::EVENT_AUTHORIZE_DELETE.
Added craft\base\Element::EVENT_AUTHORIZE_DUPLICATE.
Added craft\base\Element::EVENT_AUTHORIZE_SAVE.
Added craft\base\Element::EVENT_AUTHORIZE_VIEW.
Added craft\base\Element::EVENT_DEFINE_ADDITIONAL_BUTTONS. (#10420)
Added craft\base\Element::getParentId().
Added craft\base\Element::hasNewParent().
Added craft\base\Element::notesFieldHtml().
Added craft\base\Element::setParentId().
Added craft\base\Element::statusFieldHtml().
Added craft\base\ElementInterface::canCreateDrafts().
Added craft\base\ElementInterface::canDelete().
Added craft\base\ElementInterface::canDeleteForSite().
Added craft\base\ElementInterface::canDuplicate().
Added craft\base\ElementInterface::canSave().
Added craft\base\ElementInterface::canView().
Added craft\base\ElementInterface::createAnother().
Added craft\base\ElementInterface::createCondition().
Added craft\base\ElementInterface::getAdditionalButtons().
Added craft\base\ElementInterface::getPostEditUrl().
Added craft\base\ElementInterface::getThumbAlt().
Added craft\base\ElementInterface::hasRevisions().
Added craft\base\ElementInterface::prepareEditScreen().
Added craft\base\FieldInterface::getElementConditionRuleType().
Added craft\base\FieldInterface::isRequirable().
Added craft\base\FieldLayoutComponent.
Added craft\base\Fs.
Added craft\base\FsInterface.
Added craft\base\FsTrait.
Added craft\base\Image::heartbeat().
Added craft\base\Image::setHeartbeatCallback().
Added craft\base\imagetransforms\EagerImageTransformerInterface.
Added craft\base\imagetransforms\ImageEditorTransformerInterface.
Added craft\base\imagetransforms\ImageTransformerInterface.
Added craft\base\LocalFsInterface.
Added craft\base\Model::defineBehaviors(). (#10691)
Added craft\base\ModelInterface.
Added craft\base\NameTrait.
Added craft\base\PluginInterface::config(). (#11039)
Added craft\behaviors\SessionBehavior::broadcastToJs().
Added craft\behaviors\SessionBehavior::getError().
Added craft\behaviors\SessionBehavior::getNotice().
Added craft\controllers\AddressesController.
Added craft\controllers\AssetIndexesController.
Added craft\controllers\ConditionsController.
Added craft\controllers\ElementIndexesController::$condition.
Added craft\controllers\FsController.
Added craft\controllers\ImageTransformsController.
Added craft\db\Migration::archiveTableIfExists(). (#10827)
Added craft\db\Migration::dropAllForeignKeysToTable().
Added craft\db\Migration::dropForeignKeyIfExists().
Added craft\db\Migration::renameTable().
Added craft\db\Query::collect(), which returns the query results as an Illuminate\Support\Collection object rather than an array. (#8513)
Added craft\db\Table::ADDRESSES.
Added craft\db\Table::ASSETINDEXINGSESSIONS.
Added craft\db\Table::IMAGETRANSFORMINDEX.
Added craft\db\Table::IMAGETRANSFORMS.
Added craft\db\Table::MATRIXBLOCKS_OWNERS.
Added craft\debug\LogTarget.
Added craft\debug\MailPanel.
Added craft\elements\Address.
Added craft\elements\Asset::$alt.
Added craft\elements\Asset::EVENT_AFTER_GENERATE_TRANSFORM.
Added craft\elements\Asset::EVENT_BEFORE_GENERATE_TRANSFORM.
Added craft\elements\Asset::getFs().
Added craft\elements\Asset::setFilename().
Added craft\elements\conditions\addresses\AddressCondition.
Added craft\elements\conditions\addresses\CountryConditionRule.
Added craft\elements\conditions\assets\AssetCondition.
Added craft\elements\conditions\assets\DateModifiedConditionRule.
Added craft\elements\conditions\assets\FilenameConditionRule.
Added craft\elements\conditions\assets\FileSizeConditionRule.
Added craft\elements\conditions\assets\FileTypeConditionRule.
Added craft\elements\conditions\assets\HasAltConditionRule.
Added craft\elements\conditions\assets\HeightConditionRule.
Added craft\elements\conditions\assets\UploaderConditionRule.
Added craft\elements\conditions\assets\VolumeConditionRule.
Added craft\elements\conditions\assets\WidthConditionRule.
Added craft\elements\conditions\categories\CategoryCondition.
Added craft\elements\conditions\categories\GroupConditionRule.
Added craft\elements\conditions\DateCreatedConditionRule.
Added craft\elements\conditions\DateUpdatedConditionRule.
Added craft\elements\conditions\ElementCondition.
Added craft\elements\conditions\ElementConditionInterface.
Added craft\elements\conditions\ElementConditionRuleInterface.
Added craft\elements\conditions\entries\AuthorConditionRule.
Added craft\elements\conditions\entries\AuthorGroupConditionRule.
Added craft\elements\conditions\entries\EntryCondition.
Added craft\elements\conditions\entries\ExpiryDateConditionRule.
Added craft\elements\conditions\entries\PostDateConditionRule.
Added craft\elements\conditions\entries\SectionConditionRule.
Added craft\elements\conditions\entries\TypeConditionRule.
Added craft\elements\conditions\HasUrlConditionRule.
Added craft\elements\conditions\IdConditionRule.
Added craft\elements\conditions\LevelConditionRule.
Added craft\elements\conditions\RelatedToConditionRule.
Added craft\elements\conditions\SlugConditionRule.
Added craft\elements\conditions\tags\GroupConditionRule.
Added craft\elements\conditions\tags\TagCondition.
Added craft\elements\conditions\TitleConditionRule.
Added craft\elements\conditions\UriConditionRule.
Added craft\elements\conditions\users\AdminConditionRule.
Added craft\elements\conditions\users\CredentialedConditionRule.
Added craft\elements\conditions\users\EmailConditionRule.
Added craft\elements\conditions\users\FirstNameConditionRule.
Added craft\elements\conditions\users\GroupConditionRule.
Added craft\elements\conditions\users\LastLoginDateConditionRule.
Added craft\elements\conditions\users\LastNameConditionRule.
Added craft\elements\conditions\users\UserCondition.
Added craft\elements\conditions\users\UsernameConditionRule.
Added craft\elements\db\AddressQuery.
Added craft\elements\MatrixBlock::$primaryOwnerId.
Added craft\elements\MatrixBlock::$saveOwnership.
Added craft\elements\User::$active.
Added craft\elements\User::$fullName.
Added craft\elements\User::canAssignUserGroups().
Added craft\elements\User::getAddresses().
Added craft\elements\User::getIsCredentialed().
Added craft\elements\User::STATUS_INACTIVE.
Added craft\errors\FsException.
Added craft\errors\FsObjectExistsException.
Added craft\errors\FsObjectNotFoundException.
Added craft\errors\ImageTransformException.
Added craft\errors\InvalidFsException.
Added craft\errors\MissingVolumeFolderException.
Added craft\events\AuthorizationCheckEvent.
Added craft\events\CreateElementCheckEvent.
Added craft\events\DefineElementEditorHtmlEvent.
Added craft\events\DefineElementInnerHtmlEvent. (#11035)
Added craft\events\DefineHtmlEvent::$static.
Added craft\events\FsEvent.
Added craft\events\GenerateTransformEvent::$asset.
Added craft\events\GenerateTransformEvent::$transform.
Added craft\events\GenerateTransformEvent::$url.
Added craft\events\ImageTransformerOperationEvent.
Added craft\events\ImageTransformEvent.
Added craft\events\RegisterConditionRuleTypesEvent.
Added craft\events\TransformImageEvent.
Added craft\fieldlayoutelements\addresses\AddressField.
Added craft\fieldlayoutelements\addresses\CountryCodeField.
Added craft\fieldlayoutelements\addresses\LabelField.
Added craft\fieldlayoutelements\addresses\LatLongField.
Added craft\fieldlayoutelements\addresses\OrganizationField.
Added craft\fieldlayoutelements\addresses\OrganizationTaxIdField.
Added craft\fieldlayoutelements\assets\AltField.
Added craft\fieldlayoutelements\BaseField::selectorLabel().
Added craft\fieldlayoutelements\FullNameField.
Added craft\fieldlayoutelements\TextareaField.
Added craft\fieldlayoutelements\users\AddressesField.
Added craft\fields\Assets::$allowSubfolders.
Added craft\fields\Assets::$restrictedDefaulUploadSubpath.
Added craft\fields\BaseRelationField::createSelectionCondition().
Added craft\fields\BaseRelationField::getSelectionCondition().
Added craft\fields\BaseRelationField::setSelectionCondition().
Added craft\fields\conditions\DateFieldConditionRule.
Added craft\fields\conditions\FieldConditionRuleInterface.
Added craft\fields\conditions\FieldConditionRuleTrait.
Added craft\fields\conditions\LightswitchFieldConditionRule.
Added craft\fields\conditions\NumberFieldConditionRule.
Added craft\fields\conditions\OptionsFieldConditionRule.
Added craft\fields\conditions\RelationalFieldConditionRule.
Added craft\fields\conditions\TextFieldConditionRule.
Added craft\fields\Money.
Added craft\fs\Local.
Added craft\fs\MissingFs.
Added craft\fs\Temp.
Added craft\gql\arguments\elements\Address.
Added craft\gql\base\SingularTypeInterface.
Added craft\gql\interfaces\elements\Address.
Added craft\gql\queries\Address.
Added craft\gql\resolvers\elements\Address.
Added craft\gql\TypeManager::registerFieldDefinitions().
Added craft\gql\types\elements\Address.
Added craft\gql\types\generators\AddressType.
Added craft\helpers\App::cliOption().
Added craft\helpers\App::devMode().
Added craft\helpers\App::envConfig(). (#10869)
Added craft\helpers\App::isStreamLog().
Added craft\helpers\App::normalizeValue().
Added craft\helpers\Assets::downloadFile().
Added craft\helpers\Assets::iconPath().
Added craft\helpers\Assets::iconUrl().
Added craft\helpers\Assets::revParams().
Added craft\helpers\Cp::addressCardHtml().
Added craft\helpers\Cp::addressCardsHtml().
Added craft\helpers\Cp::addressFieldsHtml().
Added craft\helpers\Cp::dateFieldHtml().
Added craft\helpers\Cp::dateHtml().
Added craft\helpers\Cp::elementSelectHtml().
Added craft\helpers\Cp::EVENT_DEFINE_ELEMENT_INNER_HTML. (#11035)
Added craft\helpers\Cp::fieldLayoutDesignerHtml().
Added craft\helpers\Cp::lightswitchHtml().
Added craft\helpers\Cp::multiSelectFieldHtml().
Added craft\helpers\Cp::multiSelectHtml().
Added craft\helpers\Cp::requestedSite().
Added craft\helpers\Cp::textareaHtml().
Added craft\helpers\Cp::textHtml().
Added craft\helpers\Cp::timeFieldHtml().
Added craft\helpers\Cp::timeHtml().
Added craft\helpers\Db::dropAllForeignKeysToTable().
Added craft\helpers\Db::dropForeignKeyIfExists().
Added craft\helpers\Db::dropIndexIfExists().
Added craft\helpers\Db::findForeignKey().
Added craft\helpers\Db::findIndex().
Added craft\helpers\Db::parseMoneyParam().
Added craft\helpers\Db::parseNumericParam().
Added craft\helpers\Db::prepareMoneyForDb().
Added craft\helpers\Db::renameTable().
Added craft\helpers\FileHelper::deleteFileAfterRequest().
Added craft\helpers\FileHelper::deleteQueuedFiles().
Added craft\helpers\Gql::getSchemaContainedEntryTypes)().
Added craft\helpers\Html::hiddenLabel().
Added craft\helpers\Html::unwrapCondition().
Added craft\helpers\Html::unwrapNoscript().
Added craft\helpers\ImageTransforms.
Added craft\helpers\Money.
Added craft\helpers\Number::isInt().
Added craft\helpers\Number::toIntOrFloat().
Added craft\helpers\ProjectConfig::encodeValueAsString().
Added craft\helpers\ProjectConfig::ensureAllSectionsProcessed().
Added craft\helpers\ProjectConfig::traverseDataArray().
Added craft\helpers\Typecast. (#10706)
Added craft\i18n\Translation.
Added craft\imagetransforms\ImageTransformer.
Added craft\log\ContextProcessor.
Added craft\log\Dispatcher::getTargets().
Added craft\log\MessageProcessor.
Added craft\log\MonologTarget.
Added craft\models\AssetIndexingSession.
Added craft\models\FieldLayout::getElementsByType().
Added craft\models\FieldLayout::getFirstElementByType().
Added craft\models\FieldLayout::getFirstVisibleElementByType().
Added craft\models\FieldLayout::getVisibleCustomFields().
Added craft\models\FieldLayout::getVisibleElementsByType().
Added craft\models\FieldLayoutElement::$uid.
Added craft\models\FieldLayoutElement::getLayout() and setLayout().
Added craft\models\FieldLayoutForm::getVisibleElements().
Added craft\models\FieldLayoutFormTab::getTabId().
Added craft\models\FieldLayoutFormTab::getUid().
Added craft\models\FieldLayoutTab::getElements() and setElements().
Added craft\models\FsListing.
Added craft\models\ImageTransform.
Added craft\models\ImageTransformIndex.
Added craft\models\ProjectConfigData.
Added craft\models\ReadOnlyProjectConfigData.
Added craft\models\Volume.
Added craft\queue\jobs\Proxy.
Added craft\queue\Queue::$proxyQueue, which can be set to another queue configuration that all jobs should be sent to as proxies. (#10999)
Added craft\records\Address.
Added craft\records\AssetIndexingSession.
Added craft\records\ImageTransform.
Added craft\services\Addresses.
Added craft\services\AssetIndexer::createIndexingSession().
Added craft\services\AssetIndexer::getExistingIndexingSessions().
Added craft\services\AssetIndexer::getIndexingSessionById().
Added craft\services\AssetIndexer::getMissingEntriesForSession().
Added craft\services\AssetIndexer::getSkippedItemsForSession().
Added craft\services\AssetIndexer::indexFileByListing().
Added craft\services\AssetIndexer::indexFolderByEntry().
Added craft\services\AssetIndexer::indexFolderByListing().
Added craft\services\AssetIndexer::processIndexSession().
Added craft\services\AssetIndexer::removeCliIndexingSessions().
Added craft\services\AssetIndexer::startIndexingSession().
Added craft\services\AssetIndexer::stopIndexingSession().
Added craft\services\Assets::getImagePreviewUrl().
Added craft\services\AssetTransforms::deleteTransformIndexDataByAssetIds().
Added craft\services\Conditions.
Added craft\services\Config::CATEGORY_CUSTOM.
Added craft\services\Config::getCustom().
Added craft\services\Drafts::removeDraftData().
Added craft\services\ElementSources, which replaces craft\services\ElementIndexes.
Added craft\services\Fields::createLayout().
Added craft\services\Fs.
Added craft\services\Gc::hardDeleteElements().
Added craft\services\Gc::removeEmptyTempFolders().
Added craft\services\Gql::prepareFieldDefinitions().
Added craft\services\ImageTransforms.
Added craft\services\Matrix::createRevisionBlocks().
Added craft\services\Matrix::duplicateOwnership().
Added craft\services\ProjectConfig::ASSOC_KEY.
Added craft\services\ProjectConfig::PATH_DATE_MODIFIED.
Added craft\services\ProjectConfig::PATH_ELEMENT_SOURCES.
Added craft\services\ProjectConfig::PATH_FS.
Added craft\services\ProjectConfig::PATH_META_NAMES.
Added craft\services\ProjectConfig::PATH_SCHEMA_VERSION.
Added craft\services\ProjectConfig::PATH_SYSTEM.
Added craft\services\ProjectConfig::rememberAppliedChanges().
Added craft\services\Users::deactivateUser().
Added craft\services\Users::ensureUserByEmail(), which will return a user for the given email, creating one if it didn’t exist yet.
Added craft\services\Users::EVENT_AFTER_DEACTIVATE_USER.
Added craft\services\Users::EVENT_BEFORE_DEACTIVATE_USER.
Added craft\services\Users::removeCredentials().
Added craft\services\Volumes::getTemporaryVolume().
Added craft\services\Volumes::getUserPhotoVolume().
Added craft\validators\MoneyValidator.
Added craft\web\assets\conditionbuilder\ConditionBuilderAsset.
Added craft\web\assets\htmx\HtmxAsset.
Added craft\web\assets\money\MoneyAsset.
Added craft\web\Controller::asCpScreen().
Added craft\web\Controller::asFailure().
Added craft\web\Controller::asModelFailure().
Added craft\web\Controller::asModelSuccess().
Added craft\web\Controller::asSuccess().
Added craft\web\Controller::CpScreenResponseBehavior().
Added craft\web\Controller::CpScreenResponseFormatter().
Added craft\web\Controller::getPostedRedirectUrl().
Added craft\web\Controller::TemplateResponseBehavior().
Added craft\web\Controller::TemplateResponseFormatter().
Added craft\web\twig\Extension::addressFilter().
Added craft\web\twig\Extension::moneyFilter().
Added craft\web\twig\variables\Cp::fieldLayoutDesigner().
Added craft\web\twig\variables\Cp::getFsOptions().
Added craft\web\twig\variables\Cp::getVolumeOptions().
Added craft\web\View::clearCssFileBuffer().
Added craft\web\View::clearJsFileBuffer().
Added craft\web\View::startCssFileBuffer().
Added craft\web\View::startJsFileBuffer().
Added the Craft.appendBodyHtml() JavaScript method, which replaces the now-deprecated appendFootHtml() method.
Added the Craft.CpScreenSlideout JavaScript class, which can be used to create slideouts from actions that return $this->asCpScreen().
Added the Craft.ElementEditor JavaScript class.
Added the Craft.ElementEditorSlideout JavaScript class.
Added the Craft.getPageUrl() JavaScript method.
Added the Craft.getQueryParam() JavaScript method.
Added the Craft.getQueryParams() JavaScript method.
Added the Craft.namespaceId() JavaScript method.
Added the Craft.namespaceInputName() JavaScript method.
Added the Craft.Preview.refresh() JavaScript method.
Added the Craft.Queue JavaScript class.
Added the Craft.setElementAttributes() JavaScript method.
Added the Craft.setPath() JavaScript method.
Added the Craft.setQueryParam() JavaScript method.
Added the Craft.setUrl() JavaScript method.
Added the Craft.ui.createButton() JavaScript method.
Added the Craft.ui.createSubmitButton() JavaScript method.
Added the htmx.org JavaScript library.
Added the commerceguys/addressing package.
Added the illuminate/collections package. (#8475)
Added the moneyphp/money package.
Added the symfony/var-dumper package.
Added the theiconic/name-parser package.
Added the yiisoft/yii2-symfonymailer package.

Changed

Craft now requires PHP 8.0.2 or later.
Craft now requires MySQL 5.7.8 / MariaDB 10.2.7 / PostgreSQL 10.0 or later.
Craft now requires the Intl and BCMath PHP extensions.
Improved draft creation/application performance. (#10577)
Improved revision creation performance. (#10589)
The “What’s New” HUD now displays an icon and label above each announcement, identifying where it came from (Craft CMS or a plugin). (#9747)
The control panel now keeps track of the currently-edited site on a per-tab basis by adding a site query string param to all control panel URLs. (#8920)
Element index pages’ status and sort menu option selections are now coded into the page URL via status and sort query string params. (#10669)
Users are no longer required to have a username or email.
Users can now set their Formatting Locale to any known locale; not just the available Language options. (#10519)
Users’ Language and Formatting Locale settings now display locale names in the current language and their native languages. (#10519)
User queries now return all users by default, rather than only active users.
Filtering users by active, pending, and locked statuses no longer excludes suspended users.
credentialed and inactive are now reserved user group handles.
Elements throughout the control panel are now automatically updated whenever they’re saved by another browser tab.
Assets fields that are restricted to a single location can now be configured to allow selection within subfolders of that location. (#9070)
When an image is saved as a new asset from the Image Editor via an Assets field, the Assets field will now automatically replace the selected asset with the new one. (#8974)
alt is now a reserved field handle for volume field layouts.
Volumes no longer have “types”, and their file operations are now delegated to a filesystem selected by an “Asset Filesystem” setting on the volume.
Volumes now have “Transform Filesystem” and “Transform Subpath” settings, which can be used to choose where image transforms should be stored. (The volume’s Asset Filesystem will be used by default.)
Asset thumbnails are now generated as image transforms.
It’s now possible to create volumes directly from the User Settings page.
Images that are not web-safe now are always converted to JPEGs when transforming, if no format was specified.
Entry post dates are no longer set automatically until the entry is validated with the live scenario. (#10093)
Entry queries’ authorGroup() param method now accepts an array of craft\models\UserGroup objects.
Element queries’ revision params can now be set to null to include normal and revision elements.
Element queries can no longer be traversed or accessed like an array. Use a query execution method such as all(), collect(), or one() to fetch the results before working with them.
Element queries’ title params no longer treat values with commas as arrays. (#10891)
User queries’ firstName and lastName params no longer treat values with commas as arrays. (#10891)
Relational fields now load elements in the current site rather than the primary site, if the source element isn’t localizable. (#7048)
Lightswitch fields can no longer be marked as required within field layouts. (#10773)
Built-in queue jobs are now always translated for the current user’s language. (#9745)
Path options passed to console commands (e.g. --basePath) now take precedence over their enivronment variable/PHP constant counterparts.
Database backups are now named after the Craft version in the database, rather than the Composer-installed version. (#9733)
Template autosuggestions now include their filename. (#9744)
Improved the look of loading spinners in the control panel. (#9109)
The default subLeft and subRight search query term options are now only applied to terms that don’t include an asterisk at the beginning/end, e.g. hello*. (#10613)
{% cache %} tags now store any external JavaScript or CSS files registered with {% js %} and {% css %} tags. (#9987)
All control panel templates end in .twig now. (#9743)
404 requests are no longer logged by default. (#10659)
Log entries are now single-line by default when Dev Mode is disabled. (#10659)
Log files are now rotated once every 24 hours. (#10659)
CRAFT_STREAM_LOG no longer logs in addition to other log targets. (#10659)
The default log target no longer logs debug or info messages when Dev Mode is enabled. (#10916)
SQL query logs now use the debug log level, so they no longer get logged when Dev Mode is enabled. (#10916)
yii\db\Connection::$enableLogging and $enableProfiling are no longer enabled by default when Dev Mode is disabled. (#10916)
The queue log target no longer has special handling for Yii or info logs. (#10916)
A warning is now logged if an element query is executed before Craft is fully initialized. (#11033)
A warning is now logged if Twig is instantiated before Craft is fully initialized. (#11033)
Craft’s bootstrap script now attempts to create its configured system paths automatically. (#10562)
When using GraphQL to mutate entries, the enabled status is now affected on a per-site basis when specifying both the enabled and siteId parameters. (#9771)
The forms/selectize control panel template now supports addOptionFn and addOptionLabel params, which can be set to add new options to the list.
Editable tables now support allowAdd, allowDelete, and allowReorder settings, replacing staticRows. (#10163)
Column definitions passed to the _includes/forms/editableTable control panel template can now specify a width key. (#11062)
The limitField macro in the _components/fieldtypes/elementfieldsettings control panel template has been renamed to limitFields.
Renamed the elements/get-categories-input-html action to categories/input-html.
Renamed the elements/get-modal-body action to element-selector-modals/body.
The entries/save-entry action now returns a 400 HTTP status for JSON responses when the entry couldn’t be saved.
The users/save-user action no longer includes a unverifiedEmail key in failure responses.
The users/set-password action now returns a 400 HTTP status when an invalid token is passed, if there’s no URL to redirect to. (#10592)
install/*, setup/*, db/*, and help actions no longer output a warning if Craft can’t connect to the database. (#10851)
createFoldersInVolume:<uid> user permissions have been renamed to createFolders:<uid>.
deleteFilesAndFoldersInVolume:<uid> user permissions have been renamed to deleteAssets:<uid>.
deletePeerFilesInVolume:<uid> user permissions have been renamed to deletePeerAssets:<uid>.
editCategories:<uid> user permissions have been split into viewCategories:<uid>, saveCategories:<uid>, deleteCategories:<uid>, viewPeerCategoryDrafts:<uid>, savePeerCategoryDrafts:<uid>, and deletePeerCategoryDrafts:<uid>.
editEntries:<uid> user permissions have been renamed to viewEntries:<uid>.
editImagesInVolume:<uid> user permissions have been renamed to editImages:<uid>.
editPeerEntries:<uid> user permissions have been renamed to viewPeerEntries:<uid>.
editPeerEntryDrafts:<uid> user permissions have been split into viewPeerEntryDrafts:<uid> and savePeerEntryDrafts:<uid>.
editPeerFilesInVolume:<uid> user permissions have been renamed to savePeerAssets:<uid>.
editPeerImagesInVolume:<uid> user permissions have been renamed to editPeerImages:<uid>.
publishEntries:<uid> user permissions have been renamed to saveEntries:<uid>, and no longer differentiate between enabled and disabled entries. (Users with viewEntries:<uid> permissions will still be able to create drafts.)
publishPeerEntries:<uid> user permissions have been renamed to savePeerEntries:<uid>, and no longer differentiate between enabled and disabled entries. (Users with viewPeerEntries:<uid> permissions will still be able to create drafts.)
replaceFilesInVolume:<uid> user permissions have been renamed to replaceFiles:<uid>.
replacePeerFilesInVolume:<uid> user permissions have been renamed to replacePeerFiles:<uid>.
saveAssetInVolume:<uid> user permissions have been renamed to saveAssets:<uid>.
viewPeerFilesInVolume:<uid> user permissions have been renamed to viewPeerAssets:<uid>.
viewVolume:<uid> user permissions have been renamed to viewAssets:<uid>.
Elements’ searchScore GraphQL fields are now returned as integers.
Element types must now override craft\base\Element::isDeletable() if its elements should be deletable from the index page.
Element types’ cpEditUrl() methods no longer need to add a site param; one will be added automatically by craft\base\Element::getCpEditUrl().
Element types’ defineActions() methods’ $source arguments should no longer accept null.
Element types’ defineSources() methods’ $context arguments should no longer accept null.
Element types’ getHtmlAttributes() and htmlAttributes() methods must now return attribute arrays that are compatible with craft\helpers\Html::renderTagAttributes().
Element types’ sources() methods’ $context arguments should no longer accept null.
Element types’ tableAttributes() and defineTableAttributes() methods should no longer return a generic attribute for defining the header column heading at the beginning of the returned array. The header column heading is now set to the element type’s display name, per its displayName() method.
Block element types’ getOwner() methods can now return null.
Control panel resource locations are now cached, so resource requests can be resolved when Craft isn’t installed yet, or a database connection can’t be established. (#10642)
Control panel resources are now served with cache headers, if the buildId config setting is set. (#10705)
Empty subfolders within the temporary upload volume are now removed during garbage collection. (#10746)
Most config settings can now be overridden via environment variables. (#10573, #10869)
It’s now possible to configure the Debug Toolbar to store its data files on a filesystem, rather than within storage/runtime/debug/. (#10825)
craft\base\AssetPreviewHandlerInterface::getPreviewHtml() now accepts an optional array of variable to pass on to the template.
craft\base\Element::__get() now clones custom field values before returning them. (#8781)
craft\base\Element::fieldLayoutFields() now has a visibleOnly argument.
craft\base\Element::getFieldValue() now returns eager-loaded element values for the field, when they exist. (#10047)
craft\base\Element::metaFieldsHtml() now has a static argument.
craft\base\Element::setFieldValue() now unsets any previously-eager-loaded elements for the field. (#11003)
craft\base\Element::slugFieldHtml() now has a static argument.
craft\base\ElementInterface::getEagerLoadedElements() now returns an Illuminate\Support\Collection object instead of an array. (#8513)
craft\base\ElementInterface::getSidebarHtml() now has a static argument.
craft\base\MemoizableArray no longer extends ArrayObject, and now implements IteratorAggregate and Countable directly.
craft\base\Model::__construct() and setAttributes() now automatically typecast values that map to properties with int, float, int|float, string, bool, array, or DateTime type declarations. (#10706)
craft\base\Model::datetimeAttributes() is now called from the constructor, instead of the init() method.
craft\base\Model::setAttributes() now normalizes date attributes into DateTime objects.
craft\behaviors\FieldLayoutBehavior::getFields() has been renamed to getCustomFields().
craft\elements\Asset::getImg() now sets the alt attribute to the native Alternative Text field value, if set.
craft\elements\Asset::getVolume() now returns an instance of craft\models\Volume.
craft\elements\db\ElementQuery::ids() no longer accepts an array of criteria params.
craft\events\DraftEvent::$source has been renamed to $canonical.
craft\events\GetAssetThumbUrlEvent has been renamed to DefineAssetThumbUrlEvent.
craft\events\GetAssetUrlEvent has been renamed to DefineAssetUrlEvent.
craft\events\RevisionEvent::$source has been renamed to $canonical.
craft\fieldlayoutelements\AssetTitleField has been renamed to craft\fieldlayoutelements\assets\AssetTitleField.
craft\fieldlayoutelements\EntryTitleField has been renamed to craft\fieldlayoutelements\entries\EntryTitleField.
craft\fieldlayoutelements\StandardField has been renamed to craft\fieldlayoutelements\BaseNativeField.
craft\fieldlayoutelements\StandardTextField has been renamed to craft\fieldlayoutelements\TextField.
craft\fields\Assets::$singleUploadLocationSource has been renamed to $restrictedLocationSource.
craft\fields\Assets::$singleUploadLocationSubpath has been renamed to $restrictedLocationSubpath.
craft\fields\Assets::$useSingleFolder has been renamed to $restrictLocation.
craft\fields\BaseRelationField::$limit has been renamed to $maxRelations.
craft\fields\BaseRelationField::elementType() is now public.
craft\fields\BaseRelationField::inputSelectionCriteria() has been renamed to getInputSelectionCriteria(), and is now public.
craft\fields\BaseRelationField::inputSources() has been renamed to getInputSources(), and is now public.
craft\gql\directives\FormatDateTime::defaultTimezone() has been renamed to defaultTimeZone().
craft\gql\TypeManager::EVENT_DEFINE_GQL_TYPE_FIELDS is now triggered when actually resolving fields for a GraphQL type, rather than when the type is first created. (#9626)
craft\helpers\App::env() now checks for a PHP constant as well, if the environment variable didn’t exist.
craft\helpers\App::env() now returns null if a value couldn’t be found, rather than false.
craft\helpers\App::env() now returns a boolean if the original value was 'true' or 'false'.
craft\helpers\App::env() now returns an integer or float if the original value was numeric.
craft\helpers\ArrayHelper::getValue() now supports keys in square bracket syntax, e.g. foo[bar][baz].
craft\helpers\Assets::generateUrl() no longer accepts a transform index for date modified comparisons. A DateTime object is expected instead.
craft\helpers\Assets::urlAppendix() no longer accepts a transform index for date modified comparisons. A DateTime object is expected instead.
craft\helpers\Component::createComponent() now automatically typecasts values that map to properties with int, float, int|float, string, bool, array, or DateTime type declarations. (#10706)
craft\helpers\Cp::elementHtml() now has an $autoReload argument.
craft\helpers\Db::batchInsert(), craft\helpers\Db::insert(), craft\db\Command::batchInsert(), craft\db\Command::insert(), craft\db\Migration::batchInsert(), and craft\db\Migration::insert() no longer have $includeAuditColumns arguments, and now check if the table has dateCreated, dateUpdated, and/or uid columns before setting their values.
craft\helpers\Db::parseParam() now validates that numeric values are passed if the $columnType is set to a numeric column type. (#9142)
craft\helpers\Db::prepareDateForDb() no longer has a $stripSeconds argument.
craft\helpers\Db::prepareValueForDb() now has a $columnType argument.
craft\helpers\Db::truncateTable() now returns void rather than int.
craft\helpers\Db::update(), craft\helpers\Db::upsert(), craft\db\Command::update(), craft\db\Command::upsert(), craft\db\Migration::update()’ and craft\db\Migration::upsert()’ $includeAuditColumns arguments have been renamed to $updateTimestamp, and only affect the dateCreated column now. All upserts now check if the table has dateCreated, dateUpdated, and/or uid columns before setting their values.
craft\helpers\Db::upsert(), craft\db\Command::upsert(), and craft\db\Migration() no longer merge the $updateColumns array into $insertColumns. The full array of INSERT column values should be passed to $insertColumns now.
craft\helpers\Gql::getUnionType() no longer requires a resolver function to be passed, if the union contains only element GraphQL types.
craft\helpers\Html::beginForm() not sets accept-charset="UTF-8" by default.
craft\helpers\Html now supports defining hx-* and data-hx-* attributes via a hx and data-hx keys, similar to aria and data.
craft\helpers\i18n\Formatter::asPercent() now chooses a default $decimals value based on the value given, if null.
craft\helpers\i18n\Formatter::asPercent() now treats all empty values as 0.
craft\helpers\MailerHelper::normalizeEmails() now returns an empty array instead of null.
craft\helpers\MigrationHelper::dropAllIndexesOnTable() no longer returns an array of the dropped indexes.
craft\helpers\Queue::push() now has a $queue argument.
craft\models\FieldLayout::EVENT_DEFINE_STANDARD_FIELDS has been renamed to EVENT_DEFINE_NATIVE_FIELDS.
craft\models\FieldLayout::getAvailableStandardFields() has been renamed to getAvailableNativeFields().
craft\models\FieldLayout::getFields() has been renamed to getCustomFields().
craft\queue\Queue::$channel is now set automatically based on the queue’s application component ID.
craft\services\Announcements::push() no longer accepts callables to be passed to the $heading and $body arguments. craft\i18n\Translation::prep() should be used to prepare the messages to be lazy-translated instead.
craft\services\AssetIndexer::storeIndexList() now expects the first argument to be a generator that returns craft\models\FsListing objects.
craft\services\Assets::ensureFolderByFullPathAndVolume() now returns a craft\models\VolumeFolder object rather than a folder ID.
craft\services\Assets::ensureTopFolder() now returns a craft\models\VolumeFolder object rather than a folder ID.
craft\services\Assets::EVENT_GET_ASSET_THUMB_URL has been renamed to EVENT_DEFINE_THUMB_URL.
craft\services\Assets::EVENT_GET_ASSET_URL has been moved to craft\elements\Asset::EVENT_DEFINE_URL.
craft\services\AssetTransforms::CONFIG_TRANSFORM_KEY has been moved to craft\services\ProjectConfig::PATH_IMAGE_TRANSFORMS.
craft\services\Categories::CONFIG_CATEGORYROUP_KEY has been moved to craft\services\ProjectConfig::PATH_CATEGORY_GROUPS.
craft\services\Fields::CONFIG_FIELDGROUP_KEY has been moved to craft\services\ProjectConfig::PATH_FIELD_GROUPS.
craft\services\Fields::CONFIG_FIELDS_KEY has been moved to craft\services\ProjectConfig::PATH_FIELDS.
craft\services\Globals::CONFIG_GLOBALSETS_KEY has been moved to craft\services\ProjectConfig::PATH_GLOBAL_SETS.
craft\services\Gql::CONFIG_GQL_KEY has been moved to craft\services\ProjectConfig::PATH_GRAPHQL.
craft\services\Gql::CONFIG_GQL_PUBLIC_TOKEN_KEY has been moved to craft\services\ProjectConfig::PATH_GRAPHQL_PUBLIC_TOKEN.
craft\services\Gql::CONFIG_GQL_SCHEMAS_KEY has been moved to craft\services\ProjectConfig::PATH_GRAPHQL_SCHEMAS.
craft\services\Matrix::CONFIG_BLOCKTYPE_KEY has been moved to craft\services\ProjectConfig::PATH_MATRIX_BLOCK_TYPES.
craft\services\Matrix::duplicateBlocks() now has a $deleteOtherBlocks argument.
craft\services\Plugins::CONFIG_PLUGINS_KEY has been moved to craft\services\ProjectConfig::PATH_PLUGINS.
craft\services\Plugins::doesPluginRequireDatabaseUpdate() has been renamed to isPluginUpdatePending().
craft\services\ProjectConfig::applyYamlChanges() has been renamed to applyExternalChanges().
craft\services\ProjectConfig::getDoesYamlExist() has been renamed to getDoesExternalConfigExist().
craft\services\ProjectConfig::getIsApplyingYamlChanges() has been renamed to getIsApplyingExternalChanges().
craft\services\ProjectConfig::set() now returns true or false depending on whether the project config was modified.
craft\services\Revisions::createRevision() now returns the ID of the revision, rather than the revision itself.
craft\services\Routes::CONFIG_ROUTES_KEY has been moved to craft\services\ProjectConfig::PATH_ROUTES.
craft\services\Sections::CONFIG_ENTRYTYPES_KEY has been moved to craft\services\ProjectConfig::PATH_ENTRY_TYPES.
craft\services\Sections::CONFIG_SECTIONS_KEY has been moved to craft\services\ProjectConfig::PATH_PATH_SECTIONS.
craft\services\Sites::CONFIG_SITEGROUP_KEY has been moved to craft\services\ProjectConfig::PATH_SITE_GROUPS.
craft\services\Sites::CONFIG_SITES_KEY has been moved to craft\services\ProjectConfig::PATH_SITES.
craft\services\Tags::CONFIG_TAGGROUP_KEY has been moved to craft\services\ProjectConfig::PATH_TAG_GROUPS.
craft\services\Updates::getIsCraftDbMigrationNeeded() has been renamed to getIsCraftUpdatePending().
craft\services\Updates::getIsPluginDbUpdateNeeded() has been renamed to getIsPluginUpdatePending().
craft\services\UserGroups::CONFIG_USERPGROUPS_KEY has been moved to craft\services\ProjectConfig::PATH_USER_GROUPS.
craft\services\UserPermissions::getAllPermissions() and getAssignablePermissions() now return permission groups as arrays with heading and permission sub-keys, fixing a bug where two groups with the same heading would conflict with each other. (#7771)
craft\services\Users::CONFIG_USERLAYOUT_KEY has been moved to craft\services\ProjectConfig::PATH_USER_FIELD_LAYOUTS.
craft\services\Users::CONFIG_USERS_KEY has been moved to craft\services\ProjectConfig::PATH_USERS.
craft\services\Volumes::CONFIG_VOLUME_KEY has been moved to craft\services\ProjectConfig::PATH_VOLUMES.
craft\test\fixtures\elements\BaseElementFixture now validates elements with the live scenario if they are enabled, canonical, and not a provisional draft.
craft\test\TestSetup::getMockApp() has been renamed to getMockModule(), and its $appClass argument has been renamed to $moduleClass.
craft\web\Request::getBodyParam() now accepts nested param names in the foo[bar][baz] format.
craft\web\Request::getBodyParams() and getBodyParam() now check for an X-Craft-Namespace header. If present, only params that begin with its value will be returned, excluding the namespace.
craft\web\View::renderString() now has an $escapeHtml argument.
craft\web\View::setNamespace()’ $namespace argument no longer has a default value of null.
The Craft.getUrl() JavaScript method now removes duplicate query string params when passing in a param that’s already included in the base URL.
The Craft.getUrl() JavaScript method now encodes any query string params passed to it.
Craft.broadcastChannel has been split up into two broadcast channels: Craft.broadcaster and Craft.messageReceiver.
Craft.cp.$tabs now returns a collection of the tabs’ <a> elements, as they no longer have wrapping <li> elements.
Local volumes no longer use Flysystem.
A selected volume for user photo storage if no longer displayed if no volume has been set.
The user photo volume can now only be set to a volume that has a public transform filesystem configured.
Craft now uses Symfony Mailer to send email. (#10062)
Updated Twig to 3.3.
Updated vue-autosuggest to 2.2.0.

Deprecated

Deprecated the autosaveDrafts config setting.
Deprecated the anyStatus element query param. status(null) should be used instead.
Deprecated the immediately argument for transforms created over GraphQL. It no longer has any effect.
Deprecated craft\base\ApplicationTrait::getInstalledSchemaVersion().
Deprecated craft\base\Model::datetimeAttributes(). (#10706)
Deprecated craft\elements\User::getFullName(). $fullName should be used instead.
Deprecated craft\gql\TypeManager::flush(). craft\services\Gql::flushCaches() should be used instead.
Deprecated craft\gql\TypeManager::prepareFieldDefinitions(). craft\services\Gql::prepareFieldDefinitions() should be used instead.
Deprecated craft\helpers\ArrayHelper::append(). array_unshift() should be used instead.
Deprecated craft\helpers\ArrayHelper::prepend(). array_push() should be used instead.
Deprecated craft\helpers\MigrationHelper.
Deprecated craft\i18n\I18N::getIsIntlLoaded().
Deprecated craft\services\Assets::getAssetUrl(). craft\elements\Asset::getUrl() should be used instead.
Deprecated craft\services\Assets::getIconPath(). craft\helpers\Assets::iconPath() should be used instead.
Deprecated craft\web\Controller::asErrorJson(). asFailure() should be used instead.
Deprecated the assets/save-asset action. elements/save should be used instead.
Deprecated the categories/save-category action. elements/save should be used instead.
Deprecated the Craft.appendFootHtml() JavaScript method. appendBodyHtml() should be used instead.

Removed

Removed the “Header Column Heading” element source setting.
Removed support for setting custom config settings from config/general.php. config/custom.php should be used instead. (#10012)
Removed the customAsciiCharMappings config setting.
Removed the siteName config setting. Environment-specific site names can be defined via environment variables.
Removed the siteUrl config setting. Environment-specific site URLs can be defined via environment variables.
Removed the suppressTemplateErrors config setting.
Removed the useCompressedJs config setting.
Removed the useProjectConfigFile config setting. Override craft\services\ProjectConfig::$writeYamlAutomatically to opt into manual YAML file generation.
Removed support for config/volumes.php. Volumes can now specify per-environment filesystems.
Removed support for the CRAFT_SITE_URL PHP constant. Environment-specific site URLs can be defined via environment variables.
Removed the enabledForSite GraphQL argument. status should be used instead.
Removed the {% includeHiResCss %} Twig tag.
Removed support for deprecated DateTime faux Twig methods atom(), cookie(), iso8601(), rfc822(), rfc850(), rfc1036(), rfc1123(), rfc2822(), rfc3339(), rss(), w3c(), w3cDate(), mySqlDateTime(), localeDate(), localeTime(), year(), month(), day(), nice(), and uiTimestamp().
Removed the locale element property. siteId should be used instead.
Removed the ownerLocale Matrix block query param. site or siteId should be used instead.
Removed support for sourceLocale in relatedTo element query params. sourceSite should be used instead.
Removed the craft.categoryGroups Twig variable.
Removed the craft.config Twig variable.
Removed the craft.deprecator Twig variable.
Removed the craft.elementIndexes Twig variable.
Removed the craft.emailMessages Twig variable.
Removed the craft.feeds Twig variable.
Removed the craft.fields Twig variable.
Removed the craft.globals Twig variable.
Removed the craft.i18n Twig variable.
Removed the craft.request Twig variable.
Removed the craft.sections Twig variable.
Removed the craft.session Twig variable.
Removed the craft.systemSettings Twig variable.
Removed the craft.userGroups Twig variable.
Removed the craft.userPermissions Twig variable.
Removed the assignUserGroups user permission, which authorized users to assign other users to their own groups. Authorization must now be explicitly granted for each group. (#10422)
Removed the customizeSources user permission. Only admins can customize element sources now, and only from an environment that allows admin changes.
Removed the publishPeerEntryDrafts:<uid> permissions, as they were pointless. (If a user is authorized to save an entry and view other users’ drafts of it, there’s nothing stopping them from making the same changes themselves.)
Removed the assets/edit-asset action.
Removed the assets/thumb action.
Removed the categories/edit-category action.
Removed the categories/preview-category action.
Removed the categories/share-category action.
Removed the categories/view-shared-category action.
Removed the dashboard/get-feed-items action.
Removed the elements/get-editor-html action.
Removed the entries/switch-entry-type action.
Removed craft\base\ApplicationTrait::getEntryRevisions().
Removed craft\base\ApplicationTrait::getFeed().
Removed craft\base\Element::ATTR_STATUS_CONFLICTED.
Removed craft\base\Element::getHasFreshContent(). getIsFresh() should be used instead.
Removed craft\base\ElementInterface::getEditorHtml(). Element edit forms are now exclusively driven by their field layout.
Removed craft\base\FieldLayoutElementInterface.
Removed craft\base\FlysystemVolume.
Removed craft\base\LocalVolumeInterface.
Removed craft\base\Volume.
Removed craft\base\VolumeInterface.
Removed craft\base\VolumeTrait.
Removed craft\behaviors\FieldLayoutBehavior::setFields().
Removed craft\config\DbConfig::updateDsn().
Removed craft\console\Request::getIsSingleActionRequest().
Removed craft\controllers\AssetTransformsController.
Removed craft\controllers\BaseUpdaterController::ACTION_COMPOSER_OPTIMIZE.
Removed craft\controllers\BaseUpdaterController::actionComposerOptimize().
Removed craft\controllers\Drafts.
Removed craft\controllers\ElementIndexesController::$paginated.
Removed craft\controllers\EntriesController::EVENT_PREVIEW_ENTRY.
Removed craft\controllers\UtilitiesController::actionAssetIndexPerformAction().
Removed craft\db\Connection::trimObjectName().
Removed craft\db\Table::ASSETTRANSFORMINDEX.
Removed craft\db\Table::ASSETTRANSFORMS.
Removed craft\elements\actions\SetStatus::$allowDisabledForSite.
Removed craft\elements\actions\SetStatus::DISABLED_FOR_SITE.
Removed craft\elements\actions\SetStatus::DISABLED_GLOBALLY.
Removed craft\elements\Asset::getSupportsPreview().
Removed craft\elements\Asset::getTransformSource().
Removed craft\elements\Asset::setTransformSource().
Removed craft\elements\db\ElementQuery::getIterator().
Removed craft\elements\db\ElementQuery::offsetExists().
Removed craft\elements\db\ElementQuery::offsetGet().
Removed craft\elements\db\ElementQuery::offsetSet().
Removed craft\elements\db\ElementQuery::offsetUnset().
Removed craft\elements\User::mergePreferences().
Removed craft\errors\AssetTransformException.
Removed craft\errors\FieldNotFoundException.
Removed craft\errors\InvalidVolumeException.
Removed craft\errors\MissingVolumeFolderException.
Removed craft\errors\VolumeException.
Removed craft\errors\VolumeObjectExistsException.
Removed craft\errors\VolumeObjectNotFoundException.
Removed craft\events\AssetTransformEvent.
Removed craft\events\AssetTransformImageEvent.
Removed craft\events\DefineComponentsEvent.
Removed craft\events\GenerateTransformEvent::$image.
Removed craft\events\GenerateTransformEvent::$tempPath.
Removed craft\events\GetAssetThumbEvent.
Removed craft\events\GetAssetThumbUrlEvent::$generate.
Removed craft\events\GetAssetThumbUrlEvent::$size.
Removed craft\events\GlobalSetContentEvent.
Removed craft\events\RegisterGqlPermissionsEvent.
Removed craft\events\SearchEvent::getElementIds().
Removed craft\events\SearchEvent::setElementIds().
Removed craft\feeds\Feeds.
Removed craft\feeds\GuzzleClient.
Removed craft\fields\BaseOptionsField::optionLabel().
Removed craft\fields\Url::$placeholder.
Removed craft\gql\base\Resolver::extractEagerLoadCondition().
Removed craft\gql\base\Resolver::getArrayableArguments().
Removed craft\gql\base\Resolver::prepareArguments().
Removed craft\helpers\App::dbMutexConfig().
Removed craft\helpers\App::getDefaultLogTargets().
Removed craft\helpers\App::logConfig().
Removed craft\helpers\Cp::editElementTitles().
Removed craft\helpers\Localization::localeData().
Removed craft\helpers\Stringy.
Removed craft\i18n\Locale::setDateTimeFormats().
Removed craft\log\FileTarget.
Removed craft\log\StreamLogTarget.
Removed craft\models\AssetTransform.
Removed craft\models\AssetTransformIndex.
Removed craft\models\BaseEntryRevisionModel.
Removed craft\models\EntryDraft.
Removed craft\models\EntryVersion.
Removed craft\models\FieldLayout::setFields().
Removed craft\models\FieldLayoutTab::getFields().
Removed craft\models\Site::$originalBaseUrl.
Removed craft\models\Site::$originalName.
Removed craft\models\Site::overrideBaseUrl().
Removed craft\models\Site::overrideName().
Removed craft\models\VolumeListing.
Removed craft\mutex\DbMutexTrait.
Removed craft\mutex\FileMutex.
Removed craft\mutex\MysqlMutex.
Removed craft\mutex\PgsqlMutex.
Removed craft\mutex\PrefixedMutexTrait.
Removed craft\queue\jobs\DeleteStaleTemplateCaches.
Removed craft\records\AssetTransform.
Removed craft\records\MatrixBlockType::$validateUniques.
Removed craft\services\AssetIndexer::deleteStaleIndexingData().
Removed craft\services\AssetIndexer::extractFolderItemsFromIndexList().
Removed craft\services\AssetIndexer::extractSkippedItemsFromIndexList().
Removed craft\services\AssetIndexer::getIndexingSessionId().
Removed craft\services\AssetIndexer::getMissingFiles().
Removed craft\services\AssetIndexer::prepareIndexList().
Removed craft\services\AssetIndexer::processIndexForVolume().
Removed craft\services\Assets::$generatePendingTransformsViaQueue.
Removed craft\services\Assets::EVENT_GET_ASSET_THUMB_URL.
Removed craft\services\Assets::EVENT_GET_THUMB_PATH.
Removed craft\services\Assets::getThumbPath().
Removed craft\services\AssetTransforms.
Removed craft\services\Composer::$disablePackagist.
Removed craft\services\Composer::optimize().
Removed craft\services\Content::getContentRow().
Removed craft\services\Content::populateElementContent().
Removed craft\services\Drafts::EVENT_AFTER_MERGE_SOURCE_CHANGES.
Removed craft\services\Drafts::EVENT_AFTER_PUBLISH_DRAFT.
Removed craft\services\Drafts::EVENT_BEFORE_MERGE_SOURCE_CHANGES.
Removed craft\services\Drafts::EVENT_BEFORE_PUBLISH_DRAFT.
Removed craft\services\Drafts::publishDraft().
Removed craft\services\EntryRevisions.
Removed craft\services\Fields::assembleLayout().
Removed craft\services\Fields::getFieldIdsByLayoutId().
Removed craft\services\Fields::getFieldsByElementType().
Removed craft\services\Fields::getFieldsByLayoutId().
Removed craft\services\Gql::getAllPermissions().
Removed craft\services\Path::getAssetThumbsPath().
Removed craft\services\ProjectConfig::CONFIG_ALL_KEY.
Removed craft\services\ProjectConfig::CONFIG_ALL_KEY.
Removed craft\services\ProjectConfig::CONFIG_KEY.
Removed craft\services\Sections::isSectionTemplateValid().
Removed craft\services\SystemSettings.
Removed craft\services\TemplateCaches::deleteCacheById().
Removed craft\services\TemplateCaches::deleteCachesByKey().
Removed craft\services\TemplateCaches::deleteExpiredCaches().
Removed craft\services\TemplateCaches::deleteExpiredCachesIfOverdue().
Removed craft\services\TemplateCaches::EVENT_AFTER_DELETE_CACHES.
Removed craft\services\TemplateCaches::EVENT_BEFORE_DELETE_CACHES.
Removed craft\services\TemplateCaches::handleResponse().
Removed craft\services\TemplateCaches::handleResponse().
Removed craft\services\TemplateCaches::includeElementInTemplateCaches().
Removed craft\services\TemplateCaches::includeElementQueryInTemplateCaches().
Removed craft\services\Volumes::createVolume().
Removed craft\services\Volumes::EVENT_REGISTER_VOLUME_TYPES.
Removed craft\services\Volumes::getAllVolumeTypes().
Removed craft\services\Volumes::getVolumeOverrides().
Removed craft\volumes\Local.
Removed craft\volumes\MissingVolume.
Removed craft\volumes\Temp.
Removed craft\web\AssetBundle::useCompressedJs().
Removed craft\web\AssetManager::getPublishedPath().
Removed craft\web\Request::getIsSingleActionRequest().
Removed craft\web\twig\Template.
Removed craft\web\twig\variables\CategoryGroups.
Removed craft\web\twig\variables\Config.
Removed craft\web\twig\variables\Deprecator.
Removed craft\web\twig\variables\ElementIndexes.
Removed craft\web\twig\variables\EmailMessages.
Removed craft\web\twig\variables\Feeds.
Removed craft\web\twig\variables\Fields.
Removed craft\web\twig\variables\Globals.
Removed craft\web\twig\variables\I18N.
Removed craft\web\twig\variables\Request.
Removed craft\web\twig\variables\Sections.
Removed craft\web\twig\variables\SystemSettings.
Removed craft\web\twig\variables\UserGroups.
Removed craft\web\twig\variables\UserPermissions.
Removed craft\web\twig\variables\UserSession.
Removed craft\web\User::destroyDebugPreferencesInSession().
Removed craft\web\User::saveDebugPreferencesToSession().
Removed craft\web\View::$minifyCss.
Removed craft\web\View::$minifyJs.
Removed craft\web\View::registerHiResCss().
Removed craft\web\View::renderTemplateMacro().
Removed the _layouts/element control panel template.
Removed the assets/_edit control panel template.
Removed the categories/_edit control panel template.
Removed the entries/_edit control panel template.
Removed the cp.assets.edit.content control panel template hook.
Removed the cp.assets.edit.details control panel template hook.
Removed the cp.assets.edit.meta control panel template hook.
Removed the cp.assets.edit.settings control panel template hook.
Removed the cp.assets.edit control panel template hook.
Removed the cp.categories.edit.content control panel template hook.
Removed the cp.categories.edit.details control panel template hook.
Removed the cp.categories.edit.meta control panel template hook.
Removed the cp.categories.edit.settings control panel template hook.
Removed the cp.categories.edit control panel template hook.
Removed the cp.elements.edit control panel template hook.
Removed the cp.entries.edit.content control panel template hook.
Removed the cp.entries.edit.details control panel template hook.
Removed the cp.entries.edit.meta control panel template hook.
Removed the cp.entries.edit.settings control panel template hook.
Removed the cp.entries.edit control panel template hook.
Removed the Craft.AssetEditor JavaScript class.
Removed the Craft.BaseElementEditor JavaScript class.
Removed the Craft.DraftEditor JavaScript class.
Removed the Craft.queueActionRequest() JavaScript method. Craft.queue.push() can be used instead.
Removed the Flysystem package. The craftcms/flysystem-adapter package now provides a base Flysystem adapter class.
Removed the laminas-feed package.
Removed the yii2-swiftmailer package.

Fixed

Fixed a bug where pending project config changes in the YAML would get applied when other project config changes were made. (#9660)
Fixed a bug where revisions weren’t getting propagated when a section was enabled for new sites, or its Propagation Method was changed. (#10634)

Security

Generated control panel URLs now begin with the @web alias value if the baseCpUrl config setting isn’t defined.
HTML entities output within email body text are now escaped by default in HTML email bodies.

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Release Notes for Craft CMS 4

Unreleased

4.4.11 - 2023-05-15

4.4.10.1 - 2023-05-10

4.4.10 - 2023-05-09

4.4.9 - 2023-05-02

4.4.8 - 2023-04-25

4.4.7.1 - 2023-04-15

4.4.7 - 2023-04-11

4.4.6.1 - 2023-04-04

4.4.6 - 2023-04-04

4.4.5 - 2023-03-21

4.4.4 - 2023-03-20

4.4.3 - 2023-03-16

4.4.2 - 2023-03-14

4.4.1 - 2023-03-09

4.4.0 - 2023-03-08

Content Management

Accessibility

Administration

Development

Extensibility

System

4.3.11 - 2023-03-07

4.3.10 - 2023-02-17

4.3.9 - 2023-02-14

4.3.8.2 - 2023-02-08

4.3.8.1 - 2023-02-08

4.3.8 - 2023-02-07

4.3.7.1 - 2023-02-05

4.3.7 - 2023-02-03

4.3.6.1 - 2023-01-09

4.3.6 - 2023-01-04

4.3.5 - 2022-12-13

4.3.4 - 2022-11-29

4.3.3 - 2022-11-17

4.3.2.1 - 2022-11-16

4.3.2 - 2022-11-16

4.3.1 - 2022-10-27

4.3.0 - 2022-10-25

Content Management

Accessibility

Administration

Development

Extensibility

System

4.2.8 - 2022-10-18

Changed

Fixed

4.2.7 - 2022-10-11

Added

Changed

4.2.6 - 2022-10-11

Added

Changed

Deprecated

Fixed

Security

4.2.5.2 - 2022-10-03

Security

4.2.5.1 - 2022-09-21

Fixed

4.2.5 - 2022-09-20

Added

Changed

Removed

Fixed

4.2.4 - 2022-09-13

Changed

Fixed

Security

4.2.3 - 2022-08-26

Changed

Fixed