CraftCMS v4.0.0 Release Notes

Release Date: 2022-05-04 // about 2 years ago
  • βž• 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)
    • 0️⃣ 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.
    • 0️⃣ 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)
    • 0️⃣ 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)
    • 0️⃣ 404 requests are no longer logged by default. (#10659)
    • 0️⃣ 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)
    • 0️⃣ 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.
    • 0️⃣ 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.
    • 0️⃣ 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.
    • 0️⃣ 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.
    • 0️⃣ 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.
    • 0️⃣ HTML entities output within email body text are now escaped by default in HTML email bodies.