v3.2: Planned Deprecations

Shilo Eish Yemini
March 7, 2021
Deprecations
Elementor 3.2

Hey all! We are getting ready to release version 3.2.

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

Here are the planned deprecations:

PHP

Functions & Methods

Soft Deprecation

When a function/method is in the 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
`is_built_with_elementor()` Core Plugin	Replaced by: `Plugin::$instance->documents->get( $post_id )->is_built_with_elementor()` Located in: `includes/db.php` Hard deprecation Version: `3.6.0` Deletion version: `4.0.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
`Core\Base\Document::get_container_classes()` Core Plugin	Replaced by: `Core\Base\Document::get_container_attributes()` Located in: `core/base/document.php` Soft deprecation Version: `2.4.0` Hard deprecation Version: `2.8.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` Soft deprecation Version: `2.4.0` Hard deprecation Version: `2.8.0`
`Core\Documents_Manager::get_groups()` Core Plugin	Replaced by: `none` Located in: `core/documents-manager.php` Soft deprecation Version: `2.4.0` Hard deprecation Version: `2.8.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` Soft deprecation Version: `2.4.0` Hard deprecation Version: `2.8.0`

CLI Commands

Hard Deprecation

Command	Changes Made
`sync_library / sync-library` Core Plugin	Replaced by: `library sync` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`import_library / import-library` Core Plugin	Replaced by: `library import` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`

JS

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
`startTransport()` Core Plugin	Replaced by: `$e.run( 'document/elements/copy' )` Located in: `assets/dev/js/editor/elements/views/base.js` Soft deprecation Version: `2.8.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` Soft deprecation Version: `2.8.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` Soft deprecation Version: `2.8.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` Soft deprecation Version: `2.8.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` Soft deprecation Version: `2.8.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` Soft deprecation Version: `2.8.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` Soft deprecation Version: `2.8.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` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`

Modules

Hard Deprecation

Module / Class Name	Changes Made
`startTransport()` Core Plugin	Replaced by: `$e.run( 'document/elements/copy' )` Located in: `assets/dev/js/editor/elements/views/base.js` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`

Events

Hard Deprecation

Event Name	Changes Made
`elementor.channels.data -> drag:before:update` Core Plugin	Replaced by: `$e.events -> Before -> 'document/elements/create'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> drag:after:update` Core Plugin	Replaced by: `$e.events -> After -> 'document/elements/create'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> element:before:add` Core Plugin	Replaced by: `$e.events -> Before -> 'document/elements/create'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> element:after:add` Core Plugin	Replaced by: `$e.events -> After -> 'document/elements/create'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> element:before:remove` Core Plugin	Replaced by: `$e.events -> Before -> 'document/elements/delete'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> element:after:remove` Core Plugin	Replaced by: `$e.events -> After -> 'document/elements/delete'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> element:before:paste:style` Core Plugin	Replaced by: `$e.events -> Before -> 'document/elements/paste-style'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> element:after:paste:style` Core Plugin	Replaced by: `$e.events -> After -> 'document/elements/paste-style'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> element:before:reset:style` Core Plugin	Replaced by: `$e.events -> Before -> 'document/elements/reset-style'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> element:after:reset:style` Core Plugin	Replaced by: `$e.events -> After -> 'document/elements/reset-style`‘ Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> section:before:drop` Core Plugin	Replaced by: `$e.events -> Before -> 'document/elements/create'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> section:after:drop` Core Plugin	Replaced by: `$e.events -> After -> 'document/elements/create'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> template:before:insert` Core Plugin	Replaced by: `$.run( 'document/import' ) \|\| $e.events -> Before -> 'document/import'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`
`elementor.channels.data -> template:after:insert` Core Plugin	Replaced by: `$e.events -> After -> 'document/import'` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`

Vars

Hard Deprecation

Var Name	Changes Made
`this.elementSettingsModel` Core Plugin	Replaced by: `this.container.settings` Located in: `assets/dev/js/editor/controls/base.js` Soft deprecation Version: `2.8.0` Deletion version: `3.6.0`

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.