<?php

[0] Fix | Delete

namespace Elementor\Core\Base;

[1] Fix | Delete

[2] Fix | Delete

use Elementor\Core\Base\Elements_Iteration_Actions\Assets as Assets_Iteration_Action;

[3] Fix | Delete

use Elementor\Core\Base\Elements_Iteration_Actions\Base as Elements_Iteration_Action;

[4] Fix | Delete

use Elementor\Core\Behaviors\Interfaces\Lock_Behavior;

[5] Fix | Delete

use Elementor\Core\Files\CSS\Post as Post_CSS;

[6] Fix | Delete

use Elementor\Core\Settings\Page\Model as Page_Model;

[7] Fix | Delete

use Elementor\Core\Utils\Collection;

[8] Fix | Delete

use Elementor\Core\Utils\Exceptions;

[9] Fix | Delete

use Elementor\Includes\Elements\Container;

[10] Fix | Delete

use Elementor\Plugin;

[11] Fix | Delete

use Elementor\Controls_Manager;

[12] Fix | Delete

use Elementor\Controls_Stack;

[13] Fix | Delete

use Elementor\TemplateLibrary\Source_Local;

[14] Fix | Delete

use Elementor\User;

[15] Fix | Delete

use Elementor\Core\Settings\Manager as SettingsManager;

[16] Fix | Delete

use Elementor\Utils;

[17] Fix | Delete

use Elementor\Widget_Base;

[18] Fix | Delete

use Elementor\Core\Settings\Page\Manager as PageManager;

[19] Fix | Delete

use ElementorPro\Modules\Library\Widgets\Template;

[20] Fix | Delete

use Elementor\Core\Utils\Promotions\Filtered_Promotions_Manager;

[21] Fix | Delete

[22] Fix | Delete

if ( ! defined( 'ABSPATH' ) ) {

[23] Fix | Delete

exit; // Exit if accessed directly.

[24] Fix | Delete

}

[25] Fix | Delete

[26] Fix | Delete

/**

[27] Fix | Delete

* Elementor document.

[28] Fix | Delete

*

[29] Fix | Delete

* An abstract class that provides the needed properties and methods to

[30] Fix | Delete

* manage and handle documents in inheriting classes.

[31] Fix | Delete

*

[32] Fix | Delete

* @since 2.0.0

[33] Fix | Delete

* @abstract

[34] Fix | Delete

*/

[35] Fix | Delete

