v2.8.0: Planned Deprecations

Shilo Eish Yemini
November 21, 2019
Deprecations
Elementor 2.8

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 Name	Changes 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 Name	Changes 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

Alias	Changes Made
`Elementor\Admin` Core Plugin	Replaced by: `Elementor\Core\Admin\Admin` In hard deprecation since: `2.4.0`

WP-CLI

Soft Deprecation

Alias	Changes 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 Name	Changes 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 Name	Changes 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 Name	Changes 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 Name	Changes 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.

Author

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.