<h2>File Contents: /home/planet5/www/wp-content/plugins/elementor/modules/mcp/abilities/get-structure-ability.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/elementor/modules/mcp/abilities/get-structure-ability.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

namespace Elementor\Modules\Mcp\Abilities;

use Elementor\Plugin;

if ( ! defined( &#039;ABSPATH&#039; ) ) {
	exit;
}

class Get_Structure_Ability extends Abstract_Ability {

	protected function get_ability_id(): string {
		return &#039;elementor/get-page-structure&#039;;
	}

	protected function get_definition(): Ability_Definition {
		return new Ability_Definition(
			__( &#039;Get Elementor Page Structure&#039;, &#039;elementor&#039; ),
			__( &#039;Returns the Elementor element tree (widgets, containers, and nested content) for a single post or page ID. Use after list-pages when you need the live JSON structure to reason about layout, widget types, or to plan edits. Only works for posts that were saved with Elementor.&#039;, &#039;elementor&#039; ),
			&#039;elementor&#039;,
			[
				&#039;type&#039; =&gt; &#039;object&#039;,
				&#039;properties&#039; =&gt; [
					&#039;elements&#039; =&gt; [
						&#039;type&#039; =&gt; &#039;array&#039;,
						&#039;description&#039; =&gt; &#039;Root-level Elementor elements for the document.&#039;,
					],
				],
			],
			[
				&#039;annotations&#039; =&gt; [
					&#039;readonly&#039; =&gt; true,
					&#039;idempotent&#039; =&gt; true,
					&#039;destructive&#039; =&gt; false,
				],
			],
			function () {
				return current_user_can( &#039;edit_posts&#039; );
			},
			[
				&#039;type&#039; =&gt; &#039;object&#039;,
				&#039;required&#039; =&gt; [ &#039;post_id&#039; ],
				&#039;properties&#039; =&gt; [
					&#039;post_id&#039; =&gt; [
						&#039;type&#039; =&gt; &#039;integer&#039;,
						&#039;description&#039; =&gt; &#039;WordPress post ID of the Elementor document.&#039;,
					],
				],
			]
		);
	}

	public function execute( $input = [] ) {
		$post_id = $this-&gt;resolve_post_id( $input );
		if ( is_wp_error( $post_id ) ) {
			return $post_id;
		}

		$document = $this-&gt;get_editable_document( $post_id );
		if ( is_wp_error( $document ) ) {
			return $document;
		}

		$elements = $document-&gt;get_elements_data();

		return [
			&#039;elements&#039; =&gt; is_array( $elements ) ? $elements : [],
		];
	}

	private function resolve_post_id( $input ) {
		$post_id = isset( $input[&#039;post_id&#039;] ) ? absint( $input[&#039;post_id&#039;] ) : 0;

		if ( ! $post_id ) {
			return new \WP_Error(
				&#039;invalid_post_id&#039;,
				__( &#039;A valid post_id is required.&#039;, &#039;elementor&#039; ),
				[ &#039;status&#039; =&gt; \WP_Http::BAD_REQUEST ]
			);
		}

		if ( ! current_user_can( &#039;edit_post&#039;, $post_id ) ) {
			return new \WP_Error(
				&#039;rest_cannot_view&#039;,
				__( &#039;Sorry, you are not allowed to access this document.&#039;, &#039;elementor&#039; ),
				[ &#039;status&#039; =&gt; \WP_Http::FORBIDDEN ]
			);
		}

		return $post_id;
	}

	private function get_editable_document( int $post_id ) {
		$document = Plugin::$instance-&gt;documents-&gt;get( $post_id );

		if ( ! $document ) {
			return new \WP_Error(
				&#039;document_not_found&#039;,
				__( &#039;Document not found.&#039;, &#039;elementor&#039; ),
				[ &#039;status&#039; =&gt; \WP_Http::NOT_FOUND ]
			);
		}

		if ( ! $document-&gt;is_built_with_elementor() ) {
			return new \WP_Error(
				&#039;not_elementor&#039;,
				__( &#039;This post is not built with Elementor.&#039;, &#039;elementor&#039; ),
				[ &#039;status&#039; =&gt; \WP_Http::BAD_REQUEST ]
			);
		}

		if ( ! $document-&gt;is_editable_by_current_user() ) {
			return new \WP_Error(
				&#039;rest_cannot_view&#039;,
				__( &#039;Sorry, you are not allowed to edit this document.&#039;, &#039;elementor&#039; ),
				[ &#039;status&#039; =&gt; \WP_Http::FORBIDDEN ]
			);
		}

		return $document;
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Felementor%2Fmodules%2Fmcp%2Fabilities'>⬅ Back to Directory</a>