{warning} If you have a custom session driver, make sure you update it for Yii 2.0.29 compatibility.
- Craft now requires PHP 7.2.5 or later.
- Entries now begin life as “unpublished drafts” rather than “unsaved drafts”. They are no longer ephemeral; they will continue to exist until explicitly published or deleted. (#5661, #7216)
- It’s now possible to delete entries for a specific site, if their section’s propagation method is set to “Let each entry choose which sites it should be saved to”. (#7190)
- Added the “Copy impersonation URL” user action, which generates a URL that can be pasted into a private window to impersonate the user without losing the current session. (#7281)
- User indexes can now include a “Groups” column. (#7211)
- Volumes now have “Title Translation Method” and “Title Translation Key Format” settings, like entry types. (#7135)
- It’s now possible to set sites’ Name settings to environment variables.
- Added the
users/list-admins
andusers/set-password
commands. (#7067) - Added the
disableGraphqlTransformDirective
config setting. (#6466) - Added the
enableGraphqlIntrospection
config setting. (#6466) - Added the
maxGraphqlComplexity
config setting. (#6466) - Added the
maxGraphqlDepth
config setting. (#6466) - Added the
maxGraphqlResults
config setting. (#6466) - Added the
rasterizeSvgThumbs
config setting. (#7146) - Added the
{% tag %}
Twig tag. - Added the
withGroups
user query param. - Added the
relatedToAssets
,relatedToCategories
,relatedToEntries
,relatedToTags
, andrelatedToUsers
arguments to GraphQL queries. (#7110) - Added the
isUnpublishedDraft
GraphQL field. - Added
craft\base\ElementExporterInterface::isFormattable()
. - Added
craft\base\ElementInterface::getIsUnpublishedDraft()
. - Added
craft\base\FieldInterface::includeInGqlSchema()
. (#7244) - Added
craft\base\VolumeTrait::$titleTranslationKeyFormat
. - Added
craft\base\VolumeTrait::$titleTranslationMethod
. - Added
craft\console\Controller::passwordPrompt()
. - Added
craft\console\Request::getHadToken()
. - Added
craft\console\Request::getSiteToken()
. - Added
craft\console\Request::setToken()
. - Added
craft\controllers\BaseEntriesController::enforceDeleteEntryPermissions()
. - Added
craft\elements\db\ElementQueryInterface::afterPopulate()
. - Added
craft\elements\db\ElementQueryInterface::createElement()
. - Added
craft\elements\Entry::EVENT_DEFINE_ENTRY_TYPES
. (#7136) - Added
craft\elements\Entry::getAvailableEntryTypes()
. - Added
craft\events\CreateFieldLayoutFormEvent
. - Added
craft\events\DefineEntryTypesEvent
. - Added
craft\events\RegisterGqlArgumentHandlersEvent
. - Added
craft\events\SearchEvent::$results
. (#7237) - Added
craft\fieldlayoutelements\AssetTitleField
. - Added
craft\gql\ArgumentManager
. - Added
craft\gql\base\ArgumentHandler
. - Added
craft\gql\base\ArgumentHandlerInterface
. - Added
craft\gql\base\Generator
. - Added
craft\gql\base\RelationArgumentHandler
. - Added
craft\gql\ElementQueryConditionBuilder::setArgumentManager()
. - Added
craft\gql\handlers\RelatedAssets
. - Added
craft\gql\handlers\RelatedCategories
. - Added
craft\gql\handlers\RelatedEntries
. - Added
craft\gql\handlers\RelatedTags
. - Added
craft\gql\handlers\RelatedUsers
. - Added
craft\gql\types\input\criteria\Asset
. - Added
craft\gql\types\input\criteria\Category
. - Added
craft\gql\types\input\criteria\Entry
. - Added
craft\gql\types\input\criteria\Tag
. - Added
craft\gql\types\input\criteria\User
. - Added
craft\helpers\App::phpSizeToBytes()
. - Added
craft\helpers\Cp::checkboxFieldHtml()
. - Added
craft\helpers\Cp::colorFieldHtml()
. - Added
craft\helpers\Cp::editableTableFieldHtml()
. - Added
craft\helpers\Cp::lightswitchFieldHtml()
. - Added
craft\helpers\Cp::renderTemplate()
. - Added
craft\helpers\Cp::selectFieldHtml()
. - Added
craft\helpers\Cp::textareaFieldHtml()
. - Added
craft\helpers\Cp::textFieldHtml()
. - Added
craft\helpers\Diff
. - Added
craft\helpers\Gql::eagerLoadComplexity()
. - Added
craft\helpers\Gql::nPlus1Complexity()
. - Added
craft\helpers\Gql::singleQueryComplexity()
. - Added
craft\log\Dispatcher
. - Added
craft\models\FieldLayout::EVENT_CREATE_FORM
. (#7258) - Added
craft\models\Site::getName()
. - Added
craft\models\Site::setBaseUrl()
. - Added
craft\models\Site::setName()
. - Added
craft\services\Drafts::EVENT_AFTER_APPLY_DRAFT
. - Added
craft\services\Drafts::EVENT_BEFORE_APPLY_DRAFT
. - Added
craft\services\Drafts::publishDraft()
. - Added
craft\services\Globals::deleteSet()
. - Added
craft\services\Globals::reset()
. - Added
craft\services\Gql::GRAPHQL_COMPLEXITY_CPU_HEAVY
. - Added
craft\services\Gql::GRAPHQL_COMPLEXITY_EAGER_LOAD
. - Added
craft\services\Gql::GRAPHQL_COMPLEXITY_NPLUS1
. - Added
craft\services\Gql::GRAPHQL_COMPLEXITY_QUERY
. - Added
craft\services\Gql::GRAPHQL_COMPLEXITY_SIMPLE_FIELD
. - Added
craft\test\ActiveFixture
. - Added
craft\test\DbFixtureTrait
. - Added
craft\test\fixtures\elements\BaseElementFixture
. - Added
craft\test\TestSetup::SITE_URL
. - Added
craft\web\Request::getHadToken()
. - Added
craft\web\Request::getSiteToken()
. - Added
craft\web\Request::setToken()
. - Added the
Craft.index()
JavaScript method.
- Renamed the
backup
andrestore
commands todb/backup
anddb/restore
. (#7023) - Relational fields now include all related elements’ titles as search keywords, including disabled elements. (#7079)
- Improved the performance of project config change diffs. (#7218)
- Improved the accessibility of info icons.
- The Settings → Plugin page now shows which developer created each plugin. (#7254)
- Site URLs that are generated on the front-end of disabled sites now include the
siteToken
param, if one was passed to the current page. (#7264) - The
withoutKey
Twig filter can now accept an array, for removing multiple keys at once. (#7230) - It’s now possible to add new log targets by overriding
components.log.targets
inconfig/app.php
, rather than the entirelog
component config. - The
_includes/forms/field.html
control panel template andcraft\helpers\Cp::fieldHtml()
now accept afieldset
variable/config key, which can be set totrue
to cause the resulting field to be a<fieldset>
instead of a<div>
, and the label to be a<legend>
instead of a<label>
. - The
_includes/forms/field.html
control panel template andcraft\helpers\Cp::fieldHtml()
now accept aninstructionsPosition
variable/config key, which can be set to'after'
to cause the field instructions to be rerdered after the input instead of before. - The
_includes/forms/field.html
control panel template andcraft\helpers\Cp::fieldHtml()
now accept afieldLabel
variable/config key, which will take precedence overlabel
. - The
checkboxField
macro within the_includes/forms.html
control panel template now returns a<fieldset>
if afieldLabel
config key was passed. craft\base\ElementExporterInterface::export()
can now return raw response data, or a resource, ifisFormattable()
returnsfalse
. If a resource is returned, it will be streamed to the browser. (#7148)craft\behaviors\EnvAttributeParserBehavior::$attributes
can now be set to an array with key/value pairs, where the key is the attribute name, and the value is the raw (unparsed) value, or a callable that returns the raw value.craft\behaviors\EnvAttributeParserBehavior::$attributes
can now be set to an array with key/value pairs, where the key is the attribute name, and the value is the raw (unparsed) value, or a callable that returns the raw value.craft\db\Connection::getPrimaryKeyName()
,getForeignKeyName()
, andgetIndexName()
now generate completely random object names, rather than basing them on a table name, etc. (#7153)craft\helpers\Cp::fieldHtml()
now accepts a control panel template path, prefixed withtemplate:
.craft\helpers\Gql::isSchemaAwareOf()
,extractAllowedEntitiesFromSchema()
,canSchema()
,extractEntityAllowedActions()
,canMutateEntries()
,canMutateTags()
,canMutateGlobalSets()
,canMutateCategories()
,canMutateAssets()
,canQueryEntries()
,canQueryAssets()
,canQueryCategories()
,canQueryTags()
,canQueryGlobalSets()
, andcanQueryUsers()
now have$schema
arguments.craft\models\Site::$baseUrl
is now a magic property, which returns the parsed base URL. (#3964)craft\models\Site::$name
is now a magic property, which returns the parsed site name. (#3964)craft\models\Site::getBaseUrl()
now has a$parse
argument, which can be set tofalse
to return the raw (unparsed) base URL.craft\services\Composer::install()
no longer has an$allowlist
argument.craft\services\Gql::getValidationRules()
now has an$isIntrospectionQuery
argument.- Craft no longer reports PHP deprecation errors.
- GraphQL queries now support eager-loading for arguments provided as input objects.
- Updated Yii to 2.0.39.
- Updated Guzzle to 7.x, for projects that don’t have any plugins that require Guzzle 6. (#6997)
- Updated Composer to 2.0.7.
- Updated LitEmoji to 2.x.
- Updated the Symfony Yaml component to 5.x.
- Updated webonyx/graphql-php to 14.x.
- Deprecated the
backup
andrestore
commands. - Deprecated the
purgeUnsavedDraftsDuration
config setting. - Deprecated the
siteName
config setting. Sites’ Name settings should be set to environment variables instead. - Deprecated the
siteUrl
config setting. Sites’ Base URL settings should be set to aliases or environment variables instead. (#3205) - Deprecated the
relatedToAll
GraphQL query argument. - Deprecated the
isUnsavedDraft
GraphQL field. - Deprecated
craft\base\Element::getIsUnsavedDraft()
.getIsUnpublishedDraft()
should be used instead. - Deprecated
craft\db\Connection::trimObjectName()
. - Deprecated
craft\gql\base\Resolver::getArrayableArguments()
. - Deprecated
craft\gql\base\Resolver::prepareArguments()
. - Deprecated
craft\helpers\App::logConfig()
. - Deprecated
craft\services\Composer::$disablePackagist
. - Deprecated
craft\services\Drafts::applyDraft()
.publishDraft()
should be used instead. - Deprecated
craft\services\Drafts::EVENT_AFTER_APPLY_DRAFT
.EVENT_AFTER_PUBLISH_DRAFT
should be used instead. - Deprecated
craft\services\Drafts::EVENT_BEFORE_APPLY_DRAFT
.EVENT_BEFORE_PUBLISH_DRAFT
should be used instead. - Deprecated
craft\services\Drafts::purgeUnsavedDrafts()
. - Deprecated
craft\test\Fixture
.craft\test\ActiveFixture
should be used instead. - Deprecated
craft\web\View::$minifyCss
. - Deprecated
craft\web\View::$minifyJs
. - Deprecated
craft\web\View::renderTemplateMacro()
.
- Removed Minify and jsmin-php.
- Removed
craft\controllers\ElementIndexesController::actionCreateExportToken()
. - Removed
craft\controllers\ExportController
. - Removed
craft\services\Api::getComposerWhitelist()
. - Removed
craft\test\fixtures\elements\ElementFixture
.craft\test\fixtures\elements\BaseElementFixture
should be used instead. - Removed
craft\test\fixtures\FieldLayoutFixture::deleteAllByFieldHandle()
. - Removed
craft\test\fixtures\FieldLayoutFixture::extractTabsFromFieldLayout()
. - Removed
craft\test\fixtures\FieldLayoutFixture::getTabsForFieldLayout()
. - Removed
craft\test\fixtures\FieldLayoutFixture::linkFieldToLayout()
.
- Fixed a bug where asset queries’
withTransforms
param wasn’t being respected for eager-loaded assets. (#6140) - Fixed a bug where
craft\db\Connection::getPrimaryKeyName()
,getForeignKeyName()
, andgetIndexName()
could generate non-unique object names. (#7153) - Fixed a bug where number strings were not correctly typecast to the right PHP numeric type when using the Number GraphQL type.
- Fixed a bug where it wasn’t possible to save a Global set with a predefined UID.
- Fixed a bug where
craft\helpers\Db::prepareValuesForDb()
would omit or JSON-encodeDateTime
objects, depending on the PHP version, rather than converting them to ISO-8601-formatted strings. - Fixed a bug where info icons’ content was focusable before the icon was activated. (#7257)
- Fixed a bug where generated URLs would include the token from the current request, even if it had expired or met its usage limit.