<h2>Editing File: /usr/local/sitepad/editor/site-data/plugins/siteseo/main/abilitiesregister.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php
/*
* SITESEO
* https://siteseo.io
* (c) SITSEO Team
*/

namespace SiteSEO;

// Are we being accessed directly ?
if(!defined('ABSPATH')){
	die('Hacking Attempt !');
}

/**
 * Registers SiteSEO abilities with the WordPress 6.9+ Abilities API.
 *
 * Abilities are exposed at /wp-json/wp-abilities/v1/ when the Abilities API is
 * present, and are surfaced as MCP tools when a compatible MCP adapter
 * (e.g. wordpress/mcp-adapter) is installed.
 *
 * Each execute_callback reads or writes real SiteSEO data (post meta, options,
 * robots.txt, sitemap state) following SiteSEO's own storage conventions.
 */
class AbilitiesRegister{

	/**
	 * Register the SiteSEO ability categories.
	 *
	 * @return void
	 */
	static function register_categories(){
		$categories = [
			'siteseo-posts'    =&gt; __('SiteSEO — Posts', 'siteseo'),
			'siteseo-settings' =&gt; __('SiteSEO — Settings', 'siteseo'),
			'siteseo-audit'    =&gt; __('SiteSEO — Audit', 'siteseo'),
			'siteseo-sitemap'  =&gt; __('SiteSEO — Sitemap', 'siteseo'),
		];

		foreach($categories as $slug =&gt; $label){
			wp_register_ability_category($slug, [
				'label'       =&gt; $label,
				'description' =&gt; __('SEO management abilities provided by SiteSEO.', 'siteseo'),
			]);
		}
	}

	/**
	 * Register all SiteSEO abilities.
	 *
	 * @return void
	 */
	static function register_abilities(){
		self::register_post_abilities();
		self::register_settings_ability();
		self::register_audit_abilities();
		self::register_sitemap_abilities();
	}

	/**
	 * Shared meta block for read-only abilities.
	 *
	 * @return array
	 */
	protected static function readonly_meta(){
		return [
			'annotations'  =&gt; ['readonly' =&gt; true],
			'show_in_rest' =&gt; true,
			'mcp'          =&gt; ['public' =&gt; true],
		];
	}

	/**
	 * Input schema for abilities that take no input.
	 *
	 * @return array
	 */
	protected static function no_input_schema(){
		return [
			'type'                 =&gt; 'object',
			'additionalProperties' =&gt; false,
			'default'              =&gt; [],
		];
	}

	// Whether the XML sitemap module is enabled.
	protected static function is_sitemap_enabled(){
		global $siteseo;

		$toggles = isset($siteseo-&gt;setting_enabled) &amp;&amp; is_array($siteseo-&gt;setting_enabled) ? $siteseo-&gt;setting_enabled : get_option('siteseo_toggle', []);

		$sitemap_settings = isset($siteseo-&gt;sitemap_settings) &amp;&amp; is_array($siteseo-&gt;sitemap_settings) ? $siteseo-&gt;sitemap_settings : get_option('siteseo_xml_sitemap_option_name', []);
		
		return !empty($toggles['toggle-xml-sitemap']) &amp;&amp; !empty($sitemap_settings['xml_sitemap_general_enable']);
	}

	// Read the physical robots.txt file from the site root.
	protected static function get_robots_file_content(){
		if(!defined('ABSPATH')){
			return '';
		}

		$file = ABSPATH . 'robots.txt';

		if(!file_exists($file) || !is_readable($file)){
			return '';
		}

		$content = file_get_contents($file);

		return false === $content ? '' : $content;
	}