abstract class Document extends Controls_Stack {

[36] Fix | Delete

[37] Fix | Delete

/**

[38] Fix | Delete

* Document type meta key.

[39] Fix | Delete

*/

[40] Fix | Delete

const TYPE_META_KEY = '_elementor_template_type';

[41] Fix | Delete

const PAGE_META_KEY = '_elementor_page_settings';

[42] Fix | Delete

const ELEMENTOR_DATA_META_KEY = '_elementor_data';

[43] Fix | Delete

[44] Fix | Delete

const BUILT_WITH_ELEMENTOR_META_KEY = '_elementor_edit_mode';

[45] Fix | Delete

[46] Fix | Delete

const CACHE_META_KEY = '_elementor_element_cache';

[47] Fix | Delete

[48] Fix | Delete

/**

[49] Fix | Delete

* Document publish status.

[50] Fix | Delete

*/

[51] Fix | Delete

const STATUS_PUBLISH = 'publish';

[52] Fix | Delete

[53] Fix | Delete

/**

[54] Fix | Delete

* Document draft status.

[55] Fix | Delete

*/

[56] Fix | Delete

const STATUS_DRAFT = 'draft';

[57] Fix | Delete

[58] Fix | Delete

/**

[59] Fix | Delete

* Document private status.

[60] Fix | Delete

*/

[61] Fix | Delete

const STATUS_PRIVATE = 'private';

[62] Fix | Delete

[63] Fix | Delete

/**

[64] Fix | Delete

* Document autosave status.

[65] Fix | Delete

*/

[66] Fix | Delete

const STATUS_AUTOSAVE = 'autosave';

[67] Fix | Delete

[68] Fix | Delete

/**

[69] Fix | Delete

* Document pending status.

[70] Fix | Delete

*/

[71] Fix | Delete

const STATUS_PENDING = 'pending';

[72] Fix | Delete

[73] Fix | Delete

/**

[74] Fix | Delete

* @var int

[75] Fix | Delete

*/

[76] Fix | Delete

private $main_id;

[77] Fix | Delete

[78] Fix | Delete

/**

[79] Fix | Delete

* @var bool

[80] Fix | Delete

*/

[81] Fix | Delete

private $is_saving = false;

[82] Fix | Delete

[83] Fix | Delete

private static $properties = [];

[84] Fix | Delete

[85] Fix | Delete

/**

[86] Fix | Delete

* @var Elements_Iteration_Action[]

[87] Fix | Delete

*/

[88] Fix | Delete

private $elements_iteration_actions = [];

[89] Fix | Delete

[90] Fix | Delete

/**

[91] Fix | Delete

* Document post data.

[92] Fix | Delete

*

[93] Fix | Delete

* Holds the document post data.

[94] Fix | Delete

*

[95] Fix | Delete

* @since 2.0.0

[96] Fix | Delete

* @access protected

[97] Fix | Delete

*

[98] Fix | Delete

* @var \WP_Post WordPress post data.

[99] Fix | Delete

*/

[100] Fix | Delete

protected $post;

[101] Fix | Delete

[102] Fix | Delete

/**

[103] Fix | Delete

* @param array $internal_elements

[104] Fix | Delete

*

[105] Fix | Delete

* @return array[]

[106] Fix | Delete

*/

[107] Fix | Delete

private function get_container_elements_data( array $internal_elements ): array {

[108] Fix | Delete

return [

[109] Fix | Delete

[

[110] Fix | Delete

'id' => Utils::generate_random_string(),

[111] Fix | Delete

'elType' => 'container',

[112] Fix | Delete

'elements' => $internal_elements,

[113] Fix | Delete

],

[114] Fix | Delete

];

[115] Fix | Delete

}

[116] Fix | Delete

[117] Fix | Delete

/**

[118] Fix | Delete

* @param array $internal_elements

[119] Fix | Delete

*

[120] Fix | Delete

* @return array[]

[121] Fix | Delete

*/

[122] Fix | Delete

private function get_sections_elements_data( array $internal_elements ): array {

[123] Fix | Delete

return [

[124] Fix | Delete

[

[125] Fix | Delete

'id' => Utils::generate_random_string(),

[126] Fix | Delete

'elType' => 'section',

[127] Fix | Delete

'elements' => [

[128] Fix | Delete

[

[129] Fix | Delete

'id' => Utils::generate_random_string(),

[130] Fix | Delete

'elType' => 'column',

[131] Fix | Delete

'elements' => $internal_elements,

[132] Fix | Delete

],

[133] Fix | Delete

],

[134] Fix | Delete

],

[135] Fix | Delete

];

[136] Fix | Delete

}

[137] Fix | Delete

[138] Fix | Delete

/**

[139] Fix | Delete

* @since 2.1.0

[140] Fix | Delete

* @access protected

[141] Fix | Delete

* @static

[142] Fix | Delete

*/

[143] Fix | Delete

protected static function get_editor_panel_categories() {

[144] Fix | Delete

return Plugin::$instance->elements_manager->get_categories();

[145] Fix | Delete

}

[146] Fix | Delete

[147] Fix | Delete

/**

[148] Fix | Delete

* Get properties.

[149] Fix | Delete

*

[150] Fix | Delete

* Retrieve the document properties.

[151] Fix | Delete

*

[152] Fix | Delete

* @since 2.0.0

[153] Fix | Delete

* @access public

[154] Fix | Delete

* @static

[155] Fix | Delete

*

[156] Fix | Delete

* @return array Document properties.

[157] Fix | Delete

*/

[158] Fix | Delete

public static function get_properties() {

[159] Fix | Delete

return [

[160] Fix | Delete

'has_elements' => true,

[161] Fix | Delete

'is_editable' => true,

[162] Fix | Delete

'edit_capability' => '',

[163] Fix | Delete

'show_in_finder' => true,

[164] Fix | Delete

'show_on_admin_bar' => true,

[165] Fix | Delete

'support_kit' => false,

[166] Fix | Delete

'show_navigator' => true,

[167] Fix | Delete

'allow_adding_widgets' => true,

[168] Fix | Delete

'support_page_layout' => true,

[169] Fix | Delete

'show_copy_and_share' => false,

[170] Fix | Delete

'library_close_title' => esc_html__( 'Close', 'elementor' ),

[171] Fix | Delete

'publish_button_title' => esc_html__( 'Publish', 'elementor' ),

[172] Fix | Delete

'allow_closing_remote_library' => true,

[173] Fix | Delete

];

[174] Fix | Delete

}

[175] Fix | Delete

[176] Fix | Delete

/**

[177] Fix | Delete

* @since 2.1.0

[178] Fix | Delete

* @access public

[179] Fix | Delete

* @static

[180] Fix | Delete

*/

[181] Fix | Delete

public static function get_editor_panel_config() {

[182] Fix | Delete

$default_route = 'panel/elements/categories';

[183] Fix | Delete

[184] Fix | Delete

if ( ! Plugin::instance()->role_manager->user_can( 'design' ) ) {

[185] Fix | Delete

$default_route = 'panel/page-settings/settings';

[186] Fix | Delete

}

[187] Fix | Delete

[188] Fix | Delete

return [

[189] Fix | Delete

'title' => static::get_title(), // JS Container title.

[190] Fix | Delete

'widgets_settings' => [],

[191] Fix | Delete

'elements_categories' => self::get_filtered_editor_panel_categories(),

[192] Fix | Delete

'default_route' => $default_route,

[193] Fix | Delete

'has_elements' => static::get_property( 'has_elements' ),

[194] Fix | Delete

'support_kit' => static::get_property( 'support_kit' ),

[195] Fix | Delete

'messages' => [

[196] Fix | Delete

'publish_notification' => sprintf(

[197] Fix | Delete

/* translators: %s: Document title. */

[198] Fix | Delete

esc_html__( 'Hurray! Your %s is live.', 'elementor' ),

[199] Fix | Delete

static::get_title()

[200] Fix | Delete

),

[201] Fix | Delete

],

[202] Fix | Delete

'show_navigator' => static::get_property( 'show_navigator' ),

[203] Fix | Delete

'allow_adding_widgets' => static::get_property( 'allow_adding_widgets' ),

[204] Fix | Delete

'show_copy_and_share' => static::get_property( 'show_copy_and_share' ),

[205] Fix | Delete

'library_close_title' => static::get_property( 'library_close_title' ),

[206] Fix | Delete

'publish_button_title' => static::get_property( 'publish_button_title' ),

[207] Fix | Delete

'allow_closing_remote_library' => static::get_property( 'allow_closing_remote_library' ),

[208] Fix | Delete

];

[209] Fix | Delete

}

[210] Fix | Delete

[211] Fix | Delete

public static function get_filtered_editor_panel_categories(): array {

[212] Fix | Delete

$categories = static::get_editor_panel_categories();

[213] Fix | Delete

$has_pro = Utils::has_pro();

[214] Fix | Delete

[215] Fix | Delete

foreach ( $categories as $index => $category ) {

[216] Fix | Delete

if ( isset( $category['promotion'] ) ) {

[217] Fix | Delete

$categories = self::get_panel_category_item( $category['promotion'], $index, $categories, $has_pro );

[218] Fix | Delete

}

[219] Fix | Delete

}

[220] Fix | Delete

[221] Fix | Delete

return $categories;

[222] Fix | Delete

}

[223] Fix | Delete

[224] Fix | Delete

/**

[225] Fix | Delete

* @param $promotion

[226] Fix | Delete

* @param $index

[227] Fix | Delete

* @param array $categories

[228] Fix | Delete

*

[229] Fix | Delete

* @return array

[230] Fix | Delete

*/

[231] Fix | Delete

private static function get_panel_category_item( $promotion, $index, array $categories, bool $has_pro ): array {

[232] Fix | Delete

if ( ! $has_pro ) {

[233] Fix | Delete

$categories[ $index ]['promotion'] = Filtered_Promotions_Manager::get_filtered_promotion_data(

[234] Fix | Delete

$promotion,

[235] Fix | Delete

'elementor/panel/' . $index . '/custom_promotion',

[236] Fix | Delete

'url'

[237] Fix | Delete

);

[238] Fix | Delete

} else {

[239] Fix | Delete

unset( $categories[ $index ]['promotion'] );

[240] Fix | Delete

}

[241] Fix | Delete

[242] Fix | Delete

return $categories;

[243] Fix | Delete

}

[244] Fix | Delete

[245] Fix | Delete

/**

[246] Fix | Delete

* Get element title.

[247] Fix | Delete

*

[248] Fix | Delete

* Retrieve the element title.

[249] Fix | Delete

*

[250] Fix | Delete

* @since 2.0.0

[251] Fix | Delete

* @access public

[252] Fix | Delete

* @static

[253] Fix | Delete

*

[254] Fix | Delete

* @return string Element title.

[255] Fix | Delete

*/

[256] Fix | Delete

public static function get_title() {

[257] Fix | Delete

return esc_html__( 'Document', 'elementor' );

[258] Fix | Delete

}

[259] Fix | Delete

[260] Fix | Delete

public static function get_plural_title() {

[261] Fix | Delete

return static::get_title();

[262] Fix | Delete

}

[263] Fix | Delete

[264] Fix | Delete

public static function get_add_new_title() {

[265] Fix | Delete

return sprintf(

[266] Fix | Delete

/* translators: %s: Document title. */

[267] Fix | Delete

esc_html__( 'Add New %s', 'elementor' ),

[268] Fix | Delete

static::get_title()

[269] Fix | Delete

);

[270] Fix | Delete

}

[271] Fix | Delete

[272] Fix | Delete

/**

[273] Fix | Delete

* Get property.

[274] Fix | Delete

*

[275] Fix | Delete

* Retrieve the document property.

[276] Fix | Delete

*

[277] Fix | Delete

* @since 2.0.0

[278] Fix | Delete

* @access public

[279] Fix | Delete

* @static

[280] Fix | Delete

*

[281] Fix | Delete

* @param string $key The property key.

[282] Fix | Delete

*

[283] Fix | Delete

* @return mixed The property value.

[284] Fix | Delete

*/

[285] Fix | Delete

public static function get_property( $key ) {

[286] Fix | Delete

$id = static::get_class_full_name();

[287] Fix | Delete

[288] Fix | Delete

if ( ! isset( self::$properties[ $id ] ) ) {

[289] Fix | Delete

self::$properties[ $id ] = static::get_properties();

[290] Fix | Delete

}

[291] Fix | Delete

[292] Fix | Delete

return self::get_items( self::$properties[ $id ], $key );

[293] Fix | Delete

}

[294] Fix | Delete

[295] Fix | Delete

/**

[296] Fix | Delete

* @since 2.0.0

[297] Fix | Delete

* @access public

[298] Fix | Delete

* @static

[299] Fix | Delete

*/

[300] Fix | Delete

public static function get_class_full_name() {

[301] Fix | Delete

return get_called_class();

[302] Fix | Delete

}

[303] Fix | Delete

[304] Fix | Delete

public static function get_create_url() {

[305] Fix | Delete

$properties = static::get_properties();

[306] Fix | Delete

[307] Fix | Delete

// BC Support - Each document should define it own CPT this code is for BC support.

[308] Fix | Delete

$cpt = Source_Local::CPT;

[309] Fix | Delete

[310] Fix | Delete

if ( isset( $properties['cpt'][0] ) ) {

[311] Fix | Delete

$cpt = $properties['cpt'][0];

[312] Fix | Delete

}

[313] Fix | Delete

[314] Fix | Delete

return Plugin::$instance->documents->get_create_new_post_url( $cpt, static::get_type() );

[315] Fix | Delete

}

[316] Fix | Delete

[317] Fix | Delete

public function get_name() {

[318] Fix | Delete

return static::get_type();

[319] Fix | Delete

}

[320] Fix | Delete

[321] Fix | Delete

/**

[322] Fix | Delete

* @since 2.0.0

[323] Fix | Delete

* @access public

[324] Fix | Delete

*/

[325] Fix | Delete

public function get_unique_name() {

[326] Fix | Delete

return static::get_type() . '-' . $this->post->ID;

[327] Fix | Delete

}

[328] Fix | Delete

[329] Fix | Delete

/**

[330] Fix | Delete

* @since 2.3.0

[331] Fix | Delete

* @access public

[332] Fix | Delete

*/

[333] Fix | Delete

public function get_post_type_title() {

[334] Fix | Delete

$post_type_object = get_post_type_object( $this->post->post_type );

[335] Fix | Delete

[336] Fix | Delete

return $post_type_object->labels->singular_name;

[337] Fix | Delete

}

[338] Fix | Delete

[339] Fix | Delete

/**

[340] Fix | Delete

* @since 2.0.0

[341] Fix | Delete

* @access public

[342] Fix | Delete

*/

[343] Fix | Delete

public function get_main_id() {

[344] Fix | Delete

if ( ! $this->main_id ) {

[345] Fix | Delete

$post_id = $this->post->ID;

[346] Fix | Delete

[347] Fix | Delete

$parent_post_id = wp_is_post_revision( $post_id );

[348] Fix | Delete

[349] Fix | Delete

if ( $parent_post_id ) {

[350] Fix | Delete

$post_id = $parent_post_id;

[351] Fix | Delete

}

[352] Fix | Delete

[353] Fix | Delete

$this->main_id = $post_id;

[354] Fix | Delete

}

[355] Fix | Delete

[356] Fix | Delete

return $this->main_id;

[357] Fix | Delete

}

[358] Fix | Delete

[359] Fix | Delete

/**

[360] Fix | Delete

* @return null|Lock_Behavior

[361] Fix | Delete

*/

[362] Fix | Delete

public static function get_lock_behavior_v2() {

[363] Fix | Delete

return null;

[364] Fix | Delete

}

[365] Fix | Delete

[366] Fix | Delete

/**

[367] Fix | Delete

* @since 2.0.0

[368] Fix | Delete

* @access public

[369] Fix | Delete

*

[370] Fix | Delete

* @param $data

[371] Fix | Delete

*

[372] Fix | Delete

* @throws \Exception If the widget was not found.

[373] Fix | Delete

*

[374] Fix | Delete

* @return string

[375] Fix | Delete

*/

[376] Fix | Delete

public function render_element( $data ) {

[377] Fix | Delete

// Start buffering

[378] Fix | Delete

ob_start();

[379] Fix | Delete

[380] Fix | Delete

/** @var Widget_Base $widget */

[381] Fix | Delete

$widget = Plugin::$instance->elements_manager->create_element_instance( $data );

[382] Fix | Delete

[383] Fix | Delete

if ( ! $widget ) {

[384] Fix | Delete

throw new \Exception( 'Widget not found.' );

[385] Fix | Delete

}

[386] Fix | Delete

[387] Fix | Delete

$widget->render_content();

[388] Fix | Delete

[389] Fix | Delete

$render_html = ob_get_clean();

[390] Fix | Delete

[391] Fix | Delete

return $render_html;

[392] Fix | Delete

}

[393] Fix | Delete

[394] Fix | Delete

/**

[395] Fix | Delete

* @since 2.0.0

[396] Fix | Delete

* @access public

[397] Fix | Delete

*/

[398] Fix | Delete

public function get_main_post() {

[399] Fix | Delete

return get_post( $this->get_main_id() );

[400] Fix | Delete

}

[401] Fix | Delete

[402] Fix | Delete

public function get_container_attributes() {

[403] Fix | Delete

$id = $this->get_main_id();

[404] Fix | Delete

[405] Fix | Delete

$attributes = [

[406] Fix | Delete

'data-elementor-type' => $this->get_name(),

[407] Fix | Delete

'data-elementor-id' => $id,

[408] Fix | Delete

'class' => 'elementor elementor-' . $id,

[409] Fix | Delete

];

[410] Fix | Delete

[411] Fix | Delete

$version_meta = $this->get_main_meta( '_elementor_version' );

[412] Fix | Delete

[413] Fix | Delete

if ( version_compare( $version_meta, '2.5.0', '<' ) ) {

[414] Fix | Delete

$attributes['class'] .= ' elementor-bc-flex-widget';

[415] Fix | Delete

}

[416] Fix | Delete

[417] Fix | Delete

if ( Plugin::$instance->preview->is_preview() ) {

[418] Fix | Delete

$attributes['data-elementor-title'] = static::get_title();

[419] Fix | Delete

} else {

[420] Fix | Delete

$elementor_settings = $this->get_frontend_settings();

[421] Fix | Delete

if ( ! empty( $elementor_settings ) ) {

[422] Fix | Delete

$attributes['data-elementor-settings'] = wp_json_encode( $elementor_settings );

[423] Fix | Delete

}

[424] Fix | Delete

}

[425] Fix | Delete

[426] Fix | Delete

// apply this filter to allow the attributes to be modified by different sources

[427] Fix | Delete

return apply_filters( 'elementor/document/wrapper_attributes', $attributes, $this );

[428] Fix | Delete

}

[429] Fix | Delete

[430] Fix | Delete

/**

[431] Fix | Delete

* @since 2.0.0

[432] Fix | Delete

* @access public

[433] Fix | Delete

*/

[434] Fix | Delete

public function get_wp_preview_url() {

[435] Fix | Delete

$main_post_id = $this->get_main_id();

[436] Fix | Delete

$document = $this;

[437] Fix | Delete

[438] Fix | Delete

// Ajax request from editor.

[439] Fix | Delete

$initial_document_id = Utils::get_super_global_value( $_POST, 'initial_document_id' ); // phpcs:ignore WordPress.Security.NonceVerification.Missing

[440] Fix | Delete

[441] Fix | Delete

if ( ! empty( $initial_document_id ) ) {

[442] Fix | Delete

$document = Plugin::$instance->documents->get( $initial_document_id ); // phpcs:ignore WordPress.Security.NonceVerification.Missing

[443] Fix | Delete

}

[444] Fix | Delete

[445] Fix | Delete

$url = get_preview_post_link(

[446] Fix | Delete

$document->get_main_id(),

[447] Fix | Delete

[

[448] Fix | Delete

'preview_id' => $main_post_id,

[449] Fix | Delete

'preview_nonce' => wp_create_nonce( 'post_preview_' . $main_post_id ),

[450] Fix | Delete

]

[451] Fix | Delete

);

[452] Fix | Delete

[453] Fix | Delete

/**

[454] Fix | Delete

* Document "WordPress preview" URL.

[455] Fix | Delete

*

[456] Fix | Delete

* Filters the WordPress preview URL.

[457] Fix | Delete

*

[458] Fix | Delete

* @since 2.0.0

[459] Fix | Delete

*

[460] Fix | Delete

* @param string $url WordPress preview URL.

[461] Fix | Delete

* @param Document $this The document instance.

[462] Fix | Delete

*/

[463] Fix | Delete

$url = apply_filters( 'elementor/document/urls/wp_preview', $url, $this );

[464] Fix | Delete

[465] Fix | Delete

return $url;

[466] Fix | Delete

}

[467] Fix | Delete

[468] Fix | Delete

/**

[469] Fix | Delete

* @since 2.0.0

[470] Fix | Delete

* @access public

[471] Fix | Delete

*/

[472] Fix | Delete

public function get_exit_to_dashboard_url() {

[473] Fix | Delete

$url = get_edit_post_link( $this->get_main_id(), 'raw' );

[474] Fix | Delete

[475] Fix | Delete

/**

[476] Fix | Delete

* Document "exit to dashboard" URL.

[477] Fix | Delete

*

[478] Fix | Delete

* Filters the "Exit To Dashboard" URL.

[479] Fix | Delete

*

[480] Fix | Delete

* @since 2.0.0

[481] Fix | Delete

*

[482] Fix | Delete

* @param string $url The exit URL

[483] Fix | Delete

* @param Document $this The document instance.

[484] Fix | Delete

*/

[485] Fix | Delete

$url = apply_filters( 'elementor/document/urls/exit_to_dashboard', $url, $this );

[486] Fix | Delete

[487] Fix | Delete

return $url;

[488] Fix | Delete

}

[489] Fix | Delete

[490] Fix | Delete

/**

[491] Fix | Delete

* Get All Post Type URL

[492] Fix | Delete

*

[493] Fix | Delete

* Get url of the page which display all the posts of the current active document's post type.

[494] Fix | Delete

*

[495] Fix | Delete

* @since 3.7.0

[496] Fix | Delete

*

[497] Fix | Delete

* @return string $url

[498] Fix | Delete

*/

[499] Fix | Delete