GeoAI_Redirects

Overview

The GeoAI_Redirects class provides URL redirect functionality for managing 301 (permanent) and 302 (temporary) redirects. It supports wildcard patterns for flexible redirect rules. Namespace: GeoAI\Core Location: includes/class-geoai-redirects.php

Key Features

301 permanent redirects
302 temporary redirects
Wildcard pattern support
URL pattern matching
Early template redirect hook
Admin interface integration

Public Methods

get_instance()

Returns the singleton instance of the redirects class.

public static function get_instance()

Returns: GeoAI_Redirects - The singleton instance Example:

$redirects = \GeoAI\Core\GeoAI_Redirects::get_instance();

maybe_redirect()

Checks if current request matches a redirect rule and performs redirect.

public function maybe_redirect()

Hooks: template_redirect (priority 1) Behavior:

Runs early before template is loaded
Skips admin requests
Checks all configured redirects
Performs wp_redirect() and exits on match

Redirect Types

301 Permanent Redirect

Use for permanent URL changes:

array(
    'from' => '/old-page',
    'to'   => '/new-page',
    'type' => 301
)

When to use:

Page permanently moved
URL structure changed
Domain migration
Pass link equity to new URL

302 Temporary Redirect

Use for temporary URL changes:

array(
    'from' => '/promo',
    'to'   => '/special-offer',
    'type' => 302
)

When to use:

Temporary promotions
A/B testing
Maintenance redirects
Seasonal content

Configuration

Add Redirects

$redirects = get_option( 'geoai_redirects', array() );

$redirects[] = array(
    'from' => '/old-url',
    'to'   => '/new-url',
    'type' => 301
);

update_option( 'geoai_redirects', $redirects );

Redirect Structure

from

string

required

Source URL path to redirect from (e.g., /old-page)

string

required

