class-abilities.php

Abilities Class for registering plugin capabilities with the WP 7.0 Abilities API.

Source includes/Admin/class-abilities.php7 min readPart of Performance Optimisation

includes/Admin/class-abilities.php

Abilities Class for registering plugin capabilities with the WP 7.0 Abilities API.

Namespace: PerformanceOptimise\\Inc · Lines: 1422

Class Abilities

Class Abilities

Source: includes/Admin/class-abilities.php, line 27

class Abilities

Tags: @since 2.0.0

public __construct()

public function __construct()

Register hooks for the Abilities API.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 34

public register_categories()

public function register_categories(): void

Register the performance-optimisation ability category.

Return: void.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 47

public register_abilities()

public function register_abilities(): void

Register all plugin abilities with the Abilities API.

Return: void.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 67

private get_ability_definitions()

private function get_ability_definitions(): array

Get the definitions for all registered abilities.

Return: array[] — Array of ability definition arrays, each with \’id\’ and \’args\’.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 86

private get_operational_abilities()

private function get_operational_abilities(): array

Get operational ability definitions that delegate to REST service methods.

Return: array[] — Operational ability definitions.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 194

publicstatic permission_check()

public static function permission_check(): bool

Permission callback for all abilities.

Return: bool — Whether the current user can manage options with a valid nonce.

Tags: @since 2.0.0 · @since NEXT Delegates capability and nonce decisions to Admin_Auth.

Source: includes/Admin/class-abilities.php, line 589

publicstatic can_cache_management()

public static function can_cache_management(): bool

Execute callback: Cache Management.

Return: bool.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 599

publicstatic can_image_optimization()

public static function can_image_optimization(): bool

Execute callback: Image Optimization.

Return: bool.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 610

publicstatic can_css_minification()

public static function can_css_minification(): bool

Execute callback: CSS Minification.

Return: bool.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 621

publicstatic can_js_optimization()

public static function can_js_optimization(): bool

Execute callback: JS Optimization.

Return: bool.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 632

publicstatic can_database_cleanup()

public static function can_database_cleanup(): bool

Execute callback: Database Cleanup.

Return: bool.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 643

publicstatic can_redis_object_cache()

public static function can_redis_object_cache(): bool

Execute callback: Redis Object Cache.

Return: bool.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 654

publicstatic execute_clear_cache()

public static function execute_clear_cache(array=array() $input): array

Execute callback: Clear Cache (operational).

ParameterTypeDefaultDescription
$inputarray=array()—Input data (scope, url).

Return: array{cleared: — bool}.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 668

publicstatic execute_optimise_image()

public static function execute_optimise_image(array $input): array

Execute callback: Optimise Image (operational).

ParameterTypeDefaultDescription
$inputarray—Input data (attachment_id, format).

Return: array{queued: — bool}.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 705

publicstatic execute_database_cleanup()

public static function execute_database_cleanup(array $input): array

Execute callback: Run Database Cleanup (operational).

ParameterTypeDefaultDescription
$inputarray—Input data (type).

Return: array{cleaned: — int}.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 730

publicstatic execute_get_system_info()

public static function execute_get_system_info(array=array() $input): array

Execute callback: Get System Info (operational).

ParameterTypeDefaultDescription
$inputarray=array()—Unused input data.

Return: array — System information.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 747

privatestatic resolve_input_url()

private static function resolve_input_url(array $input): string

