v2.9.0: Planned Deprecations

Hey all! we are getting ready to release version 2.9.

If you are a developer who extends Elementor please review the below changes to keep your plugin up and running.

Here is the planned deprecations:

PHP

Functions & Methods

Soft Deprecation

Function / Method NameChanges Made
Controls_Stack::_content_template()
Core Plugin		Replaced by: Controls_Stack::content_template()
Located in: includes/base/controls-stack.php
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
Controls_Stack::_get_initial_config()
Core Plugin		Replaced by: Controls_Stack::get_initial_config()
Located in: includes/base/controls-stack.php
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
Controls_Stack::_init()
Core Plugin		Replaced by: Controls_Stack::init()
Located in: includes/base/controls-stack.php
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0

Hard Deprecation

When a function/method is on hard deprecation phase, it means that the function/method will still work while it’s in this phase, but will add a PHP notice if the website WP_DEBUG property is set to true.

Function / Method NameChanges Made

Group_Control_Posts
Pro Plugin		Replaced by: Group_Control_Query
Located in: modules/query-control/controls/group-control-posts.php
In Soft deprecation since: 2.5.0
Deletion version: 3.3.0
Modules\QueryControl\Module::add_exclude_controls()
Pro Plugin		Replaced by: None
Located in: modules/query-control/module.php
In Soft deprecation since: 2.5.0
Deletion version: 3.3.0
Modules\QueryControl\Module::fix_query_found_posts()
Pro Plugin		Replaced by: Elementor_Post_Query:: fix_query_found_posts()
Located in: modules/query-control/module.php
In Soft deprecation since: 2.5.0
Deletion version: 3.3.0
Modules\QueryControl\Module::fix_query_offset()
Pro Plugin		Replaced by:  Elementor_Post_Query::fix_query_offset()
Located in: modules/query-control/module.php
In Soft deprecation since: 2.5.0
Deletion version: 3.3.0
Modules\QueryControl\Module::get_query_args()
Pro Plugin		Replaced by:  None
Located in: modules/query-control/module.php
In Soft deprecation since: 2.5.0
Deletion version: 3.3.0
\ElementorPro\Modules\LinkActions\Module::create_action_url()
Pro Plugin		Replaced by:  Plugin::elementor()->frontend->create_action_hash()
Located in: modules/link-actions/module.php
Deletion version: 3.3.0

Deletion

When a function/method is on deletion phase, it means that the function/method will not work anymore, and will most likely throw a Fatal Error when it’s called.

Function / Method NameChanges Made
Repeater::get_fields()
Core Plugin		Replaced by: Repeater::get_controls()
Located in: includes/elements/repeater.php
In soft deprecation since: 2.1.0
In hard deprecation since: 2.5.0

Actions and Filters

Hard Deprecation

Action / FilterChanges Made
elementor_pro/{$widget_name}/query/{$query_id}
Pro Plugin		Replaced by: elementor/query/{$query_id}
Type: Action (Pro)
In soft deprecation since: 2.5.0
Deletion: 3.3.0

Deletion

Action / FilterChanges Made
elementor_pro/query_control/get_query_args/current_query
Pro Plugin		Replaced by: elementor/query/get_query_args/current_query
Type: Filter (Pro)
In soft deprecation since: 2.5.0
In hard deprecation since: 2.5.0

Class Aliases

Deletion

AliasChanges Made
Elementor\Core\Ajax
Core Plugin		Replaced by: Elementor\Core\Common\Modules\Ajax\Module
In soft deprecation since: 2.3.0
In hard deprecation since: 2.5.0

JavaScript

Functions & Methods

Soft Deprecation

When a function/method is on soft deprecation phase, it means that the function/method will still work while it’s in this phase, but a comment will be placed in the code mentioning the upcoming deprecation.

