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.

Author

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.

2 Responses

  1. I’m new to elementor when I like to explore any PHP functions/methods there is an option to navigate easily by typing the term in search input of the page: https://code.elementor.com/.

    For e.g. If I type the term “controls” it list down the “Controls_Stack” class but on the other hand if I search for any JS methods or function it’s not listed there.

    So my question is where is the document for the JS part.

    Thanks,

  2. Hey, I would like to know how to get widget settings from elementor-extension-plugin/widget-name/widges/widget-name.php to elementor-extension-plugin/widget-name/module.php

    Basically, I would like to access all the widget settings in module.php file

    Thanks in advance 🙂

Leave a Reply

Your email address will not be published. Required fields are marked *