�PNG  IHDR22?�� pHYs  �� OiCCPPhotoshop ICC profilexڝSgTS�=���BK���KoR RB���&*! J�!��Q�EEȠ�����Q, � ��!���������{�kּ������>���� �H3Q5� �B�������.@� $p�d!s�#�~<<+"��x� �M��0���B�\���t�8K�@z�B�@F���&S�`�cb�P-`'������{[�!�� e�Dh;��V�EX0fK�9�-0IWfH���� � 0Q��){`�##x��F�W<�+��*x��<�$9E�[-qWW.(�I+6aa�@.�y�2�4���������x����6��_-��"bb���ϫp@�t~��,/��;�m��%�h^ �u��f�@����W�p�~<�5�j>{�-�]c�K'Xt����o��(�h���w��?�G�%�fI�q^D$.Tʳ?�D��*�A��,���� �`6�B$��BB d�r`)��B(�Ͱ*`/�@4�Qh��p.�U�=p�a��(�� A�a!ڈb�X#����!�H�$ ɈQ"K�5H1R�T UH�=r9�\F��;�2����G1���Q=� �C��7�F� �dt1�����r�=�6��Ыhڏ>C�0��3�l0.��B�8, �c˱"� ���V����cϱw�E� 6wB aAHXLXN�H� $4� 7 �Q�'"��K�&���b21�XH,#��/{�C�7$�C2'��I��T��F�nR#�,��4H#���dk�9�, +ȅ����3��!�[ �b@q��S�(R�jJ��4�e�2AU��Rݨ�T5�ZB���R�Q��4u�9̓IK�����hh�i��t�ݕN��W���G���w ��Ljg(�gw��L�Ӌ�T071���oUX*�*|�� �J�&�*/T����ު U�U�T��^S}�FU3S� Ԗ�U��P�SSg�;���g�oT?�~Y��Y�L�OC�Q��_�� c�x,!k ��u�5�&���|v*�����=���9C3J3W�R�f?�q��tN �(���~���)�)�4L�1e\k����X�H�Q�G�6������E�Y��A�J'\'Gg����S�Sݧ �M=:��.�k���Dw�n��^��Lo��y���}/�T�m���G X� $� �<�5qo</���QC]�@C�a�a�ᄑ��<��F�F�i�\�$�m�mƣ&&!&KM�M�RM��)�;L;L���͢�֙5�=1�2��כ߷`ZxZ,����eI��Z�Yn�Z9Y�XUZ]�F���%ֻ�����N�N���gð�ɶ�����ۮ�m�}agbg�Ů��}�}��= ���Z~s�r:V:ޚΜ�?}����/gX���3��)�i�S��Ggg�s�󈋉K��.�>.���Ƚ�Jt�q]�z���������ۯ�6�i�ܟ�4�)�Y3s���C�Q��? ��0k߬~OCO�g��#/c/�W�װ��w��a�>�>r��>�<7�2�Y_�7��ȷ�O�o�_��C#�d�z����%g��A�[��z|!��?:�e����A���AA�������!h�쐭!��Α�i�P~���a�a��~ '���W�?�p�X�1�5w��Cs�D�D�Dޛg1O9�-J5*>�.j<�7�4�?�.fY��X�XIlK9.*�6nl������� �{�/�]py�����.,:�@L�N8��A*��%�w%� y��g"/�6ш�C\*N�H*Mz�쑼5y$�3�,幄'���L Lݛ:��v m2=:�1����qB�!M��g�g�fvˬe����n��/��k���Y- �B��TZ(�*�geWf�͉�9���+��̳�ې7�����ᒶ��KW-X潬j9�������(�x��oʿ�ܔ���Ĺd�f�f���-�[����n �ڴ �V����E�/��(ۻ��C���<��e����;?T�T�T�T6��ݵa��n��{��4���[���>ɾ�UUM�f�e�I���?�������m]�Nmq����#�׹���=TR��+�G�����w- 6 U����#pDy��� �� :�v�{���vg/jB��F�S��[b[�O�>����z�G��499�?r����C�d�&����ˮ/~�����јѡ�򗓿m|������������x31^�V���w�w��O�| (�h���SЧ��������c3-� cHRMz%������u0�`:�o�_�F5IDATx��ytUս�?�;���fN$$��@B�!�k��� -*�gE���j�O�kQ�ʠ`U�B_ �AÐ0%�Ȕ�@r3ޛ;߳��$�@��v����^�s����������$��ߢ !�W��5�̱'-٘������4�>�Rƫ$�G��0U�H}�_ _� #��k�MJ/=�9Du *ڲ�k�PQ;0��j|�*�$�^컂脛y���>�z×� B��� ��(�:$�ʔ_�6��C!B����MVx��a��ζyY����j��ƋY2�9�F�{r��r�딟F��Q��hY6��� x��[l��RC��������nt@��;P��3��� F�w��7��:�P���ɋ'���mj���Bƪ�$�Q�L��y��߷g��\���z����v5�p�v$�v櫻�`6~K �Y�X����,�:��"�o�e0II"(��,������l_�C���/4�+f�E�!q��:����u����c��樼.UE�@� �]K�W���$-�h]�JG���Dz)�`��.�A/ ���mᏣc�3jK� �!�>���$�Q�!�_�? \�C2(E �M$Z I{�U���s�ǣ���=��@Բe ޻��W�����@ �w����}�9v,)��.}*|"�s��di���,���G�]W�AC�������|<����[��ߕ������K�*�G nߴ!��‹��J�!��6(L�a)��Am��������;adf��:�xm��nh�;֦I��(���o�C~ډa?�=��s����h��E������xp����)���_���t��W�����´;8���`dz=(��@@�+,�;�`�fhl��XȌ�3,uI�~z(J����� �ZX�A����H'�À�㜦�82|��a�n�z2��I���� ���EY�h�ε<�0�q�{��C��v�˅��?"@��χ�x�WS+��N�~�KQ�J�8ل�� _.W��� !TU{�����,��"�� �;�������HI S� ��))�o�1�H�D� ���� (� ;����"Ҕ��,���� �F=���O��&�Ph>�`���y��߲ &S��P�<��'��1s�1cĂ�N����2)����@�u��tv��<�+�-&�����h��[!FSG���' � z z0��<����8d&�����E0�,��<��"!P�b4��� �{S�����X����.�囤���T��hEF��X�q0"-<����h���]�Py*����F⩍��@v�˂�Y08�� .q��a��s����(!<̫1�3�L�H��7sYW�`��qtu�\7��?�@�Y�� %Ka�x�GZ�*W�P��y�����N0r9��Z�c�%���q,��k�����!!,��>���IB��� �x1�Xu�Y���v-���ֺ��N������JP��a�2`�e5��w��u;�6�i���̃��(K���ťa��(l51��JL��O'%���]���ٖ뿉!��{*�p+f ���i8��D�ȑ���ܩ�M��V��ӟz��x�7Z�1i}�^͜���6e����x��)u�d�ˏ�V�eG�\�X1�����=n�U'�~Y����L�\,�(d!x ,�:�TW8� M`r���@��r+v�Q0��>^;˴�VbF��('����� �*O��i��j�Ӆ����^�S3&� ���{������.ی�� N;��NU%d0�Ce\r"�C�b��&t7N�7��� �ȪD�[%l�۪�$��'m?�A9tI�9>��NVL ��� 6v~M�����ъ�B���0����9$&=ώm��W�0���L���&��E���f�f��'+�9��hv��7,���M��6�D�&�^� �����8 D֮�����o��k^z��O��hP�8q�5d*��YVq3�{��������#LX4�?��jP=3�~�؅c�ݰ�̱�ұ��8̲��2�G�����j��έ�9��w7���U�X�w�85C��?!I&���o&����L���I#�^�eV�,�^t5�k� �xs˛\��U�8��."���{���ǵ�l4��ݼ�;��r"���G�/~���gJV�N糦��ZZ^k+NN�D��I$�=OE�z����|*�*{��%k���G��>�`9��b;�s���8,�qs��c��.b��q�%�>r��n�R�Ƨ�%�,�A��le#�8���}; 21�0�b�&�QX�f���q�00����$>�h�N�'�a3��A���/�r ��L5�8�GԲ'�����w;��c#�q1���h$*��V^�k��QĽ�b:i������� ����H F#�_���,��]g����Ը����`RUU���� ��"�qD���>-��ϤI�~��3�̴�����NZ[[555�eeek7�m����YF#[��Đ��R��i��L�H�r ��@��J-�Pŝ��_|�-��6y��ks�V�U~��6���w.����(��0A� 4��f��� /���C�xŊ�ٳ����z=6�����rg���mKo��o�/����a�g���?'9%9��P��斓��~���L{�� �H��{AW��B��$����v�1b�&Mb�ر��ر#�0`�`xMBp! )Z�Nmo�mZ�g�}�eذaWTVV ���'99��C5��&�&+5�bT>|8��PUUETT����&���t��~TE%��'������b�tEGG;RSS�S�N�v��ѯ��t����u1@�ޚ"f��͈���r'L�Ph��m��ƌ�74o��`�x�q�P���NRSS�X,�����l&&&��MFFA!-��`��ҷ�n��Yuu�����x<I�LB%����KԒ50�!�3�bz�����ʸKL���;---�l6[��`��������Ȏ;�����egg4��!D�T��jWujyZ��������K����%����p�^���X,6��sV=�ܖ����6�3�X ���4ҿ��A2�&����_k�;d�� �VfOIEND�B`� 0x0x
PHP 8.1.34
Preview: document-mutator.php Size: 13.07 KB
//home2/astrociv/public_html/avantaraholidays.com/wp-content/plugins/elementor/core/utils/document/document-mutator.php
<?php

namespace Elementor\Core\Utils\Document;

use Elementor\Core\Base\Document;
use Elementor\Plugin;
use Elementor\Utils;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class Document_Mutator {

	const DOCUMENT_ROOT = 'document';

	const WIDGET_EL_TYPE = 'widget';

	/** @var \Elementor\Elements_Manager */
	private $element_manager;

	/** @var \Elementor\Widgets_Manager */
	private $widgets_manager;

	public function __construct( $element_manager, $widgets_manager ) {
		$this->element_manager = $element_manager;
		$this->widgets_manager = $widgets_manager;
	}

	public static function instance(): self {
		return new self(
			Plugin::$instance->elements_manager,
			Plugin::$instance->widgets_manager
		);
	}

	/**
	 * Locate a node by id and return a by-reference index [ $id => &$node ]
	 * so callers can mutate the tree in place.
	 *
	 * @return array<string, array&>
	 */
	public function build_ref_index( array &$tree, string $id ): array {
		$index = [];
		$this->walk_for_ref_index( $tree, $id, $index );

		return $index;
	}

	private function walk_for_ref_index( array &$tree, string $id, array &$index ): bool {
		foreach ( $tree as &$node ) {
			if ( isset( $node['id'] ) && $node['id'] === $id ) {
				$index[ $id ] = &$node;
				return true;
			}
			if ( ! empty( $node['elements'] ) && is_array( $node['elements'] ) ) {
				if ( $this->walk_for_ref_index( $node['elements'], $id, $index ) ) {
					return true;
				}
			}
		}
		unset( $node );

		return false;
	}

	public function find_by_id( array $tree, string $id ): ?array {
		foreach ( $tree as $node ) {
			if ( isset( $node['id'] ) && $node['id'] === $id ) {
				return $node;
			}

			if ( ! empty( $node['elements'] ) ) {
				$found = $this->find_by_id( $node['elements'], $id );
				if ( null !== $found ) {
					return $found;
				}
			}
		}

		return null;
	}

	public function generate_id(): string {
		return Utils::generate_random_string();
	}

	/**
	 * @return array|\WP_Error
	 */
	public function insert_at( array $tree, string $parent_id, ?int $index, array $element ) {
		if ( ! isset( $element['id'] ) ) {
			$element['id'] = $this->generate_id();
		}

		if ( self::DOCUMENT_ROOT === $parent_id ) {
			$root_child_error = $this->check_document_root_child_allowed( $element );

			if ( is_wp_error( $root_child_error ) ) {
				return $root_child_error;
			}

			return $this->splice_into( $tree, $index, $element );
		}

		$result = $this->insert_into_tree( $tree, $parent_id, $index, $element );

		if ( is_wp_error( $result ) ) {
			return $result;
		}

		if ( false === $result ) {
			return new \WP_Error(
				'elementor_not_found',
				__( 'Parent element not found.', 'elementor' ),
				[ 'status' => \WP_Http::NOT_FOUND ]
			);
		}

		return $result;
	}

	/**
	 * @return array|\WP_Error
	 */
	public function remove( array $tree, string $id ) {
		$result = $this->remove_from_tree( $tree, $id );

		if ( false === $result ) {
			return new \WP_Error(
				'elementor_not_found',
				__( 'Element not found.', 'elementor' ),
				[ 'status' => \WP_Http::NOT_FOUND ]
			);
		}

		return $result;
	}

	/**
	 * @return array|\WP_Error
	 */
	public function move( array $tree, string $id, string $new_parent_id, ?int $index ) {
		$node = $this->find_by_id( $tree, $id );

		if ( null === $node ) {
			return new \WP_Error(
				'elementor_not_found',
				__( 'Element not found.', 'elementor' ),
				[ 'status' => \WP_Http::NOT_FOUND ]
			);
		}

		$tree = $this->remove( $tree, $id );

		if ( is_wp_error( $tree ) ) {
			return $tree;
		}

		return $this->insert_at( $tree, $new_parent_id, $index, $node );
	}

	/**
	 * Duplicate an element in place, inserting the clone right after the source
	 * inside the same parent. All ids in the clone are regenerated.
	 *
	 * @return array|\WP_Error
	 */
	public function duplicate( array $tree, string $id ) {
		$location = $this->locate_parent_and_index( $tree, $id );

		if ( null === $location ) {
			return new \WP_Error(
				'elementor_not_found',
				__( 'Element not found.', 'elementor' ),
				[ 'status' => \WP_Http::NOT_FOUND ]
			);
		}

		[ $parent_id, $index, $node ] = $location;

		return $this->insert_subtree( $tree, $parent_id, $index + 1, $node );
	}

	/**
	 * Save an elements tree to a document.
	 *
	 * Default behavior (backwards compatible): downgrade a `publish` post to `draft`
	 * before saving so no live changes leak out, then save on the main document.
	 *
	 * When `$preserve_live_status` is true: the main post status is kept intact and
	 * writes on `publish`/`private` posts are redirected to an autosave revision
	 * (mirroring the editor's in-app "Save as Draft" flow) so the live page keeps
	 * serving the previous version until the user opens the editor and publishes.
	 * In this mode the return value is the Document actually written on success.
	 *
	 * @return bool|Document|\WP_Error
	 */
	public function save_as_draft( Document $document, array $elements, bool $preserve_live_status = false ) {
		if ( $preserve_live_status ) {
			return $this->save_preserving_live_status( $document, $elements );
		}

		return $this->save_downgrading_publish_to_draft( $document, $elements );
	}

	/**
	 * @return bool|int|\WP_Error
	 */
	private function save_downgrading_publish_to_draft( Document $document, array $elements ) {
		if ( 'publish' === get_post_status( $document->get_main_id() ) ) {
			wp_update_post( [
				'ID' => $document->get_main_id(),
				'post_status' => 'draft',
			] );
		}

		return $document->save( [ 'elements' => $elements ] );
	}

	/**
	 * @return Document|\WP_Error
	 */
	private function save_preserving_live_status( Document $document, array $elements ) {
		$target = $this->resolve_autosave_target( $document );

		if ( is_wp_error( $target ) ) {
			return $target;
		}

		$saved = $target->save( [ 'elements' => $elements ] );

		if ( is_wp_error( $saved ) ) {
			return $saved;
		}

		if ( ! $saved ) {
			return new \WP_Error(
				'elementor_save_failed',
				__( 'Could not save document.', 'elementor' ),
				[ 'status' => \WP_Http::INTERNAL_SERVER_ERROR ]
			);
		}

		return $target;
	}

	/**
	 * @return Document|\WP_Error
	 */
	private function resolve_autosave_target( Document $document ) {
		$main_document = Plugin::$instance->documents->get( $document->get_main_id() );

		if ( ! $main_document instanceof Document ) {
			return new \WP_Error(
				'elementor_not_found',
				__( 'Post not found.', 'elementor' ),
				[ 'status' => \WP_Http::NOT_FOUND ]
			);
		}

		$main_status = get_post_status( $main_document->get_main_id() );

		if ( ! in_array( $main_status, [ 'publish', 'private' ], true ) ) {
			return $main_document;
		}

		$autosave = $main_document->get_autosave( 0, true );

		if ( ! $autosave instanceof Document ) {
			return new \WP_Error(
				'elementor_autosave_failed',
				__( 'Could not create autosave revision.', 'elementor' ),
				[ 'status' => \WP_Http::INTERNAL_SERVER_ERROR ]
			);
		}

		return $autosave;
	}

	/**
	 * @return array|\WP_Error
	 */
	public function patch_settings( array $tree, string $id, array $partial_settings ) {
		$result = $this->patch_settings_in_tree( $tree, $id, $partial_settings );

		if ( false === $result ) {
			return new \WP_Error(
				'elementor_not_found',
				__( 'Element not found.', 'elementor' ),
				[ 'status' => \WP_Http::NOT_FOUND ]
			);
		}

		return $result;
	}

	/**
	 * Insert a subtree into the document tree, recursively generating IDs for all elements.
	 *
	 * @param array    $tree      The current document tree.
	 * @param string   $parent_id Parent element ID or 'document' for root.
	 * @param int|null $index     Insertion index (null = append).
	 * @param array    $subtree   The subtree to insert (single element with nested children).
	 *
	 * @return array|\WP_Error The updated tree or error.
	 */
	public function insert_subtree( array $tree, string $parent_id, ?int $index, array $subtree ) {
		$subtree_with_ids = $this->generate_ids_recursive( $subtree );

		return $this->insert_at( $tree, $parent_id, $index, $subtree_with_ids );
	}

	/**
	 * Recursively generate IDs for an element and all its children.
	 * Always generates new IDs to avoid duplicates when inserting subtrees.
	 *
	 * @param array $element The element to process.
	 *
	 * @return array The element with new IDs assigned.
	 */
	private function generate_ids_recursive( array $element ): array {
		$element['id'] = $this->generate_id();

		if ( ! empty( $element['elements'] ) && is_array( $element['elements'] ) ) {
			$element['elements'] = array_map(
				fn( array $child ) => $this->generate_ids_recursive( $child ),
				$element['elements']
			);
		}

		return $element;
	}

	/**
	 * @return array{0: string, 1: int, 2: array}|null [ parent_id, index, node ] or null when not found.
	 */
	private function locate_parent_and_index( array $tree, string $id, string $parent_id = self::DOCUMENT_ROOT ): ?array {
		foreach ( $tree as $i => $node ) {
			if ( isset( $node['id'] ) && $node['id'] === $id ) {
				return [ $parent_id, $i, $node ];
			}

			if ( ! empty( $node['elements'] ) && is_array( $node['elements'] ) ) {
				$found = $this->locate_parent_and_index( $node['elements'], $id, (string) ( $node['id'] ?? '' ) );
				if ( null !== $found ) {
					return $found;
				}
			}
		}

		return null;
	}

	private function splice_into( array $children, ?int $index, array $element ): array {
		$count = count( $children );

		if ( null === $index || $index >= $count ) {
			$children[] = $element;
			return $children;
		}

		array_splice( $children, $index, 0, [ $element ] );
		return $children;
	}

	/**
	 * @return array|false|\WP_Error
	 */
	private function insert_into_tree( array $tree, string $parent_id, ?int $index, array $element ) {
		foreach ( $tree as $i => $node ) {
			if ( isset( $node['id'] ) && $node['id'] === $parent_id ) {
				if ( isset( $node['elType'] ) && self::WIDGET_EL_TYPE === $node['elType'] ) {
					return new \WP_Error(
						'elementor_invalid_parent',
						__( 'Cannot insert into a widget element.', 'elementor' ),
						[ 'status' => \WP_Http::BAD_REQUEST ]
					);
				}

				$child_type_error = $this->check_child_type_allowed( $node, $element );
				if ( is_wp_error( $child_type_error ) ) {
					return $child_type_error;
				}

				$node['elements'] = $this->splice_into( $node['elements'] ?? [], $index, $element );
				$tree[ $i ] = $node;
				return $tree;
			}

			if ( ! empty( $node['elements'] ) ) {
				$result = $this->insert_into_tree( $node['elements'], $parent_id, $index, $element );

				if ( false !== $result ) {
					if ( is_wp_error( $result ) ) {
						return $result;
					}
					$node['elements'] = $result;
					$tree[ $i ] = $node;
					return $tree;
				}
			}
		}

		return false;
	}

	/**
	 * @return array|false
	 */
	private function remove_from_tree( array $tree, string $id ) {
		foreach ( $tree as $i => $node ) {
			if ( isset( $node['id'] ) && $node['id'] === $id ) {
				array_splice( $tree, $i, 1 );
				return $tree;
			}

			if ( ! empty( $node['elements'] ) ) {
				$result = $this->remove_from_tree( $node['elements'], $id );
				if ( false !== $result ) {
					$node['elements'] = $result;
					$tree[ $i ] = $node;
					return $tree;
				}
			}
		}

		return false;
	}

	/**
	 * Mirrors the editor's `Document.isValidChild`: only element types may sit at the document
	 * root, so widgets inserted here would produce a tree the editor itself refuses to create.
	 *
	 * @return null|\WP_Error
	 */
	private function check_document_root_child_allowed( array $element ): ?\WP_Error {
		if ( self::WIDGET_EL_TYPE !== ( $element['elType'] ?? '' ) ) {
			return null;
		}

		return new \WP_Error(
			'elementor_invalid_parent',
			sprintf(
				/* translators: %s: widget type */
				__( '"%s" is a widget and cannot be a direct child of the document. Wrap it in a container element such as e-flexbox or e-div-block.', 'elementor' ),
				$element['widgetType'] ?? self::WIDGET_EL_TYPE
			),
			[ 'status' => \WP_Http::BAD_REQUEST ]
		);
	}

	/**
	 * @return null|\WP_Error
	 */
	private function check_child_type_allowed( array $parent_node, array $child ): ?\WP_Error {
		$parent_instance = $this->element_manager->get_element_types( $parent_node['elType'] ?? '' );

		if ( ! $parent_instance ) {
			return null;
		}

		$config  = $parent_instance->get_config();
		$allowed = $config['allowed_child_types'] ?? [];

		if ( empty( $allowed ) ) {
			return null;
		}

		$child_type = $child['widgetType'] ?? $child['elType'] ?? '';

		if ( ! in_array( $child_type, $allowed, true ) ) {
			return new \WP_Error(
				'elementor_invalid_parent',
				__( 'Element type not allowed as child of this parent.', 'elementor' ),
				[ 'status' => \WP_Http::BAD_REQUEST ]
			);
		}

		return null;
	}

	/**
	 * @return array|false
	 */
	private function patch_settings_in_tree( array $tree, string $id, array $partial_settings ) {
		foreach ( $tree as $i => $node ) {
			if ( isset( $node['id'] ) && $node['id'] === $id ) {
				$node['settings'] = array_merge( $node['settings'] ?? [], $partial_settings );
				$tree[ $i ] = $node;
				return $tree;
			}

			if ( ! empty( $node['elements'] ) ) {
				$result = $this->patch_settings_in_tree( $node['elements'], $id, $partial_settings );
				if ( false !== $result ) {
					$node['elements'] = $result;
					$tree[ $i ] = $node;
					return $tree;
				}
			}
		}

		return false;
	}
}

Directory Contents

Dirs: 0 × Files: 1
Name Size Perms Modified Actions
13.07 KB lrw-r--r-- 2026-09-08 05:46:58
Edit Download
If ZipArchive is unavailable, a .tar will be created (no compression).
© 2026 0xNothings — Secure File Manager. All rights reserved. Built with ❤️ & Tailwind x Dark UI