SearchFlow SEO

A modular WordPress SEO plugin focused on safe defaults, clean admin UX, technical SEO essentials, and scalable architecture.

Overview

SearchFlow SEO is built as an all-in-one SEO toolkit for WordPress sites that want:

• guided setup
• clear metadata controls
• schema support
• XML sitemap support
• redirect management
• 404 monitoring
• analyzer-driven SEO checks
• local SEO fields
• WooCommerce-aware schema support

This repository is the GitHub development version of the plugin.

Current Feature Set

Core SEO

• setup wizard
• global settings
• titles and meta templates
• social meta output
• canonical support
• robots controls
• per-post SEO fields
• Gutenberg sidebar scaffold

Technical SEO

• schema output
• local business schema fields
• WooCommerce product schema support
• XML sitemap generation
• sitemap include/exclude controls
• SEO analyzer with scoring and sample content checks

Recovery Tools

• redirect manager
• redirect CSV import/export
• 404 monitor
• log cleanup workflow

Admin / Platform

• modular dashboard
• import/export tools
• audit snapshots
• admin notices
• REST health endpoint scaffold
• AJAX analyzer refresh endpoint

Project Structure

searchflow-seo/
  assets/
  docs/
  includes/
    Admin/
    API/
    Core/
    Database/
    Frontend/
    Helpers/
    Integrations/
    Modules/
  languages/
  tests/
  build.md
  CHANGELOG.md
  qa-checklist.md
  readme.txt
  searchflow-seo.php
  uninstall.php

Important Files

• searchflow-seo.php - plugin bootstrap
• includes/Core/Plugin.php - service registration and boot flow
• includes/Core/Settings_Manager.php - plugin settings defaults and sanitization
• includes/Core/Module_Manager.php - module registry and module state handling
• includes/Core/Schema_Service.php - JSON-LD schema output
• includes/Core/Sitemap_Service.php - sitemap generation
• includes/Core/Redirect_Service.php - redirect handling and CSV import/export
• includes/Core/Monitor_404_Service.php - 404 logging and cleanup
• includes/Core/Analyzer_Service.php - analyzer logic and scoring
• includes/Frontend/Meta_Output_Manager.php - frontend title/meta/social output
• build.md - execution plan and progress tracker

Installation

In WordPress

1. Copy this project into wp-content/plugins/searchflow-seo
2. Activate SearchFlow SEO
3. Open the plugin from the WordPress admin menu
4. Run the setup wizard

Using the packaged zip

• Use dist/searchflow-seo.zip

Development Notes

Requirements

• WordPress 6.3+
• PHP 7.4+

Useful docs in this repo

• build.md
• development-runbook.md
• debugging-runbook.md
• qa-checklist.md
• docs/runtime-validation.md
• docs/compatibility-matrix.md
• docs/performance-checklist.md

Testing

• PHP syntax checks are expected to pass on all plugin PHP files
• PHPUnit scaffolds are included in tests/
• phpunit.xml.dist is included for future test runs

Example syntax validation:

python3 - <<'PY'
import pathlib, subprocess
for path in sorted(pathlib.Path('.').rglob('*.php')):
    if 'dist/' in str(path):
        continue
    subprocess.run(['php', '-l', str(path)], check=True)
print('All PHP files lint successfully')
PY

Runtime Validation

Before release, validate in a live WordPress site:

• admin pages load without errors
• setup wizard saves correctly
• meta box saves in Classic Editor and Gutenberg
• schema appears on frontend
• sitemap URLs load
• redirects work
• 404 monitor logs requests
• WooCommerce schema works when WooCommerce is active

See qa-checklist.md and docs/runtime-validation.md.

Packaging

Clean distributable zip:

• dist/searchflow-seo.zip

Status

The repository contains a substantial working implementation, but some final validation tasks still depend on live WordPress runtime testing across themes, builders, WooCommerce, and lower-resource hosting.

License

GPLv2 or later.