<h2>Editing File: /usr/local/sitepad/editor/site-data/plugins/siteseo-pro/main/abilitiesregister.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php
/*
* SiteSEO PRO
* https://siteseo.io
* (c) SiteSEO Team
*/

namespace SiteSEOPro;

// Are we being accessed directly ?
if(!defined('ABSPATH')){
	die('Hacking Attempt !');
}

/**
 * Registers SiteSEO Pro abilities with the WordPress 6.9+ Abilities API.
 */
class AbilitiesRegister{

	/**
	 * Register the SiteSEO Pro ability categories.
	 *
	 * @return void
	 */
	static function register_categories(){
		$categories = [
			'siteseo-robots' =&gt; __('SiteSEO — Robots.txt', 'siteseo-pro'),
		];

		foreach($categories as $slug =&gt; $label){
			wp_register_ability_category($slug, [
				'label'       =&gt; $label,
				'description' =&gt; __('SEO management abilities provided by SiteSEO.', 'siteseo-pro'),
			]);
		}
	}

	/**
	 * Register all SiteSEO Pro abilities.
	 *
	 * @return void
	 */
	static function register_abilities(){
		self::register_robots_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; [],
		];
	}

	// =========================================================================
	// Permission callbacks
	// =========================================================================

	/**
	 * @return bool
	 */
	public static function can_manage_options(){
		return current_user_can('manage_options');
	}

	// =========================================================================
	// Robots abilities
	// =========================================================================

	protected static function robots_rule_schema(){
		return [
			'type'       =&gt; 'object',
			'properties' =&gt; [
				'user_agent'  =&gt; ['type' =&gt; 'string'],
				'directive'   =&gt; [
					'type' =&gt; 'string',
					'enum' =&gt; ['allow', 'disallow'],
				],
				'field_value' =&gt; ['type' =&gt; 'string'],
			],
		];
	}

	protected static function register_robots_abilities(){
		// siteseo-robots/output-get
		wp_register_ability('siteseo-robots/output-get', [
			'label'               =&gt; __('Get Robots.txt Output', 'siteseo-pro'),
			'description'         =&gt; __('Returns the active robots.txt content that SiteSEO is serving for this site, including custom rules and WordPress defaults.', 'siteseo-pro'),
			'category'            =&gt; 'siteseo-robots',
			'input_schema'        =&gt; self::no_input_schema(),
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; ['content' =&gt; ['type' =&gt; 'string']],
			],
			'execute_callback'    =&gt; '\SiteSEOPro\AbilitiesRegister::get_robots_output',
			'permission_callback' =&gt; '\SiteSEOPro\AbilitiesRegister::can_manage_options',
			'meta'                =&gt; self::readonly_meta(),
		]);

		// siteseo-robots/rules-list
		wp_register_ability('siteseo-robots/rules-list', [
			'label'               =&gt; __('List Robots.txt Rules', 'siteseo-pro'),
			'description'         =&gt; __('Lists the parsed custom robots.txt rules (User-agent / Directive / Path) from the physical robots.txt file.', 'siteseo-pro'),
			'category'            =&gt; 'siteseo-robots',
			'input_schema'        =&gt; self::no_input_schema(),
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; [
					'rules' =&gt; [
						'type'  =&gt; 'array',
						'items' =&gt; self::robots_rule_schema(),
					],
				],
			],
			'execute_callback'    =&gt; '\SiteSEOPro\AbilitiesRegister::list_robots_rules',
			'permission_callback' =&gt; '\SiteSEOPro\AbilitiesRegister::can_manage_options',
			'meta'                =&gt; self::readonly_meta(),
		]);

		// siteseo-robots/rules-add
		wp_register_ability('siteseo-robots/rules-add', [
			'label'               =&gt; __('Add Robots.txt Rule', 'siteseo-pro'),
			'description'         =&gt; __('Adds a new custom robots.txt rule for a given user agent. Directive must be &quot;allow&quot; or &quot;disallow&quot;.', 'siteseo-pro'),
			'category'            =&gt; 'siteseo-robots',
			'input_schema'        =&gt; [
				'type'                 =&gt; 'object',
				'properties'           =&gt; [
					'user_agent'  =&gt; [
						'type'        =&gt; 'string',
						'description' =&gt; __('User-agent the rule applies to (e.g. &quot;*&quot;, &quot;Googlebot&quot;).', 'siteseo-pro'),
					],
					'directive'   =&gt; [
						'type' =&gt; 'string',
						'enum' =&gt; ['allow', 'disallow'],
					],
					'field_value' =&gt; [
						'type'        =&gt; 'string',
						'description' =&gt; __('Path or pattern the directive applies to (e.g. &quot;/private/&quot;).', 'siteseo-pro'),
					],
				],
				'required'             =&gt; ['user_agent', 'directive', 'field_value'],
				'additionalProperties' =&gt; false,
			],
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; ['rule' =&gt; self::robots_rule_schema()],
			],
			'execute_callback'    =&gt; '\SiteSEOPro\AbilitiesRegister::add_robots_rule',
			'permission_callback' =&gt; '\SiteSEOPro\AbilitiesRegister::can_manage_options',
			'meta'                =&gt; [
				'show_in_rest' =&gt; true,
				'mcp'          =&gt; ['public' =&gt; true],
			],
		]);

		// siteseo-robots/rules-delete
		wp_register_ability('siteseo-robots/rules-delete', [
			'label'               =&gt; __('Delete Robots.txt Rule', 'siteseo-pro'),
			'description'         =&gt; __('Deletes a custom robots.txt rule (a User-agent / Directive / Path line) from the physical robots.txt file.', 'siteseo-pro'),
			'category'            =&gt; 'siteseo-robots',
			'input_schema'        =&gt; [
				'type'                 =&gt; 'object',
				'properties'           =&gt; [
					'user_agent'  =&gt; ['type' =&gt; 'string'],
					'directive'   =&gt; [
						'type' =&gt; 'string',
						'enum' =&gt; ['allow', 'disallow'],
					],
					'field_value' =&gt; ['type' =&gt; 'string'],
				],
				'required'             =&gt; ['user_agent', 'directive', 'field_value'],
				'additionalProperties' =&gt; false,
			],
			'output_schema'       =&gt; [
				'type'       =&gt; 'object',
				'properties' =&gt; ['deleted' =&gt; ['type' =&gt; 'boolean']],
			],
			'execute_callback'    =&gt; '\SiteSEOPro\AbilitiesRegister::delete_robots_rule',
			'permission_callback' =&gt; '\SiteSEOPro\AbilitiesRegister::can_manage_options',
			'meta'                =&gt; [
				'annotations'  =&gt; ['destructive' =&gt; true],
				'show_in_rest' =&gt; true,
				'mcp'          =&gt; ['public' =&gt; true],
			],
		]);
	}

	// =========================================================================
	// Execute callbacks — Robots
	// =========================================================================

	/**
	 * Get the contents of the physical robots.txt file (falls back to WP's
	 * virtual output when the file is absent).
	 *
	 * @return array
	 */
	protected static function get_robots_file_content(){
		$path = ABSPATH . 'robots.txt';

		if(file_exists($path) &amp;&amp; is_readable($path)){
			$content = file_get_contents($path);
			if(false !== $content){
				return $content;
			}
		}

		// Virtual fallback (same mechanism SiteSEO uses internally).
		if(function_exists('do_robots')){
			ob_start();
			do_robots();
			return (string)ob_get_clean();
		}

		return '';
	}

	/**
	 * Parse the robots.txt content into structured rules.
	 *
	 * @param string $content
	 * @return array
	 */
	protected static function parse_robots_rules($content){
		$rules  = [];
		$agents = ['*'];

		$lines = preg_split('/\r\n|\r|\n/', (string)$content);
		foreach($lines as $line){
			$line = trim($line);
			if('' === $line || '#' === substr($line, 0, 1)){
				continue;
			}

			if(preg_match('/^User-agent:\s*(.+)$/i', $line, $m)){
				$agents = [trim($m[1])];
				continue;
			}

			if(preg_match('/^(Allow|Disallow):\s*(.*)$/i', $line, $m)){
				$directive = strtolower($m[1]);
				$path      = trim($m[2]);
				foreach($agents as $agent){
					$rules[] = [
						'user_agent'  =&gt; $agent,
						'directive'   =&gt; $directive,
						'field_value' =&gt; $path,
					];
				}
			}
		}

		return $rules;
	}

	/**
	 * Execute callback for siteseo-robots/output-get.
	 *
	 * @return array
	 */
	public static function get_robots_output(){
		return ['content' =&gt; self::get_robots_file_content()];
	}

	/**
	 * Execute callback for siteseo-robots/rules-list.
	 *
	 * @return array
	 */
	public static function list_robots_rules(){
		return ['rules' =&gt; self::parse_robots_rules(self::get_robots_file_content())];
	}

	/**
	 * Execute callback for siteseo-robots/rules-add.
	 *
	 * @param array $input
	 * @return array|\WP_Error
	 */
	public static function add_robots_rule($input){
		$input = is_array($input) ? $input : [];

		$user_agent  = isset($input['user_agent']) ? sanitize_text_field($input['user_agent']) : '';
		$directive   = isset($input['directive']) ? strtolower(sanitize_text_field($input['directive'])) : '';
		$field_value = isset($input['field_value']) ? sanitize_text_field($input['field_value']) : '';

		if('' === $user_agent || !in_array($directive, ['allow', 'disallow'], true) || '' === $field_value){
			return new \WP_Error('invalid_input', __('user_agent, directive (allow|disallow) and field_value are required.', 'siteseo-pro'));
		}

		$path  = ABSPATH . 'robots.txt';
		$line  = ucfirst($directive) . ': ' . $field_value . &quot;\n&quot;;

		if(file_exists($path) &amp;&amp; is_writable($path)){
			$existing = file_get_contents($path);
			if(false !== $existing &amp;&amp; stripos($existing, 'User-agent: ' . $user_agent) !== false){
				// Insert after the matching User-agent block.
				$existing = preg_replace_callback(
					'/(User-agent:\s*' . preg_quote($user_agent, '/') . '[^\n]*\n)((?:[^\n]*\n)*?)(?=(?:User-agent:|$))/i',
					function($m) use ($line){
						return $m[1] . $m[2] . $line;
					},
					$existing,
					1
				);
				file_put_contents($path, $existing);
			}else{
				file_put_contents($path, &quot;\nUser-agent: &quot; . $user_agent . &quot;\n&quot; . $line, FILE_APPEND);
			}
		}else{
			// Create the file with the new rule.
			file_put_contents($path, &quot;User-agent: &quot; . $user_agent . &quot;\n&quot; . $line);
		}

		return [
			'rule' =&gt; [
				'user_agent'  =&gt; $user_agent,
				'directive'   =&gt; $directive,
				'field_value' =&gt; $field_value,
			],
		];
	}

	/**
	 * Execute callback for siteseo-robots/rules-delete.
	 *
	 * @param array $input
	 * @return array|\WP_Error
	 */
	public static function delete_robots_rule($input){
		$input = is_array($input) ? $input : [];

		$user_agent  = isset($input['user_agent']) ? sanitize_text_field($input['user_agent']) : '';
		$directive   = isset($input['directive']) ? strtolower(sanitize_text_field($input['directive'])) : '';
		$field_value = isset($input['field_value']) ? sanitize_text_field($input['field_value']) : '';

		if('' === $user_agent || !in_array($directive, ['allow', 'disallow'], true) || '' === $field_value){
			return new \WP_Error('invalid_input', __('user_agent, directive (allow|disallow) and field_value are required.', 'siteseo-pro'));
		}

		$path = ABSPATH . 'robots.txt';
		if(!file_exists($path) || !is_writable($path)){
			return new \WP_Error('no_file', __('robots.txt file does not exist or is not writable.', 'siteseo-pro'));
		}

		$existing = file_get_contents($path);
		$target    = ucfirst($directive) . ': ' . $field_value;
		$lines     = preg_split('/\r\n|\r|\n/', $existing);
		$deleted   = false;
		$agent_seen = false;

		foreach($lines as $i =&gt; $line){
			$trimmed = trim($line);
			if(preg_match('/^User-agent:\s*' . preg_quote($user_agent, '/') . '/i', $trimmed)){
				$agent_seen = true;
				continue;
			}
			if($agent_seen &amp;&amp; 0 === strcasecmp($trimmed, $target)){
				unset($lines[$i]);
				$deleted = true;
				break;
			}
			if($agent_seen &amp;&amp; preg_match('/^User-agent:\s*/i', $trimmed)){
				$agent_seen = false;
			}
		}

		if($deleted){
			file_put_contents($path, implode(&quot;\n&quot;, $lines));
		}

		return ['deleted' =&gt; $deleted];
	}
}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Fsitepad%2Feditor%2Fsite-data%2Fplugins%2Fsiteseo-pro%2Fmain'>Back to Directory</a>