v2.8.0: Planned Deprecations

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

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

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

Core\Base\Document::get_container_classes()

Core Plugin		Replaced by: Core\Base\Document::get_container_attributes()
Located in: core/base/document.php
In Soft deprecation since: 2.4.0
Deletion version: 3.2.0
Core\Base\Document::get_remote_library_type()

Core Plugin		 Replaced by: Core\Base\Document::get_remote_library_config()
Located in: core/base/document.php
In Soft deprecation since: 2.4.0
Deletion version: 3.2.0
Core\Documents_Manager::get_groups()

Core Plugin		Replaced by:  none
Located in: core/documents-manager.php
In soft deprecation since:2.4.0
Deletion version:3.2.0
Group_Control_Posts::on_export_remove_setting_from_element()

Pro Plugin		Replaced by: none
Located in: modules/query-control/controls/group-control-posts.php
In soft deprecation since: 2.4.0
Deletion version: 3.2.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
Modules\ThemeBuilder\Classes\Locations_Manager::get_locations_without_core()

Pro Plugin		Replaced by: 
Modules\ThemeBuilder\Classes\Locations_Manager::get_locations( [ 'public'=> true ] )()
Located in:
modules/theme-builder/classes/locations-manager.php
In soft deprecation since: 2.4.0
In hard deprecation since: 2.4.0

Class Aliases

Deletion

AliasChanges Made
Elementor\Admin

Core Plugin		 Replaced by: Elementor\Core\Admin\Admin
In hard deprecation since: 2.4.0

WP-CLI

Soft Deprecation

AliasChanges Made
sync_library / sync-library

Core Plugin		Replaced by: library sync
Hard deprecation: 3.2.0
Deletion version: 3.6.0
import_library / import-library

Core Plugin		Replaced by: library import
Hard deprecation: 3.2.0
Deletion version: 3.6.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

startTransport()

Core Plugin		Replaced by: $e.run( 'document/elements/copy' )
Located in: assets/dev/js/editor/elements/views/base.js
Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
copy()

Core Plugin		Replaced by: $e.run( 'document/elements/copy' )
Located in: assets/dev/js/editor/elements/views/base.js
Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
cut()

Core Plugin		Replaced by: $e.run( 'document/elements/cut' )
Located in: assets/dev/js/editor/elements/views/base.js
Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
paste()

Core Plugin		Replaced by: $e.run( 'document/elements/paste' )
Located in: assets/dev/js/editor/elements/views/base.js
Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
duplicate()

Core Plugin		Replaced by: $e.run( 'document/elements/duplicate' )
Located in: assets/dev/js/editor/elements/views/base.js
Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
pasteStyle()

Core Plugin		Replaced by: $e.run( 'document/elements/paste-style' )
Located in: assets/dev/js/editor/elements/views/base.js
Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
resetStyle()

Core Plugin		Replaced by: $e.run( 'document/elements/reset-style' )
Located in: assets/dev/js/editor/elements/views/base.js
Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
addChildElement()

Core Plugin		Replaced by: $e.run( 'document/elements/create' )
Located in: assets/dev/js/editor/views/base-container.js
Hard deprecation Version: 3.2.0
Deletion version: 3.6.0

Deletion

Function / Method NameChanges Made
elementor.helpers.firstLetterUppercase()

Core Plugin		Replaced by: elementorCommon.helpers.upperCaseWords()
Located in: /core/common/assets/js/utils/helpers.js
In soft deprecation since: 2.3.0
In hard deprecation since: 2.3.0
deleteRevision()

Core Plugin		Replaced by: none
Located in: modules/history/assets/js/revisions/manager.js
deleteRevision()

Core Plugin		Replaced by: none
Located in: modules/history/assets/js/revisions/panel-tab.js
onChildviewDeleteClick: function()

Core Plugin		Replaced by: none
Located in: modules/history/assets/js/revisions/panel-tab.js

Vars

Soft Deprecation

Var NameChanges Made
this.elementSettingsModel

Core Plugin		Replaced by: this.container.settings

Located in: assets/dev/js/editor/controls/base.js

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0

Events

Soft Deprecation

Event NameChanges Made
elementor.channels.data -> drag:before:update

Core Plugin		Replaced by: $e.events -> Before -> 'document/elements/create'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> drag:after:update

Core Plugin		Replaced by: $e.events -> After -> 'document/elements/create'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> element:before:add

Core Plugin		Replaced by: $e.events -> Before -> 'document/elements/create'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> element:after:add

Core Plugin		Replaced by: $e.events -> After -> 'document/elements/create'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> element:before:remove

Core Plugin		Replaced by: $e.events -> Before -> 'document/elements/delete'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> element:after:remove

Core Plugin		Replaced by: $e.events -> After -> 'document/elements/delete'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> element:before:paste:style

Core Plugin		Replaced by: $e.events -> Before -> 'document/elements/paste-style'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> element:after:paste:style

Core Plugin		Replaced by: $e.events -> After -> 'document/elements/paste-style'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> element:before:reset:style

Core Plugin		Replaced by: $e.events -> Before -> 'document/elements/reset-style'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> element:after:reset:style

Core Plugin		Replaced by: $e.events -> After -> 'document/elements/reset-style'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> section:before:drop

Core Plugin		Replaced by: $e.events -> Before -> 'document/elements/create'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> section:after:drop

Core Plugin		Replaced by: $e.events -> After -> 'document/elements/create'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> template:before:insert

Core Plugin		Replaced by: $.run( 'document/import' ) || $e.events -> Before -> 'document/import'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.0
elementor.channels.data -> template:after:insert

Core Plugin		Replaced by: $e.events -> After -> 'document/import'

Hard deprecation Version: 3.2.0
Deletion version: 3.6.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.