	// Parse robots.txt content into a flat list of custom rules.
	protected static function parse_robots_rules($content){
		$rules = [];

		if(!is_string($content) || '' === trim($content)){
			return $rules;
		}

		$lines = preg_split('/\r\n|\r|\n/', $content);
		$user_agents = [];
		$last_was_ua = false;

		foreach($lines as $line){
			$line = trim($line);

			if('' === $line || '#' === $line[0]){
				continue;
			}

			// Strip trailing comments.
			$hash = strpos($line, '#');
			if(false !== $hash){
				$line = trim(substr($line, 0, $hash));
				if('' === $line){
					continue;
				}
			}

			$parts = explode(':', $line, 2);
			if(count($parts) &lt; 2){
				continue;
			}

			$directive = strtolower(trim($parts[0]));
			$value = trim($parts[1]);

			if('user-agent' === $directive){
				// Consecutive user-agent lines share one group; a
				// user-agent line after rules starts a new group.
				if(!$last_was_ua){
					$user_agents = [];
				}

				if('' !== $value &amp;&amp; !in_array($value, $user_agents, true)){
					$user_agents[] = $value;
				}

				$last_was_ua = true;
				continue;
			}

			$last_was_ua = false;

			if('' === $value || !in_array($directive, ['allow', 'disallow', 'crawl-delay'], true)){
				continue;
			}

			foreach($user_agents as $agent){
				$rules[] = [
					'user_agent' =&gt; $agent,
					'type' =&gt; $directive,
					'value' =&gt; $value,
				];
			}
		}

		return $rules;
	}

	// =========================================================================
	// Permission callbacks
	// =========================================================================

	/**
	 * @return bool
	 */
	public static function can_edit_posts(){
		return current_user_can('edit_posts');
	}

	/**
	 * @return bool
	 */
	public static function can_manage_options(){
		return current_user_can('manage_options');
	}

	// =========================================================================
	// Posts abilities
	// =========================================================================

	protected static function register_post_abilities(){
		$post_snapshot_schema = [
			'type'       =&gt; 'object',
			'properties' =&gt; [
				'title'           =&gt; ['type' =&gt; ['string', 'null']],
				'description'     =&gt; ['type' =&gt; ['string', 'null']],
				'canonical_url'   =&gt; ['type' =&gt; ['string', 'null']],
				'focus_keyphrase' =&gt; ['type' =&gt; ['string', 'null']],
				'seo_score'        =&gt; ['type' =&gt; ['string', 'null']],
				'robots'          =&gt; [
					'type'       =&gt; 'object',
					'properties' =&gt; [
						'noindex'      =&gt; ['type' =&gt; 'boolean'],
						'nofollow'     =&gt; ['type' =&gt; 'boolean'],
						'noimageindex' =&gt; ['type' =&gt; 'boolean'],
						'noarchive'    =&gt; ['type' =&gt; 'boolean'],
						'nosnippet'    =&gt; ['type' =&gt; 'boolean'],
					],
				],
				'social'          =&gt; [
					'type'       =&gt; 'object',
					'properties' =&gt; [
						'og_title'            =&gt; ['type' =&gt; ['string', 'null']],
						'og_description'      =&gt; ['type' =&gt; ['string', 'null']],
						'og_image'            =&gt; ['type' =&gt; ['string', 'null']],
						'twitter_title'       =&gt; ['type' =&gt; ['string', 'null']],
						'twitter_description' =&gt; ['type' =&gt; ['string', 'null']],
						'twitter_image'       =&gt; ['type' =&gt; ['string', 'null']],
					],
				],
			],
		];

		// siteseo-posts/seo-data-get
		wp_register_ability('siteseo-posts/seo-data-get', [
			'label'               =&gt; __('Get Post SEO Data', 'siteseo'),
			'description'         =&gt; __('Returns the SEO snapshot for a post: title, meta description, focus keyphrase, robots flags, canonical URL and social meta.', 'siteseo'),
			'category'            =&gt; 'siteseo-posts',
			'input_schema'        =&gt; [
				'type'                 =&gt; 'object',
				'properties'           =&gt; [
					'postId' =&gt; [
						'type'        =&gt; 'integer',
						'description' =&gt; __('The post ID.', 'siteseo'),
					],
				],
				'required'             =&gt; ['postId'],
				'additionalProperties' =&gt; false,
			],
			'output_schema'       =&gt; $post_snapshot_schema,
			'execute_callback'    =&gt; '\SiteSEO\AbilitiesRegister::get_post_seo_data',
			'permission_callback' =&gt; '\SiteSEO\AbilitiesRegister::can_edit_posts',
			'meta'                =&gt; self::readonly_meta(),
		]);

		// siteseo-posts/seo-data-update
		wp_register_ability('siteseo-posts/seo-data-update', [
			'label'               =&gt; __('Update Post SEO Data', 'siteseo'),
			'description'         =&gt; __('Updates SEO fields for a post: title, description, focus keyphrase, robots flags, canonical URL and social meta. Only the fields provided in input are changed; others are preserved.', 'siteseo'),
			'category'            =&gt; 'siteseo-posts',
			'input_schema'        =&gt; [
				'type'                 =&gt; 'object',
				'properties'           =&gt; [
					'postId'        =&gt; [
						'type'        =&gt; 'integer',
						'description' =&gt; __('The post ID.', 'siteseo'),
					],
					'title'         =&gt; ['type' =&gt; ['string', 'null']],
					'description'   =&gt; ['type' =&gt; ['string', 'null']],
					'canonical_url' =&gt; ['type' =&gt; ['string', 'null']],
					'focus_keyphrase' =&gt; ['type' =&gt; ['string', 'null']],
					'robots'        =&gt; [
						'type'                 =&gt; 'object',
						'properties'           =&gt; [
							'noindex'      =&gt; ['type' =&gt; 'boolean'],
							'nofollow'     =&gt; ['type' =&gt; 'boolean'],
							'noimageindex' =&gt; ['type' =&gt; 'boolean'],
							'noarchive'    =&gt; ['type' =&gt; 'boolean'],
							'nosnippet'    =&gt; ['type' =&gt; 'boolean'],
						],
						'additionalProperties' =&gt; false,
					],
					'social'        =&gt; [
						'type'                 =&gt; 'object',
						'properties'           =&gt; [
							'og_title'            =&gt; ['type' =&gt; ['string', 'null']],
							'og_description'      =&gt; ['type' =&gt; ['string', 'null']],
							'og_image'            =&gt; ['type' =&gt; ['string', 'null']],
							'twitter_title'       =&gt; ['type' =&gt; ['string', 'null']],
							'twitter_description' =&gt; ['type' =&gt; ['string', 'null']],
							'twitter_image'       =&gt; ['type' =&gt; ['string', 'null']],
						],
						'additionalProperties' =&gt; false,
					],
				],
				'required'             =&gt; ['postId'],
				'additionalProperties' =&gt; false,
			],
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; [
					'updated' =&gt; ['type' =&gt; 'boolean'],
					'post'    =&gt; $post_snapshot_schema,
				],
			],
			'execute_callback'    =&gt; '\SiteSEO\AbilitiesRegister::update_post_seo_data',
			'permission_callback' =&gt; '\SiteSEO\AbilitiesRegister::can_edit_posts',
			'meta'                =&gt; [
				'show_in_rest' =&gt; true,
				'mcp'          =&gt; ['public' =&gt; true],
			],
		]);