Function / Method NameChanges Made
_checkIsFull()
Core Plugin		Replaced by: toggleSectionIsFull
Located in: assets/dev/js/editor/elements/views/section.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementorModules.common.Component
Core Plugin		Replaced by: $e.modules.ComponentBase
Located in: core/common/assets/js/modules.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementorModules.common.ComponentModal
Core Plugin		Replaced by: $e.modules.ComponentModalBase
Located in: core/common/assets/js/modules.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementorModules.common.HookBreak
Core Plugin		Replaced by: $e.modules.HookBreak
Located in: core/common/assets/js/modules.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.history.history
Core Plugin		Replaced by: elementor.documents.getCurrent().history
Located in: modules/history/assets/js/module.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.history.revisions
Core Plugin		Replaced by: elementor.documents.getCurrent().revisions
Located in: modules/history/assets/js/module.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.config.data
Core Plugin		Replaced by: elementor.config.document.elements
Located in: assets/dev/js/editor/editor-base.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.config.current_user_can_publish
Core Plugin		Replaced by: elementor.config.document.user.can_publish
Located in: assets/dev/js/editor/editor-base.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.config.locked_user
Core Plugin		Replaced by: none
Located in: assets/dev/js/editor/editor-base.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.config.revisions_enabled
Core Plugin		Replaced by: elementor.config.document.revisions.enabled
Located in: assets/dev/js/editor/editor-base.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.config.current_revision_id
Core Plugin		Replaced by: elementor.config.document.revisions.current_id
Located in: assets/dev/js/editor/editor-base.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.config.settings.page
Core Plugin		Replaced by: elementor.config.document.settings
Located in: assets/dev/js/editor/editor-base.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.config.widgets
Core Plugin		Replaced by: elementor.widgetsCache
Located in: assets/dev/js/editor/editor-base.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.saver.autoSaveTimer (getter)
Core Plugin		Replaced by: $e.components.get( 'editor/documents' ).autoSaveTimers
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.saver.autoSaveTimer (setter)
Core Plugin		Replaced by: $e.components.get( 'editor/documents' ).autoSaveTimers[ documentId ]
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.saver.on()
Core Plugin		Replaced by: $e.hooks
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.channels.editor.on( 'saved', ... )
Core Plugin		Replaced by: $e.hooks
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
defaultSave()
Core Plugin		Replaced by: $e.run( 'document/save/default' )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
discard()
Core Plugin		Replaced by: $e.run( 'document/save/discard' )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
doAutoSave()
Core Plugin		Replaced by: $e.run( 'document/save/auto' )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
publish()
Core Plugin		Replaced by: $e.run( 'document/save/publish' )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
saveAutoSave()
Core Plugin		Replaced by: $e.run( 'document/save/auto', { force: true } )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
saveDraft()
Core Plugin		Replaced by: $e.run( 'document/save/draft' )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
savePending()
Core Plugin		Replaced by: $e.run( 'document/save/pending' )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
update()
Core Plugin		Replaced by: $e.run( 'document/save/update', options )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
startTimer()
Core Plugin		Replaced by: $e.components.get( 'document/save' ).startAutoSave()
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
saveEditor()
Core Plugin		Replaced by: $e.internal( 'document/save/save' )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
setFlagEditorChange()
Core Plugin		Replaced by: $e.internal( 'document/save/set-is-modified' )
Located in: assets/dev/js/editor/document/save/backwards-compatibility.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0

Vars

Soft Deprecation

Var NameChanges Made
elementor.saver.autoSaveTimer
Core Plugin		Replaced by: $e.components.get( 'editor/documents' ).autoSaveTimers[ documentId ]
Located in: assets/dev/js/editor/components/saver/manager.js
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0

Events

Soft Deprecation

Event NameChanges Made
elementor.saver -> before:save:publish
Core Plugin		Replaced by: $e.hooks -> Before -> 'document/save/save`
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0
elementor.saver -> before:save:private
Core Plugin		Replaced by: $e.hooks -> Before -> 'document/save/save`
Hard deprecation Version: 3.3.0
Deletion version: 3.7.0

You can download the latest release of Elementor Core from WordPress repository, and the latest release of Elementor Pro from your Elementor dashboard.

If you spot any issues, please log them in detail on Github.

Developer Newsletter

Stay up to date on the latest developer news, product updates, and best practices.

Sign Up

Author

Picture of Shilo Eish Yemini
Shilo Eish Yemini
Shilo is Elementor’s Editor Product Lead. He loves innovative products, pays attention to the small details, and is passionate about solving puzzles.