Hooks & Filters for Developers

AccessGuard provides WordPress hooks and filters for developers who want to customize or extend the plugin’s behavior.

Filters

// Modify the list of URLs to scan
add_filter( 'accessguard_scan_urls', function ( $urls ) {
    // Add custom URLs
    $urls[] = home_url( '/custom-page/' );
    return $urls;
} );

// Customize issue severity
add_filter( 'accessguard_issue_severity', function ( $severity, $issue ) {
    // Upgrade color contrast issues to critical
    if ( $issue['rule'] === 'color-contrast' ) {
        return 'critical';
    }
    return $severity;
}, 10, 2 );

// Filter which elements are checked
add_filter( 'accessguard_scan_selectors', function ( $selectors ) {
    // Exclude a specific section from scanning
    $selectors['exclude'][] = '.no-a11y-scan';
    return $selectors;
} );

Actions

// Run code after a scan completes
add_action( 'accessguard_scan_complete', function ( $scan_id, $results ) {
    // Send a notification, log results, etc.
    wp_mail( 'admin@example.com', 'Scan Complete', 'Score: ' . $results['score'] );
}, 10, 2 );

// Run code when an issue is resolved
add_action( 'accessguard_issue_resolved', function ( $issue_id, $issue ) {
    // Track remediation progress
}, 10, 2 );