Orravo SEO Kit v1.0.0

Requirements

• WordPress 6.0 or newer
• PHP 8.0 or newer
• Pretty permalinks enabled (anything other than ?p=123)
• Apache, Nginx, or LiteSpeed. SEO Kit does not require .htaccess modification.

From WordPress admin

What gets logged

Filters

PHP// Skip logging some URLs entirely (e.g. asset noise from outdated cached pages)
add_filter( 'osk_should_log_404', function( bool $log, string $url ): bool {
    if ( str_starts_with( $url, '/wp-content/uploads/' ) ) return false;
    if ( str_ends_with( $url, '.map' ) )                   return false;
    return $log;
}, 10, 2 );

// Skip logging bot hits
add_filter( 'osk_should_log_404', function( bool $log ): bool {
    $ua = $_SERVER['HTTP_USER_AGENT'] ?? '';
    return $log && ! preg_match( '/bot|crawler|spider|slurp/i', $ua );
} );

Auto-prune

By default, 404 rows older than 90 days with hits < 3 are pruned daily via the osk_prune_404_log cron event. Change the retention under 404 Monitor → Settings or via the osk_404_retention_days filter.

Match types

Status codes

• 301 Moved Permanently (default): cached aggressively by browsers and search engines. Use for permanent moves.
• 302 Found: temporary. Not cached. Useful during A/B tests or staged migrations.
• 307 Temporary Redirect: preserves the request method (POST stays POST). Useful for form-submission endpoints.
• 410 Gone: terminates the page with no redirect. Tells Google to drop the URL.

PHP API

PHP// Programmatic redirect insert
OSK_Redirects::save([
    'source'      => '/blog/2019/old-post',
    'target'      => '/blog/new-post',
    'match_type'  => 'exact',     // exact | prefix | regex | fuzzy
    'status_code' => 301,
    'enabled'     => true,
    'note'        => 'Manual migration, May 2026',
]);

// Wildcard with capture
OSK_Redirects::save([
    'source'     => '/blog/2019/*',
    'target'     => '/archive/$1',
    'match_type' => 'prefix',
    'status_code'=> 301,
]);

// Regex with multiple captures
OSK_Redirects::save([
    'source'     => '^/p/([0-9]+)/([a-z0-9\-]+)$',
    'target'     => '/posts/$2?legacy=$1',
    'match_type' => 'regex',
    'status_code'=> 301,
]);

Old-slug capture

When a published post's slug changes, WordPress already records the old slug in the _wp_old_slug postmeta. SEO Kit goes further: it writes a row to osk_old_slugs with the full old URL and the new URL, then auto-creates a 301 redirect with status auto. You can disable this under Redirects → Behaviour.

Import formats

Endpoints

Exclusions

Out of the box, SEO Kit excludes: posts with noindex via core, password-protected posts, drafts and private posts, Woo cart / checkout / my-account, the auto-created OMembership portal page (if present), and any post tagged with the osk_exclude meta key.

PHP// Programmatic per-post exclusion
add_filter( 'osk_sitemap_should_include_post', function( bool $include, WP_Post $post ): bool {
    if ( get_post_meta( $post->ID, '_legacy_archive', true ) ) {
        return false;
    }
    return $include;
}, 10, 2 );

// Add a custom URL (e.g. a SPA route handled by your theme)
add_filter( 'osk_sitemap_extra_urls', function( array $urls ): array {
    $urls[] = [
        'loc'        => home_url( '/app/dashboard' ),
        'lastmod'    => '2026-05-15',
        'changefreq' => 'weekly',
        'priority'   => '0.7',
    ];
    return $urls;
} );

Caching

Each sub-sitemap is rendered once per change, stored in a transient (osk_sitemap_post_1, etc.), and invalidated on save_post, delete_post, term changes, or a manual Rebuild now click. Cache TTL defaults to 12 hours.

Default output

TEXTUser-agent: *
Disallow: /wp-admin/
Allow:    /wp-admin/admin-ajax.php

Sitemap: https://your-domain.com/sitemap.xml

Per-environment overrides

On a non-production environment (wp_get_environment_type() !== 'production'), SEO Kit automatically prepends a Disallow: / directive for all user agents. You can disable this safety net but it is highly recommended; it prevents staging URLs from being accidentally indexed.

Per-agent rules

Add agent-specific blocks from Robots → Rules. SEO Kit emits one User-agent: stanza per row, ordered by user-agent name. The wildcard * always comes last to avoid shadowing more specific rules.

Lifecycle

• 1Click Start scan under SEO Kit → Broken Links. SEO Kit walks posts via the WP REST API, page by page.
• 2Each post body is parsed for <a href> tags; outbound links are stored with their source post ID.
• 3Action Scheduler is loaded; one job per unique URL is queued (default concurrency: 4).
• 4Each job issues a HEAD request with a 7-second timeout. Non-2xx / non-3xx responses or connection errors are recorded.
• 5Once all jobs finish, the admin notifications panel shows the run summary; results live in osk_broken_links.

Result columns

Fix-in-place

Each broken-link row has a Replace action: enter a new URL and SEO Kit walks the listed posts, runs a content-safe str_replace on the original URL, and saves the posts via wp_update_post(). Pre-edit revisions are preserved so a rollback is always possible.

Endpoints

Create a redirect

cURLcurl -X POST https://example.com/wp-json/orravo-seo/v1/redirects \
  -H 'Content-Type: application/json' \
  -H 'X-WP-Nonce: <rest-nonce>' \
  -d '{
    "source":      "/blog/2019/*",
    "target":      "/archive/$1",
    "match_type":  "prefix",
    "status_code": 301,
    "enabled":     true,
    "note":        "2019 archive migration"
  }'

Read 404 log

cURLcurl -X GET 'https://example.com/wp-json/orravo-seo/v1/404s?status=open&orderby=hits&per_page=20' \
  -H 'X-WP-Nonce: <rest-nonce>'