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
, andfullName
user query params. - β Added the
primaryOwner
andprimaryOwnerId
Matrix block query params. - β Added the
hasAlt
asset query param. - β Added the
button
,submitButton
,fs
,fsField
,volume
, andvolumeField
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 viaCraft::$app->config->custom
. (#10012) - β Added the
addresses
,address
, andaddressCount
GraphQL queries. - β Added the
hasAlt
argument to asset GraphQL queries. - β Added the
alt
field to assets queried via GraphQL. - β Added the
fullName
,assetUploaders
, andauthors
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 replacesgetElementIndexes()
. - β Added
craft\base\ApplicationTrait::getFs()
. - β Added
craft\base\ApplicationTrait::getImageTransforms()
, which replacesgetAssetTransforms()
. - β 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 anIlluminate\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()
andsetLayout()
. - β Added
craft\models\FieldLayoutForm::getVisibleElements()
. - β Added
craft\models\FieldLayoutFormTab::getTabId()
. - β Added
craft\models\FieldLayoutFormTab::getUid()
. - β Added
craft\models\FieldLayoutTab::getElements()
andsetElements()
. - β 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 replacescraft\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-deprecatedappendFootHtml()
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
andsort
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
, andlocked
statuses no longer excludes suspended users. credentialed
andinactive
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 ofcraft\models\UserGroup
objects. - Element queriesβ
revision
params can now be set tonull
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()
, orone()
to fetch the results before working with them. - Element queriesβ
title
params no longer treat values with commas as arrays. (#10891) - π User queriesβ
firstName
andlastName
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
andsubRight
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
orinfo
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 orinfo
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 theenabled
andsiteId
parameters. (#9771) - π The
forms/selectize
control panel template now supportsaddOptionFn
andaddOptionLabel
params, which can be set to add new options to the list. - π Editable tables now support
allowAdd
,allowDelete
, andallowReorder
settings, replacingstaticRows
. (#10163) - Column definitions passed to the
_includes/forms/editableTable
control panel template can now specify awidth
key. (#11062) - The
limitField
macro in the_components/fieldtypes/elementfieldsettings
control panel template has been renamed tolimitFields
. - π Renamed the
elements/get-categories-input-html
action tocategories/input-html
. - π Renamed the
elements/get-modal-body
action toelement-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 aunverifiedEmail
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/*
, andhelp
actions no longer output a warning if Craft canβt connect to the database. (#10851)createFoldersInVolume:<uid>
user permissions have been renamed tocreateFolders:<uid>
.- π±
deleteFilesAndFoldersInVolume:<uid>
user permissions have been renamed todeleteAssets:<uid>
. - π±
deletePeerFilesInVolume:<uid>
user permissions have been renamed todeletePeerAssets:<uid>
. editCategories:<uid>
user permissions have been split intoviewCategories:<uid>
,saveCategories:<uid>
,deleteCategories:<uid>
,viewPeerCategoryDrafts:<uid>
,savePeerCategoryDrafts:<uid>
, anddeletePeerCategoryDrafts:<uid>
.editEntries:<uid>
user permissions have been renamed toviewEntries:<uid>
.editImagesInVolume:<uid>
user permissions have been renamed toeditImages:<uid>
.editPeerEntries:<uid>
user permissions have been renamed toviewPeerEntries:<uid>
.editPeerEntryDrafts:<uid>
user permissions have been split intoviewPeerEntryDrafts:<uid>
andsavePeerEntryDrafts:<uid>
.- π±
editPeerFilesInVolume:<uid>
user permissions have been renamed tosavePeerAssets:<uid>
. editPeerImagesInVolume:<uid>
user permissions have been renamed toeditPeerImages:<uid>
.publishEntries:<uid>
user permissions have been renamed tosaveEntries:<uid>
, and no longer differentiate between enabled and disabled entries. (Users withviewEntries:<uid>
permissions will still be able to create drafts.)publishPeerEntries:<uid>
user permissions have been renamed tosavePeerEntries:<uid>
, and no longer differentiate between enabled and disabled entries. (Users withviewPeerEntries:<uid>
permissions will still be able to create drafts.)replaceFilesInVolume:<uid>
user permissions have been renamed toreplaceFiles:<uid>
.replacePeerFilesInVolume:<uid>
user permissions have been renamed toreplacePeerFiles:<uid>
.- π±
saveAssetInVolume:<uid>
user permissions have been renamed tosaveAssets:<uid>
. - π±
viewPeerFilesInVolume:<uid>
user permissions have been renamed toviewPeerAssets:<uid>
. - π±
viewVolume:<uid>
user permissions have been renamed toviewAssets:<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 asite
param; one will be added automatically bycraft\base\Element::getCpEditUrl()
. - Element typesβ
defineActions()
methodsβ$source
arguments should no longer acceptnull
. - Element typesβ
defineSources()
methodsβ$context
arguments should no longer acceptnull
. - Element typesβ
getHtmlAttributes()
andhtmlAttributes()
methods must now return attribute arrays that are compatible withcraft\helpers\Html::renderTagAttributes()
. - Element typesβ
sources()
methodsβ$context
arguments should no longer acceptnull
. - Element typesβ
tableAttributes()
anddefineTableAttributes()
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 itsdisplayName()
method. - Block element typesβ
getOwner()
methods can now returnnull
. - 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 avisibleOnly
argument.craft\base\Element::getFieldValue()
now returns eager-loaded element values for the field, when they exist. (#10047)craft\base\Element::metaFieldsHtml()
now has astatic
argument.craft\base\Element::setFieldValue()
now unsets any previously-eager-loaded elements for the field. (#11003)craft\base\Element::slugFieldHtml()
now has astatic
argument.- π
craft\base\ElementInterface::getEagerLoadedElements()
now returns anIlluminate\Support\Collection
object instead of an array. (#8513) craft\base\ElementInterface::getSidebarHtml()
now has astatic
argument.craft\base\MemoizableArray
no longer extendsArrayObject
, and now implementsIteratorAggregate
andCountable
directly.craft\base\Model::__construct()
andsetAttributes()
now automatically typecast values that map to properties withint
,float
,int|float
,string
,bool
,array
, orDateTime
type declarations. (#10706)craft\base\Model::datetimeAttributes()
is now called from the constructor, instead of theinit()
method.craft\base\Model::setAttributes()
now normalizes date attributes intoDateTime
objects.craft\behaviors\FieldLayoutBehavior::getFields()
has been renamed togetCustomFields()
.craft\elements\Asset::getImg()
now sets thealt
attribute to the native Alternative Text field value, if set.craft\elements\Asset::getVolume()
now returns an instance ofcraft\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 toDefineAssetThumbUrlEvent
.craft\events\GetAssetUrlEvent
has been renamed toDefineAssetUrlEvent
.craft\events\RevisionEvent::$source
has been renamed to$canonical
.- π±
craft\fieldlayoutelements\AssetTitleField
has been renamed tocraft\fieldlayoutelements\assets\AssetTitleField
. craft\fieldlayoutelements\EntryTitleField
has been renamed tocraft\fieldlayoutelements\entries\EntryTitleField
.craft\fieldlayoutelements\StandardField
has been renamed tocraft\fieldlayoutelements\BaseNativeField
.craft\fieldlayoutelements\StandardTextField
has been renamed tocraft\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 togetInputSelectionCriteria()
, and is now public.craft\fields\BaseRelationField::inputSources()
has been renamed togetInputSources()
, and is now public.- 0οΈβ£
craft\gql\directives\FormatDateTime::defaultTimezone()
has been renamed todefaultTimeZone()
. 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 returnsnull
if a value couldnβt be found, rather thanfalse
.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. ADateTime
object is expected instead. - π±
craft\helpers\Assets::urlAppendix()
no longer accepts a transform index for date modified comparisons. ADateTime
object is expected instead. craft\helpers\Component::createComponent()
now automatically typecasts values that map to properties withint
,float
,int|float
,string
,bool
,array
, orDateTime
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()
, andcraft\db\Migration::insert()
no longer have$includeAuditColumns
arguments, and now check if the table hasdateCreated
,dateUpdated
, and/oruid
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 returnsvoid
rather thanint
.- β‘οΈ
craft\helpers\Db::update()
,craft\helpers\Db::upsert()
,craft\db\Command::update()
,craft\db\Command::upsert()
,craft\db\Migration::update()
β andcraft\db\Migration::upsert()
β$includeAuditColumns
arguments have been renamed to$updateTimestamp
, and only affect thedateCreated
column now. All upserts now check if the table hasdateCreated
,dateUpdated
, and/oruid
columns before setting their values. - β‘οΈ
craft\helpers\Db::upsert()
,craft\db\Command::upsert()
, andcraft\db\Migration()
no longer merge the$updateColumns
array into$insertColumns
. The full array ofINSERT
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 setsaccept-charset="UTF-8"
by default. craft\helpers\Html
now supports defininghx-*
anddata-hx-*
attributes via ahx
anddata-hx
keys, similar toaria
anddata
.- 0οΈβ£
craft\helpers\i18n\Formatter::asPercent()
now chooses a default$decimals
value based on the value given, ifnull
. craft\helpers\i18n\Formatter::asPercent()
now treats all empty values as0
.craft\helpers\MailerHelper::normalizeEmails()
now returns an empty array instead ofnull
.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 toEVENT_DEFINE_NATIVE_FIELDS
.craft\models\FieldLayout::getAvailableStandardFields()
has been renamed togetAvailableNativeFields()
.craft\models\FieldLayout::getFields()
has been renamed togetCustomFields()
.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 returnscraft\models\FsListing
objects.- π±
craft\services\Assets::ensureFolderByFullPathAndVolume()
now returns acraft\models\VolumeFolder
object rather than a folder ID. - π±
craft\services\Assets::ensureTopFolder()
now returns acraft\models\VolumeFolder
object rather than a folder ID. craft\services\Assets::EVENT_GET_ASSET_THUMB_URL
has been renamed toEVENT_DEFINE_THUMB_URL
.craft\services\Assets::EVENT_GET_ASSET_URL
has been moved tocraft\elements\Asset::EVENT_DEFINE_URL
.craft\services\AssetTransforms::CONFIG_TRANSFORM_KEY
has been moved tocraft\services\ProjectConfig::PATH_IMAGE_TRANSFORMS
.craft\services\Categories::CONFIG_CATEGORYROUP_KEY
has been moved tocraft\services\ProjectConfig::PATH_CATEGORY_GROUPS
.craft\services\Fields::CONFIG_FIELDGROUP_KEY
has been moved tocraft\services\ProjectConfig::PATH_FIELD_GROUPS
.craft\services\Fields::CONFIG_FIELDS_KEY
has been moved tocraft\services\ProjectConfig::PATH_FIELDS
.craft\services\Globals::CONFIG_GLOBALSETS_KEY
has been moved tocraft\services\ProjectConfig::PATH_GLOBAL_SETS
.craft\services\Gql::CONFIG_GQL_KEY
has been moved tocraft\services\ProjectConfig::PATH_GRAPHQL
.craft\services\Gql::CONFIG_GQL_PUBLIC_TOKEN_KEY
has been moved tocraft\services\ProjectConfig::PATH_GRAPHQL_PUBLIC_TOKEN
.craft\services\Gql::CONFIG_GQL_SCHEMAS_KEY
has been moved tocraft\services\ProjectConfig::PATH_GRAPHQL_SCHEMAS
.craft\services\Matrix::CONFIG_BLOCKTYPE_KEY
has been moved tocraft\services\ProjectConfig::PATH_MATRIX_BLOCK_TYPES
.craft\services\Matrix::duplicateBlocks()
now has a$deleteOtherBlocks
argument.- π
craft\services\Plugins::CONFIG_PLUGINS_KEY
has been moved tocraft\services\ProjectConfig::PATH_PLUGINS
. - β‘οΈ
craft\services\Plugins::doesPluginRequireDatabaseUpdate()
has been renamed toisPluginUpdatePending()
. craft\services\ProjectConfig::applyYamlChanges()
has been renamed toapplyExternalChanges()
.craft\services\ProjectConfig::getDoesYamlExist()
has been renamed togetDoesExternalConfigExist()
.craft\services\ProjectConfig::getIsApplyingYamlChanges()
has been renamed togetIsApplyingExternalChanges()
.craft\services\ProjectConfig::set()
now returnstrue
orfalse
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 tocraft\services\ProjectConfig::PATH_ROUTES
.craft\services\Sections::CONFIG_ENTRYTYPES_KEY
has been moved tocraft\services\ProjectConfig::PATH_ENTRY_TYPES
.craft\services\Sections::CONFIG_SECTIONS_KEY
has been moved tocraft\services\ProjectConfig::PATH_PATH_SECTIONS
.craft\services\Sites::CONFIG_SITEGROUP_KEY
has been moved tocraft\services\ProjectConfig::PATH_SITE_GROUPS
.craft\services\Sites::CONFIG_SITES_KEY
has been moved tocraft\services\ProjectConfig::PATH_SITES
.- π·
craft\services\Tags::CONFIG_TAGGROUP_KEY
has been moved tocraft\services\ProjectConfig::PATH_TAG_GROUPS
. - β‘οΈ
craft\services\Updates::getIsCraftDbMigrationNeeded()
has been renamed togetIsCraftUpdatePending()
. - β‘οΈ
craft\services\Updates::getIsPluginDbUpdateNeeded()
has been renamed togetIsPluginUpdatePending()
. - π
craft\services\UserGroups::CONFIG_USERPGROUPS_KEY
has been moved tocraft\services\ProjectConfig::PATH_USER_GROUPS
. craft\services\UserPermissions::getAllPermissions()
andgetAssignablePermissions()
now return permission groups as arrays withheading
andpermission
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 tocraft\services\ProjectConfig::PATH_USER_FIELD_LAYOUTS
. - π
craft\services\Users::CONFIG_USERS_KEY
has been moved tocraft\services\ProjectConfig::PATH_USERS
. craft\services\Volumes::CONFIG_VOLUME_KEY
has been moved tocraft\services\ProjectConfig::PATH_VOLUMES
.- π
craft\test\fixtures\elements\BaseElementFixture
now validates elements with thelive
scenario if they are enabled, canonical, and not a provisional draft. - β
craft\test\TestSetup::getMockApp()
has been renamed togetMockModule()
, and its$appClass
argument has been renamed to$moduleClass
. - π
craft\web\Request::getBodyParam()
now accepts nested param names in thefoo[bar][baz]
format. - π
craft\web\Request::getBodyParams()
andgetBodyParam()
now check for anX-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 ofnull
. - π 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
andCraft.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. Overridecraft\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 methodsatom()
,cookie()
,iso8601()
,rfc822()
,rfc850()
,rfc1036()
,rfc1123()
,rfc2822()
,rfc3339()
,rss()
,w3c()
,w3cDate()
,mySqlDateTime()
,localeDate()
,localeTime()
,year()
,month()
,day()
,nice()
, anduiTimestamp()
. - β Removed the
locale
element property.siteId
should be used instead. - β Removed the
ownerLocale
Matrix block query param.site
orsiteId
should be used instead. - β Removed support for
sourceLocale
inrelatedTo
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 thebaseCpUrl
config setting isnβt defined. - 0οΈβ£ HTML entities output within email body text are now escaped by default in HTML email bodies.