Destination URL to redirect to (e.g., /new-page or https://external.com)

type

int

default:"301"

HTTP redirect status code (301 or 302)

Wildcard Patterns

Asterisk Wildcard

Use * to match any characters:

// Redirect all /blog/* to /news/*
array(
    'from' => '/blog/*',
    'to'   => '/news/',
    'type' => 301
)

Pattern Examples

Match all subpages:

array(
    'from' => '/old-section/*',
    'to'   => '/new-section/',
    'type' => 301
)

Match specific pattern:

array(
    'from' => '/products/*/details',
    'to'   => '/product-info/',
    'type' => 301
)

Match file extensions:

array(
    'from' => '/*.html',
    'to'   => '/',
    'type' => 301
)

Usage Examples

Simple Redirect

$redirects = array(
    array(
        'from' => '/about-us',
        'to'   => '/about',
        'type' => 301
    )
);

update_option( 'geoai_redirects', $redirects );

Multiple Redirects

$redirects = array(
    array(
        'from' => '/old-blog',
        'to'   => '/blog',
        'type' => 301
    ),
    array(
        'from' => '/contact-form',
        'to'   => '/contact',
        'type' => 301
    ),
    array(
        'from' => '/promo',
        'to'   => '/summer-sale',
        'type' => 302
    )
);

update_option( 'geoai_redirects', $redirects );

Category Redirect

// Redirect old category to new
array(
    'from' => '/category/old-name/*',
    'to'   => '/category/new-name/',
    'type' => 301
)

External Redirect

// Redirect to external site
array(
    'from' => '/external',
    'to'   => 'https://external-site.com',
    'type' => 302
)

Remove Redirect

$redirects = get_option( 'geoai_redirects', array() );

// Remove redirect at index 0
unset( $redirects[0] );

// Re-index array
$redirects = array_values( $redirects );

update_option( 'geoai_redirects', $redirects );

Pattern Matching

How It Works

The class converts wildcard patterns to regex:

// Pattern: /blog/*
// Becomes: #^/blog/(.*)$#

// Pattern: /*.html  
// Becomes: #^/(.*)\.html$#

Match Priority

Redirects are checked in the order they are stored. First match wins:

array(
    array( 'from' => '/blog/special', 'to' => '/featured' ),  // Checked first
    array( 'from' => '/blog/*', 'to' => '/news/' )            // Checked second
)

Admin Interface

Manage redirects in WordPress admin: Location: GEO AI Settings > Redirects & 404 Features:

Add/remove redirects
Edit existing redirects
Choose redirect type
Wildcard pattern support

Testing Redirects

Test with cURL

# Test 301 redirect
curl -I https://yoursite.com/old-page

# Should return:
# HTTP/1.1 301 Moved Permanently
# Location: /new-page

Test with WordPress

// Temporarily add test code
add_action( 'template_redirect', function() {
    if ( $_SERVER['REQUEST_URI'] === '/test-redirect' ) {
        echo 'Redirect did not fire';
        exit;
    }
}, 0 ); // Priority 0 runs before redirects (priority 1)

Browser Testing

Clear browser cache
Visit old URL
Check if redirected to new URL
Check browser developer tools for status code

Troubleshooting

Redirect Not Working

Check redirect is saved:

$redirects = get_option( 'geoai_redirects', array() );
var_dump( $redirects );

Check pattern matching:

$pattern = '/blog/*';
$request = '/blog/post-1';

$pattern = str_replace( '*', '(.*)', $pattern );
$pattern = '#^' . $pattern . '$#';

if ( preg_match( $pattern, $request ) ) {
    echo 'Match!';
}

Redirect Loop

Avoid creating circular redirects:

// BAD - Creates infinite loop
array(
    array( 'from' => '/page-a', 'to' => '/page-b' ),
    array( 'from' => '/page-b', 'to' => '/page-a' )
)

Cached Redirects

301 redirects are cached by browsers. To test:

Use incognito/private browsing
Clear browser cache
Use different browser
Test with cURL

Performance

Optimization Tips

Limit number of redirects:

Each redirect requires pattern matching
Keep list under 100 redirects for best performance

Use specific patterns:

// More efficient
array( 'from' => '/blog/old-post', 'to' => '/new-post' )

// Less efficient  
array( 'from' => '/*old-post', 'to' => '/new-post' )

Order matters: Place most frequently accessed redirects first in the array.

Security

Validation

The class uses basic validation:

if ( empty( $redirect['from'] ) || empty( $redirect['to'] ) ) {
    continue; // Skip invalid redirects
}

Open Redirect Prevention

Be careful with user input in redirect destinations:

// BAD - Don't allow arbitrary redirects
$to = $_GET['redirect'];

// GOOD - Validate destination
$allowed = array( '/page1', '/page2' );
$to = in_array( $_GET['redirect'], $allowed ) ? $_GET['redirect'] : '/';

Migration Tools

Import from CSV

function import_redirects_from_csv( $file_path ) {
    $redirects = array();
    
    if ( ( $handle = fopen( $file_path, 'r' ) ) !== false ) {
        while ( ( $data = fgetcsv( $handle ) ) !== false ) {
            $redirects[] = array(
                'from' => $data[0],
                'to'   => $data[1],
                'type' => (int) ( $data[2] ?? 301 )
            );
        }
        fclose( $handle );
    }
    
    update_option( 'geoai_redirects', $redirects );
}

Export to CSV

function export_redirects_to_csv() {
    $redirects = get_option( 'geoai_redirects', array() );
    
    header( 'Content-Type: text/csv' );
    header( 'Content-Disposition: attachment; filename="redirects.csv"' );
    
    $output = fopen( 'php://output', 'w' );
    
    foreach ( $redirects as $redirect ) {
        fputcsv( $output, array(
            $redirect['from'],
            $redirect['to'],
            $redirect['type']
        ));
    }
    
    fclose( $output );
    exit;
}

GeoAI_Admin - Admin interface for managing redirects
GeoAI_Sitemaps - XML sitemap generation

PHP Classes

REST API

Analyzers

​Overview

​Key Features

​Public Methods

​get_instance()

​maybe_redirect()

​Redirect Types

​301 Permanent Redirect

​302 Temporary Redirect

​Configuration

​Add Redirects

​Redirect Structure

​Wildcard Patterns

​Asterisk Wildcard

​Pattern Examples

​Usage Examples

​Simple Redirect

​Multiple Redirects

​Category Redirect

​External Redirect

​Remove Redirect

​Pattern Matching

​How It Works

​Match Priority

​Admin Interface

​Testing Redirects

​Test with cURL

​Test with WordPress

​Browser Testing

​Troubleshooting

​Redirect Not Working

​Redirect Loop

​Cached Redirects

​Performance

​Optimization Tips

​Security

​Validation

​Open Redirect Prevention

​Migration Tools

​Import from CSV

​Export to CSV

​Related Classes

Build docs developers (and LLMs) love