Convesio Static Proxy

Proxy externally hosted static pages onto exact WordPress routes so they render on your primary domain without loading WordPress theme templates.

Highlights

• Exact path mapping (/local-path -> https://upstream/path)
• Early runtime interception on template_redirect priority 0
• Upstream status + safe header passthrough
• HTML rewriting (assets, links, canonical mode)
• Same-origin asset proxy via /?csp_asset=...
• Runtime fallback for SPA asset URLs (/hero_bg.png, etc.)
• Transient caching with stale-on-error behavior
• WPCS/PHPCS tooling configured and passing

Quick start

1. Activate plugin in WordPress admin.
2. Go to Settings -> Convesio Static Proxy.
3. Add mapping row:
   • Local Path: /offer-1
   • External URL: https://example.workers.dev/offer-1
4. Save and visit local path.

Documentation

• docs/architecture.md
• docs/configuration.md
• docs/troubleshooting.md
• docs/developer.md
• docs/features/route-mapping.md
• docs/features/proxy-runtime.md
• docs/features/html-rewriting.md
• docs/features/asset-proxy.md
• docs/features/caching.md
• docs/features/admin-ui.md

Development / standards

• Install tooling: composer install
• Lint: composer lint
• Auto-fix: composer lint:fix
• Build installable plugin ZIP: composer build

Release package output

• ZIP path: dist/convesio-static-proxy.zip
• Includes only runtime files:
  • convesio-static-proxy.php
  • includes/
  • assets/
  • languages/
  • README.md
  • CHANGELOG.md
• Excludes dev-only files/folders such as:
  • docs/
  • vendor/
  • composer.json, composer.lock
  • phpcs.xml.dist
  • .git/, .claude/, and editor/system artifacts

Coding standards configuration:

• phpcs.xml.dist
• Rulesets: WordPress-Core, WordPress-Docs, WordPress-Extra, PHPCompatibilityWP
• Prefix policy: csproxy, CSProxy, CSPROXY

Requirements

• WordPress 6.0+
• PHP 7.4+
• dom extension

License

GPL-2.0-or-later