v3.3: Planned Deprecations

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

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

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
Controls_Stack::_content_template()

Core Plugin
Replaced by:
Controls_Stack::content_template()

Located in: includes/base/controls-stack.php

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
Controls_Stack::_init()

Core Plugin		Replaced by:
Controls_Stack::init()

Located in: includes/base/controls-stack.php

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
License\Admin::is_license_about_to_expire()

Pro Plugin
Replaced by:
License\Api::is_license_about_to_expire()

Located in: license/admin.php

Soft deprecation Version:2.9.0

Deletion Version: 3.7.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
Group_Control_Posts

Pro Plugin
Replaced by:
Group_Control_Query

Located in:
modules/query-control/controls/group-control-posts.php

Soft deprecation Version: 2.5.0

Hard deprecation Version: 2.9.0

Modules\LinkActions\Module::create_action_url()

Pro Plugin		Replaced by:
Plugin::elementor()->frontend->create_action_hash()

Located in:
modules/link-actions/module.php

Soft deprecation Version: 2.5.0

Hard deprecation Version: 2.9.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

Soft deprecation Version: 2.5.0

Hard deprecation Version: 2.9.0
Modules\QueryControl\Module::fix_query_offset()

Pro Plugin
Replaced by:
Elementor_Post_Query::fix_query_offset()

Located in:
modules/query-control/module.php

Soft deprecation Version: 2.5.0

Hard deprecation Version: 2.9.0

PHP Classes

Deletion

Class nameChanges Made
ElementorPro\Modules\LinkActions\Module

Pro Plugin		Replaced by:
Plugin::elementor()->frontend->create_action_hash()

Located in:
modules/link-actions/module.php

Soft deprecation Version: 2.5.0

Hard deprecation Version: 2.9.0

PHP Hooks

Hard Deprecation

Function / Method NameChanges Made
elementor/files/svg/enabled

Core Plugin

Type: Filter
Replaced by:
elementor/files/allow_unfiltered_upload

Soft deprecation Version: 2.9.0

Deletion Version: 3.7.0

Deletion

Function / Method NameChanges Made
elementor_pro/{$widget_name}/query/{$query_id}

Pro Plugin

Type: Action
Replaced by:
elementor/query/{$query_id}

Soft deprecation Version: 2.5.0

Hard deprecation Version: 2.9.0

JS

Functions & Methods

Hard Deprecation

Function / Method NameChanges Made
_checkIsFull()

Core Plugin
Replaced by:
toggleSectionIsFull

Located in: assets/dev/js/editor/elements/views/section.js

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementorModules.common.Component

Core Plugin
Replaced by:
$e.modules.ComponentBase

Located in: core/common/assets/js/modules.js

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementor.helpers.document.findViewRecursive

Core Plugin		Replaced by:
$e.components.get( 'document' ).utils.findViewRecursive()

Located in: assets/dev/js/editor/utils/helpers.js

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementor.helpers.document.findViewById

Core Plugin
Replaced by:
$e.components.get( 'document' ).utils.findViewById()

Located in: assets/dev/js/editor/utils/helpers.js

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementor.helpers.document.findContainerById

Core Plugin
Replaced by:
$e.components.get( 'document' ).utils.findContainerById()

Located in: assets/dev/js/editor/utils/helpers.js

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementorModules.common.ComponentModal

Core Plugin
Replaced by:
$e.modules.ComponentModalBase

Located in: core/common/assets/js/modules.js

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementorModules.common.HookBreak

Core Plugin
Replaced by:
$e.modules.HookBreak

Located in: core/common/assets/js/modules.js

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementor.history.history

Core Plugin
Replaced by:
elementor.documents.getCurrent().history

Located in: core/common/assets/js/modules.js

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementor.history.revisions

Core Plugin
Replaced by:
elementor.documents.getCurrent().revisions

Located in: core/common/assets/js/modules.js

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementor.config.locked_user

Core Plugin
Replaced by:
None

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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementor.config.widgets

Core Plugin
Replaced by:
elementor.widgetsCache

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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.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

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0

JS Events

Hard Deprecation

Event nameChanges Made
elementor.saver -> before:save:publish

Core Plugin		Replaced by:
$e.hooks -> Before -> 'document/save/save`

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0
elementor.saver -> before:save:private

Core Plugin		Replaced by:
$e.hooks -> Before -> 'document/save/save`

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0

JS Vars

Hard 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

Soft deprecation Version:2.9.0

Deletion Version: 3.7.0

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.