Resolve the caller URL input: empty/missing falls back to home, a provided URL must be same-site (audit #1357 review).

ParameterTypeDefaultDescription
$inputarray—Ability input.

Return: string — Resolved URL, or \’\’ when a provided URL is off-site.

Tags: @since 2.2.0

Source: includes/Admin/class-abilities.php, line 762

privatestatic same_site_url_or_home()

private static function same_site_url_or_home(string $url, string $fallback): string

Validate a caller-supplied URL as same-site, else the fallback.

ParameterTypeDefaultDescription
$urlstring—Caller URL (already esc_url_raw\’d by caller).
$fallbackstring—Fallback (home URL, or \’\’ to fail closed).

Return: string — Same-site URL or the fallback.

Tags: @since 2.2.0

Source: includes/Admin/class-abilities.php, line 781

publicstatic execute_run_performance_scan()

public static function execute_run_performance_scan(array $input): array

Execute callback: Run Performance Scan (operational).

ParameterTypeDefaultDescription
$inputarray—Input data (url).

Return: array — Scan results or error.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 802

publicstatic execute_queue_pagespeed_scan()

public static function execute_queue_pagespeed_scan(array $input): array

Execute callback: Queue PageSpeed Scan (operational).

ParameterTypeDefaultDescription
$inputarray—Input data (url, strategy).

Return: array{queued: — bool}.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 824

publicstatic execute_get_pagespeed_results()

public static function execute_get_pagespeed_results(array $input): array

Execute callback: Get PageSpeed Results (operational).

ParameterTypeDefaultDescription
$inputarray—Input data (url, strategy).

Return: array — PageSpeed results.

Tags: @since 2.0.0 · @since NEXT Routes the raw result read through Insight_Query.

Source: includes/Admin/class-abilities.php, line 848

publicstatic execute_get_suggestions()

public static function execute_get_suggestions(array $input): array

Execute callback: Get Suggestions (operational).

ParameterTypeDefaultDescription
$inputarray—Input data (url).

Return: array{suggestions: — array} Suggestions.

Tags: @since 2.0.0 · @since NEXT Routes the telemetry read through Insight_Query.

Source: includes/Admin/class-abilities.php, line 869

publicstatic execute_get_database_cleanup_counts()

public static function execute_get_database_cleanup_counts(array=array() $input): array

Execute callback: Get Database Cleanup Counts (operational).

ParameterTypeDefaultDescription
$inputarray=array()—Unused input data.

Return: array — Cleanup counts by type.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 901

publicstatic execute_get_image_job_status()

public static function execute_get_image_job_status(array=array() $input): array

Execute callback: Get Image Job Status (operational).

ParameterTypeDefaultDescription
$inputarray=array()—Unused input data.

Return: array — Image job status.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 915

publicstatic execute_get_page_assets()

public static function execute_get_page_assets(array $input): array

Execute callback: Get Page Assets (operational).

ParameterTypeDefaultDescription
$inputarray—Input data (post_id).

Return: array — Page assets or empty.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 929

publicstatic execute_get_autoloaded_options()

public static function execute_get_autoloaded_options(array=array() $input): array

Execute callback: Get Autoloaded Options (operational).

ParameterTypeDefaultDescription
$inputarray=array()—Unused input data.

Return: array — Autoloaded options data.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 956

publicstatic execute_get_rum_data()

public static function execute_get_rum_data(array=array() $input): array

Execute callback: Get RUM Data (operational).

ParameterTypeDefaultDescription
$inputarray=array()—Unused input data.

Return: array — RUM data.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 1028

publicstatic execute_flush_object_cache()

public static function execute_flush_object_cache(array=array() $input): array

Execute callback: Flush Object Cache (operational).

ParameterTypeDefaultDescription
$inputarray=array()—Unused input data.

Return: array{flushed: — bool, error_code: string|null, error_message: string|null}.

Tags: @since 2.0.0 · @since 2.2.0 Uses Object_Cache::flush_scoped() for multisite scoping. · @since 2.2.0 Returns error_code/error_message on failure so Ability/MCP consumers can distinguish a multisite foreign-drop-in refusal (error_code `flush_foreign_dropin`) from a generic failure instead of retrying blindly. Both are null on success.

Source: includes/Admin/class-abilities.php, line 1045

privatestatic get_wppo_ability_definitions()

private static function get_wppo_ability_definitions(): array

Get WPPO optimization ability definitions for AI/MCP.

Return: array[] — WPPO ability definitions.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 1083

publicstatic register_wppo_abilities()

public static function register_wppo_abilities(): void

Register WPPO optimization abilities for AI/MCP.

Return: void.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 1229

publicstatic execute_regenerate_ccss()

public static function execute_regenerate_ccss(array=array() $input): array

Execute callback: Regenerate Critical CSS (wppo/regenerate-ccss).

ParameterTypeDefaultDescription
$inputarray=array()—Unused input data.

Return: array{queued: — int}.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 1281

publicstatic execute_used_css_regenerate()

public static function execute_used_css_regenerate(array=array() $input): array

Execute callback: Regenerate Used CSS (wppo/used-css-regenerate).

ParameterTypeDefaultDescription
$inputarray=array()—Input data (post_id).

Return: array{queued: — int}.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 1304

publicstatic execute_crawler()

public static function execute_crawler(array=array() $input): array

Execute callback: Run Crawler (wppo/crawler).

ParameterTypeDefaultDescription
$inputarray=array()—Input data (url, urls).

Return: array — Crawler result or error.

Tags: @since 2.0.0

Source: includes/Admin/class-abilities.php, line 1376