v3.1: Planned Deprecations

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

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 NameChanges Made
localize_settings()

Core Plugin
Replaced by: None

Located in: core/common/modules/connect/module.php
core/dynamic-tags/manager.php
modules/history/module.php


Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
admin_localize_settings()

Core Plugin
Replaced by: None

Located in: core/upgrade/elementor-3-re-migrate-globals.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
add_admin_strings()

Core Plugin
Replaced by: None

Located in: includes/managers/icons.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
editor_settings()

Core Plugin
Replaced by: None

Located in: modules/history/revisions-manager.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
localize_settings()

Pro Plugin
Replaced by: None

Located in:
modules/assets-manager/module.php
modules/custom-css/module.php
modules/forms/module.php
modules/library/module.php
modules/popup/module.php
modules/query-control/module.php
modules/table-of-contents/module.php
modules/theme-builder/module.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
_print_content()

Core Plugin
Replaced by: print_content()

Located in: includes/base/element-base.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
_add_render_attributes()

Core Plugin
Replaced by: add_render_attributes()

Located in: includes/base/element-base.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
_get_theme()

Core Plugin
Replaced by: get_themes()

Located in:
modules/system-info/reporters/theme.phpincludes/base/element-base.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
_register_skins()

Core Plugin
Replaced by: register_skins()

Located in:
includes/base/widget-base.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
_register_skins()

Core Plugin
Replaced by: register_skins()

Located in:
includes/base/widget-base.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
get_builder()

Core Plugin
Replaced by: None

Located in:
includes/db.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0
set_is_elementor_page()

Core Plugin
Replaced by:
Plugin::$instance->documents->get( $post_id )->set_is_built_with_elementor(

Located in:
includes/db.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0

PHP Vars

Soft Deprecation

Var NameChanges Made
DB::STATUS_PUBLISH

Core Plugin
Replaced by: Document::STATUS_PUBLISH

Located in: includes/db.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0

DB::STATUS_DRAFT

Core Plugin
Replaced by: Document::STATUS_DRAFT

Located in: includes/db.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0

DB::STATUS_PRIVATE

Core Plugin
Replaced by: Document::STATUS_PRIVATE

Located in: includes/db.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0

DB::STATUS_AUTOSAVE

Core Plugin
Replaced by: Document::STATUS_AUTOSAVE

Located in: includes/db.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0

DB::STATUS_PENDING

Core Plugin
Replaced by: Document::STATUS_PENDING

Located in: includes/db.php

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0

PHP Hooks

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.

Please Note: The hooks elementor/element/post/before_section_end and elementor/element/post/after_section_end had multiple use cases, which have now been replaced with multiple, more specific hooks. See the following table for more details.

elementor_pro/query_control/get_autocompleteChanges Made
elementor/element/post/before_section_start

Core Plugin

Type: Action
Replaced by: elementor/element/wp-post/before_section_start

In soft deprecation since: 2.7.0

Deletion version: 3.5.0
elementor/element/post/after_section_start

Core Plugin

Type: Action
Replaced by: elementor/element/wp-post/after_section_start

In soft deprecation since: 2.7.0

Deletion version: 3.5.0
elementor/element/post/before_section_end

Core Plugin

Type: Action
Replaced by: elementor/element/wp-post/before_section_end

In soft deprecation since: 2.7.0

Deletion version: 3.5.0
elementor/element/post/before_section_end

Core Plugin

Type: Action
Replaced by: elementor/element/wp-post/after_section_end

In soft deprecation since: 2.7.0

Deletion version: 3.5.0
elementor/element/post/after_section_end

Core Plugin

Type: Action
Replaced by: elementor/element/wp-post/after_section_end

In soft deprecation since: 2.7.0

Deletion version: 3.5.0
elementor/element/post/before_section_end

Core Plugin

Type: Action
Replaced by: elementor/element/wp-page/before_section_end

In soft deprecation since: 2.7.0

Deletion version: 3.5.0
elementor/element/post/after_section_end

Core Plugin

Type: Action
Replaced by: elementor/element/wp-page/after_section_end

In soft deprecation since: 2.7.0

Deletion version: 3.5.0

JavaScript

Functions & Methods

Soft Deprecation

Function / Method NameChanges Made
hasThumbs()

Pro Plugin
Replaced by: None

Located in: modules/carousel/assets/js/frontend/handlers/media-carousel.js

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0

Modules

Soft Deprecation

Module / Class NameChanges Made
Scroll

Pro Plugin
Replaced by: assets/dev/js/modules/imports/utils/scroll.js

Located in: assets/dev/js/modules/imports/utils/scroll.js

Hard deprecation Version: 3.5.0

Deletion version: 3.9.0

Assets

Hard Deprecation

Asset NameChanges Made
jquery-slick

Core Plugin

Type: Action
Replaced by: swiper

Located in: assets/lib

In Soft deprecation since: 2.7.0

Deletion version: 3.5.0

You can download the latest release of Elementor Core from WordPress repository, and the latest release of Elementor Pro from your Elementor dashboard.
Developer Edition releases will introduce these changes earlier than in the official stable release.

If you spot any issues, please log them in detail on Github.

Beta version supposed to be published during December 2020.

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.

6 Responses

  1. Under the section:
    PHP Hooks
    Hard Deprecation

    Editor copy pasted the following details multiple times please update the document:
    elementor/element/post/before_section_end
    elementor/element/post/after_section_end

    1. Hi Vijayan,

      Thank you for your contribution and attention to detail!

      It hasn’t actually been pasted multiple times.
      What happened is that the same hooks, `elementor/element/post/before_section_end` and `elementor/element/post/after_section_end`, which were used in multiple different use cases, have now been split into multiple different hooks. If you check out the ‘Changes Made’ column, you can see that each row has a new hook.

      It really wasn’t very clear, so I added a paragraph before the changes table explaining this.
      Thanks for your help!

  2. Good development, well done.

    One small point not really appropriate here- but I’m hoping it’ll get passed on – is that some (not me!) will (choose to?) be confused by the existence of this excellent dev concept alongside the beta version. Ways forward are obvious and need not be mentioned here.

  3. In the table under “PHP Hooks”, the first column’s table heading says “elementor_pro/query_control/get_autocomplete”. I think it’s safe to assume this is an editing mistake in this post and it should be moved to a table row providing more info.

Leave a Reply

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