		// siteseo-posts/list-missing-seo
		wp_register_ability('siteseo-posts/list-missing-seo', [
			'label'               =&gt; __('List Posts Missing SEO Data', 'siteseo'),
			'description'         =&gt; __('Returns posts where one or more SEO fields are unset (title, description, or focus keyphrase). Useful for &quot;which posts need SEO attention?&quot; prompts.', 'siteseo'),
			'category'            =&gt; 'siteseo-posts',
			'input_schema'        =&gt; [
				'type'                 =&gt; 'object',
				'properties'           =&gt; [
					'missing_fields' =&gt; [
						'type'    =&gt; 'array',
						'items'   =&gt; [
							'type' =&gt; 'string',
							'enum' =&gt; ['title', 'description', 'focus_keyphrase'],
						],
						'default' =&gt; ['focus_keyphrase'],
					],
					'post_type'      =&gt; [
						'type'  =&gt; 'array',
						'items' =&gt; ['type' =&gt; 'string'],
					],
					'status'         =&gt; [
						'type'    =&gt; 'array',
						'items'   =&gt; ['type' =&gt; 'string'],
						'default' =&gt; ['publish'],
					],
					'limit'          =&gt; [
						'type'    =&gt; 'integer',
						'minimum' =&gt; 1,
						'maximum' =&gt; 100,
						'default' =&gt; 20,
					],
					'offset'         =&gt; [
						'type'    =&gt; 'integer',
						'minimum' =&gt; 0,
						'default' =&gt; 0,
					],
				],
				'additionalProperties' =&gt; false,
				'default'              =&gt; [],
			],
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; [
					'posts' =&gt; [
						'type'  =&gt; 'array',
						'items' =&gt; [
							'type'       =&gt; 'object',
							'properties' =&gt; [
								'id'            =&gt; ['type' =&gt; 'integer'],
								'post_title'    =&gt; ['type' =&gt; 'string'],
								'post_type'     =&gt; ['type' =&gt; 'string'],
								'status'        =&gt; ['type' =&gt; 'string'],
								'permalink'     =&gt; ['type' =&gt; ['string', 'null']],
								'missing_fields' =&gt; [
									'type'  =&gt; 'array',
									'items' =&gt; ['type' =&gt; 'string'],
								],
							],
						],
					],
					'total' =&gt; ['type' =&gt; 'integer'],
				],
			],
			'execute_callback'    =&gt; '\SiteSEO\AbilitiesRegister::list_posts_missing_seo',
			'permission_callback' =&gt; '\SiteSEO\AbilitiesRegister::can_edit_posts',
			'meta'                =&gt; self::readonly_meta(),
		]);

		// siteseo-posts/list-score
		wp_register_ability('siteseo-posts/list-score', [
			'label'               =&gt; __('List Posts by SEO Score', 'siteseo'),
			'description'         =&gt; __('Returns posts with their cached SEO content-analysis score. Useful for finding the worst (or best) performing content.', 'siteseo'),
			'category'            =&gt; 'siteseo-posts',
			'input_schema'        =&gt; [
				'type'                 =&gt; 'object',
				'properties'           =&gt; [
					'post_type' =&gt; [
						'type'  =&gt; 'array',
						'items' =&gt; ['type' =&gt; 'string'],
					],
					'status'    =&gt; [
						'type'    =&gt; 'array',
						'items'   =&gt; ['type' =&gt; 'string'],
						'default' =&gt; ['publish'],
					],
					'limit'     =&gt; [
						'type'    =&gt; 'integer',
						'minimum' =&gt; 1,
						'maximum' =&gt; 100,
						'default' =&gt; 20,
					],
					'offset'    =&gt; [
						'type'    =&gt; 'integer',
						'minimum' =&gt; 0,
						'default' =&gt; 0,
					],
				],
				'additionalProperties' =&gt; false,
				'default'              =&gt; [],
			],
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; [
					'posts' =&gt; [
						'type'  =&gt; 'array',
						'items' =&gt; [
							'type'       =&gt; 'object',
							'properties' =&gt; [
								'id'         =&gt; ['type' =&gt; 'integer'],
								'post_title' =&gt; ['type' =&gt; 'string'],
								'post_type'  =&gt; ['type' =&gt; 'string'],
								'status'     =&gt; ['type' =&gt; 'string'],
								'permalink'  =&gt; ['type' =&gt; ['string', 'null']],
								'seo_score'  =&gt; ['type' =&gt; ['string', 'null']],
							],
						],
					],
					'total' =&gt; ['type' =&gt; 'integer'],
				],
			],
			'execute_callback'    =&gt; '\SiteSEO\AbilitiesRegister::list_posts_by_score',
			'permission_callback' =&gt; '\SiteSEO\AbilitiesRegister::can_edit_posts',
			'meta'                =&gt; self::readonly_meta(),
		]);
	}

	// =========================================================================
	// Settings ability
	// =========================================================================

	protected static function register_settings_ability(){
		wp_register_ability('siteseo-settings/get', [
			'label'               =&gt; __('Get SiteSEO Settings', 'siteseo'),
			'description'         =&gt; __('Returns the SiteSEO settings tree (titles, social, advanced, sitemap, analytics). Read-only: settings cannot be modified via abilities — use the SiteSEO admin UI.', 'siteseo'),
			'category'            =&gt; 'siteseo-settings',
			'input_schema'        =&gt; self::no_input_schema(),
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; [
					'settings' =&gt; [
						'type'        =&gt; 'object',
						'description' =&gt; __('The SiteSEO settings tree. Shape is internal; treat as opaque structured data.', 'siteseo'),
					],
				],
			],
			'execute_callback'    =&gt; '\SiteSEO\AbilitiesRegister::get_settings',
			'permission_callback' =&gt; '\SiteSEO\AbilitiesRegister::can_manage_options',
			'meta'                =&gt; self::readonly_meta(),
		]);
	}



	// =========================================================================
	// Audit abilities
	// =========================================================================

	protected static function register_audit_abilities(){
		// siteseo-audit/homepage-get
		wp_register_ability('siteseo-audit/homepage-get', [
			'label'               =&gt; __('Get Homepage SEO Audit', 'siteseo'),
			'description'         =&gt; __('Returns an SEO snapshot of the homepage: title, meta description, robots flags, social meta and a content-analysis score (when cached).', 'siteseo'),
			'category'            =&gt; 'siteseo-audit',
			'input_schema'        =&gt; self::no_input_schema(),
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; [
					'url'         =&gt; ['type' =&gt; 'string'],
					'title'       =&gt; ['type' =&gt; ['string', 'null']],
					'description' =&gt; ['type' =&gt; ['string', 'null']],
					'seo_score'   =&gt; ['type' =&gt; ['string', 'null']],
					'robots'      =&gt; ['type' =&gt; 'string'],
				],
			],
			'execute_callback'    =&gt; '\SiteSEO\AbilitiesRegister::get_homepage_audit',
			'permission_callback' =&gt; '\SiteSEO\AbilitiesRegister::can_manage_options',
			'meta'                =&gt; self::readonly_meta(),
		]);

		// siteseo-audit/site-get
		wp_register_ability('siteseo-audit/site-get', [
			'label'               =&gt; __('Get Site SEO Audit', 'siteseo'),
			'description'         =&gt; __('Returns a site-wide SEO health snapshot: homepage score, sitemap on/off, sitemap index URL, custom robots rule count and public post type list.', 'siteseo'),
			'category'            =&gt; 'siteseo-audit',
			'input_schema'        =&gt; self::no_input_schema(),
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; [
					'sitemap_enabled'           =&gt; ['type' =&gt; 'boolean'],
					'sitemap_index_url'         =&gt; ['type' =&gt; ['string', 'null']],
					'custom_robots_rules_count' =&gt; ['type' =&gt; 'integer'],
					'public_post_types'         =&gt; [
						'type'  =&gt; 'array',
						'items' =&gt; ['type' =&gt; 'string'],
					],
					'homepage_url'              =&gt; ['type' =&gt; 'string'],
				],
			],
			'execute_callback'    =&gt; '\SiteSEO\AbilitiesRegister::get_site_audit',
			'permission_callback' =&gt; '\SiteSEO\AbilitiesRegister::can_manage_options',
			'meta'                =&gt; self::readonly_meta(),
		]);
	}

	// =========================================================================
	// Sitemap abilities
	// =========================================================================

	protected static function register_sitemap_abilities(){
		// siteseo-sitemap/status-get
		wp_register_ability('siteseo-sitemap/status-get', [
			'label'               =&gt; __('Get Sitemap Status', 'siteseo'),
			'description'         =&gt; __('Returns the SiteSEO sitemap state: whether the XML sitemap is enabled, and the sitemap index URL.', 'siteseo'),
			'category'            =&gt; 'siteseo-sitemap',
			'input_schema'        =&gt; self::no_input_schema(),
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; [
					'enabled'  =&gt; ['type' =&gt; 'boolean'],
					'index_url' =&gt; ['type' =&gt; ['string', 'null']],
				],
			],
			'execute_callback'    =&gt; '\SiteSEO\AbilitiesRegister::get_sitemap_status',
			'permission_callback' =&gt; '\SiteSEO\AbilitiesRegister::can_manage_options',
			'meta'                =&gt; self::readonly_meta(),
		]);
	}

	// =========================================================================
	// Execute callbacks — Posts
	// =========================================================================

	/**
	 * Build a post SEO snapshot from post meta.
	 *
	 * @param int $post_id
	 * @return array
	 */
	protected static function post_snapshot($post_id){
		$post_id = (int)$post_id;

		return [
			'title'           =&gt; get_post_meta($post_id, '_siteseo_titles_title', true) ?: null,
			'description'     =&gt; get_post_meta($post_id, '_siteseo_titles_desc', true) ?: null,
			'canonical_url'   =&gt; get_post_meta($post_id, '_siteseo_robots_canonical', true) ?: null,
			'focus_keyphrase' =&gt; get_post_meta($post_id, '_siteseo_analysis_target_kw', true) ?: null,
			'seo_score'       =&gt; self::post_score($post_id),
			'robots'          =&gt; [
				'noindex'      =&gt; 'yes' === get_post_meta($post_id, '_siteseo_robots_index', true),
				'nofollow'     =&gt; 'yes' === get_post_meta($post_id, '_siteseo_robots_follow', true),
				'noimageindex' =&gt; 'yes' === get_post_meta($post_id, '_siteseo_robots_imageindex', true),
				'noarchive'    =&gt; 'yes' === get_post_meta($post_id, '_siteseo_robots_archive', true),
				'nosnippet'    =&gt; 'yes' === get_post_meta($post_id, '_siteseo_robots_snippet', true),
			],
			'social'          =&gt; [
				'og_title'            =&gt; get_post_meta($post_id, '_siteseo_social_fb_title', true) ?: null,
				'og_description'      =&gt; get_post_meta($post_id, '_siteseo_social_fb_desc', true) ?: null,
				'og_image'            =&gt; get_post_meta($post_id, '_siteseo_social_fb_img', true) ?: null,
				'twitter_title'       =&gt; get_post_meta($post_id, '_siteseo_social_twitter_title', true) ?: null,
				'twitter_description' =&gt; get_post_meta($post_id, '_siteseo_social_twitter_desc', true) ?: null,
				'twitter_image'       =&gt; get_post_meta($post_id, '_siteseo_social_twitter_img', true) ?: null,
			],
		];
	}

	/**
	 * Read the cached SEO content-analysis score for a post.
	 *
	 * @param int $post_id
	 * @return string|null
	 */
	protected static function post_score($post_id){
		$api = get_post_meta($post_id, '_siteseo_content_analysis_api', true);
		if(is_array($api) &amp;&amp; isset($api['score'])){
			return (string)$api['score'];
		}

		$data = get_post_meta($post_id, '_siteseo_analysis_data', true);
		if(is_array($data) &amp;&amp; isset($data[0]['score'])){
			return $data[0]['score'] === 1 ? 'good' : 'bad';
		}

		return null;
	}

	/**
	 * Execute callback for siteseo-posts/seo-data-get.
	 *
	 * @param array $input
	 * @return array|\WP_Error
	 */
	public static function get_post_seo_data($input){
		$post_id = isset($input['postId']) ? (int)$input['postId'] : 0;

		if(!$post_id || !get_post($post_id)){
			return new \WP_Error('invalid_post', __('Post not found.', 'siteseo'));
		}

		return self::post_snapshot($post_id);
	}

	/**
	 * Execute callback for siteseo-posts/seo-data-update.
	 *
	 * @param array $input
	 * @return array|\WP_Error
	 */
	public static function update_post_seo_data($input){
		$input  = is_array($input) ? $input : [];
		$post_id = isset($input['postId']) ? (int)$input['postId'] : 0;

		if(!$post_id || !get_post($post_id)){
			return new \WP_Error('invalid_post', __('Post not found.', 'siteseo'));
		}

		if(!current_user_can('edit_post', $post_id)){
			return new \WP_Error('forbidden', __('You cannot edit this post.', 'siteseo'));
		}

		$meta_map = [
			'title'           =&gt; '_siteseo_titles_title',
			'description'     =&gt; '_siteseo_titles_desc',
			'canonical_url'   =&gt; '_siteseo_robots_canonical',
			'focus_keyphrase' =&gt; '_siteseo_analysis_target_kw',
		];

		foreach($meta_map as $field =&gt; $meta_key){
			if(array_key_exists($field, $input)){
				$value = $input[$field];
				if(null === $value){
					delete_post_meta($post_id, $meta_key);
				}else{
					update_post_meta($post_id, $meta_key, sanitize_text_field($value));
				}
			}
		}

		$robots_map = [
			'noindex'      =&gt; '_siteseo_robots_index',
			'nofollow'     =&gt; '_siteseo_robots_follow',
			'noimageindex' =&gt; '_siteseo_robots_imageindex',
			'noarchive'    =&gt; '_siteseo_robots_archive',
			'nosnippet'    =&gt; '_siteseo_robots_snippet',
		];

		if(isset($input['robots']) &amp;&amp; is_array($input['robots'])){
			foreach($robots_map as $flag =&gt; $meta_key){
				if(array_key_exists($flag, $input['robots'])){
					if($input['robots'][$flag]){
						update_post_meta($post_id, $meta_key, 'yes');
					}else{
						delete_post_meta($post_id, $meta_key);
					}
				}
			}
		}

		$social_map = [
			'og_title'            =&gt; '_siteseo_social_fb_title',
			'og_description'      =&gt; '_siteseo_social_fb_desc',
			'og_image'            =&gt; '_siteseo_social_fb_img',
			'twitter_title'       =&gt; '_siteseo_social_twitter_title',
			'twitter_description' =&gt; '_siteseo_social_twitter_desc',
			'twitter_image'       =&gt; '_siteseo_social_twitter_img',
		];

		if(isset($input['social']) &amp;&amp; is_array($input['social'])){
			foreach($social_map as $field =&gt; $meta_key){
				if(array_key_exists($field, $input['social'])){
					$value = $input['social'][$field];
					if(null === $value){
						delete_post_meta($post_id, $meta_key);
					}else{
						update_post_meta($post_id, $meta_key, sanitize_text_field($value));
					}
				}
			}
		}

		return [
			'updated' =&gt; true,
			'post'    =&gt; self::post_snapshot($post_id),
		];
	}

	/**
	 * Execute callback for siteseo-posts/list-missing-seo.
	 *
	 * @param array $input
	 * @return array
	 */
	public static function list_posts_missing_seo($input){
		$input = is_array($input) ? $input : [];

		$missing_fields = isset($input['missing_fields']) &amp;&amp; is_array($input['missing_fields']) ? $input['missing_fields'] : ['focus_keyphrase'];
		$post_types     = isset($input['post_type']) &amp;&amp; is_array($input['post_type']) ? $input['post_type'] : array_values(get_post_types(['public' =&gt; true]));
		$statuses       = isset($input['status']) &amp;&amp; is_array($input['status']) ? $input['status'] : ['publish'];
		$limit           = isset($input['limit']) ? max(1, min(100, (int)$input['limit'])) : 20;
		$offset          = isset($input['offset']) ? max(0, (int)$input['offset']) : 0;

		$meta_map = [
			'title'           =&gt; '_siteseo_titles_title',
			'description'     =&gt; '_siteseo_titles_desc',
			'focus_keyphrase' =&gt; '_siteseo_analysis_target_kw',
		];

		$query = new \WP_Query([
			'post_type'      =&gt; $post_types,
			'post_status'    =&gt; $statuses,
			'posts_per_page' =&gt; $limit,
			'offset'         =&gt; $offset,
			'orderby'        =&gt; 'date',
			'order'          =&gt; 'DESC',
			'fields'         =&gt; 'ids',
		]);

		$posts = [];
		$total = $query-&gt;found_posts;

		foreach($query-&gt;posts as $post_id){
			$post_missing = [];
			foreach($missing_fields as $field){
				if(!isset($meta_map[$field])){
					continue;
				}
				$value = get_post_meta($post_id, $meta_map[$field], true);
				if('' === $value || null === $value){
					$post_missing[] = $field;
				}
			}

			if(!empty($post_missing)){
				$post = get_post($post_id);
				$posts[] = [
					'id'             =&gt; $post_id,
					'post_title'     =&gt; $post ? $post-&gt;post_title : '',
					'post_type'      =&gt; $post ? $post-&gt;post_type : '',
					'status'         =&gt; $post ? $post-&gt;post_status : '',
					'permalink'      =&gt; get_permalink($post_id) ?: null,
					'missing_fields' =&gt; $post_missing,
				];
			}
		}

		return [
			'posts' =&gt; $posts,
			'total' =&gt; $total,
		];
	}

	/**
	 * Execute callback for siteseo-posts/list-score.
	 *
	 * @param array $input
	 * @return array
	 */
	public static function list_posts_by_score($input){
		$input = is_array($input) ? $input : [];

		$post_types = isset($input['post_type']) &amp;&amp; is_array($input['post_type']) ? $input['post_type'] : array_values(get_post_types(['public' =&gt; true]));
		$statuses   = isset($input['status']) &amp;&amp; is_array($input['status']) ? $input['status'] : ['publish'];
		$limit       = isset($input['limit']) ? max(1, min(100, (int)$input['limit'])) : 20;
		$offset      = isset($input['offset']) ? max(0, (int)$input['offset']) : 0;

		$query = new \WP_Query([
			'post_type'      =&gt; $post_types,
			'post_status'    =&gt; $statuses,
			'posts_per_page' =&gt; $limit,
			'offset'         =&gt; $offset,
			'orderby'        =&gt; 'date',
			'order'          =&gt; 'DESC',
			'fields'         =&gt; 'ids',
		]);

		$posts = [];
		foreach($query-&gt;posts as $post_id){
			$post = get_post($post_id);
			$posts[] = [
				'id'         =&gt; $post_id,
				'post_title' =&gt; $post ? $post-&gt;post_title : '',
				'post_type'  =&gt; $post ? $post-&gt;post_type : '',
				'status'     =&gt; $post ? $post-&gt;post_status : '',
				'permalink'  =&gt; get_permalink($post_id) ?: null,
				'seo_score'  =&gt; self::post_score($post_id),
			];
		}

		return [
			'posts' =&gt; $posts,
			'total' =&gt; $query-&gt;found_posts,
		];
	}

	// =========================================================================
	// Execute callbacks — Settings
	// =========================================================================

	/**
	 * Execute callback for siteseo-settings/get.
	 *
	 * @return array
	 */
	public static function get_settings(){
		return [
			'settings' =&gt; [
				'titles'    =&gt; get_option('siteseo_titles_option_name', []),
				'social'    =&gt; get_option('siteseo_social_option_name', []),
				'advanced'  =&gt; get_option('siteseo_advanced_option_name', []),
				'sitemap'   =&gt; get_option('siteseo_xml_sitemap_option_name', []),
				'analytics' =&gt; get_option('siteseo_google_analytics_option_name', []),
				'toggles'   =&gt; get_option('siteseo_toggle', []),
			],
		];
	}



	// =========================================================================
	// Execute callbacks — Audit
	// =========================================================================

	/**
	 * Execute callback for siteseo-audit/homepage-get.
	 *
	 * @return array
	 */
	public static function get_homepage_audit(){
		$home_id = (int)get_option('page_on_front');

		$snapshot = [
			'url'         =&gt; home_url('/'),
			'title'       =&gt; null,
			'description' =&gt; null,
			'seo_score'   =&gt; null,
			'robots'      =&gt; '',
		];

		if($home_id){
			$snapshot['title']       = get_post_meta($home_id, '_siteseo_titles_title', true) ?: null;
			$snapshot['description'] = get_post_meta($home_id, '_siteseo_titles_desc', true) ?: null;
			$snapshot['seo_score']   = self::post_score($home_id);

			$robots = [];
			if('yes' === get_post_meta($home_id, '_siteseo_robots_index', true)){
				$robots[] = 'noindex';
			}
			if('yes' === get_post_meta($home_id, '_siteseo_robots_follow', true)){
				$robots[] = 'nofollow';
			}
			$snapshot['robots'] = implode(', ', $robots);
		}

		return $snapshot;
	}

	/**
	 * Execute callback for siteseo-audit/site-get.
	 *
	 * @return array
	 */
	public static function get_site_audit(){

		$sitemap_enabled = self::is_sitemap_enabled();

		$sitemap_index_url = $sitemap_enabled ? home_url('/sitemaps.xml') : null;

		$rules = self::parse_robots_rules(self::get_robots_file_content());

		$post_types = array_values(get_post_types(['public' =&gt; true]));

		return [
			'sitemap_enabled'           =&gt; $sitemap_enabled,
			'sitemap_index_url'         =&gt; $sitemap_index_url,
			'custom_robots_rules_count' =&gt; count($rules),
			'public_post_types'         =&gt; $post_types,
			'homepage_url'              =&gt; home_url('/'),
		];
	}

	// =========================================================================
	// Execute callbacks — Sitemap
	// =========================================================================

	/**
	 * Execute callback for siteseo-sitemap/status-get.
	 *
	 * @return array
	 */
	public static function get_sitemap_status(){

		$enabled = self::is_sitemap_enabled();

		$index_url = $enabled ? home_url('/sitemaps.xml') : null;

		return [
			'enabled'   =&gt; $enabled,
			'index_url' =&gt; $index_url,
		];
	}
}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Fsitepad%2Feditor%2Fsite-data%2Fplugins%2Fsiteseo%2Fmain'>Back to Directory</a>