WP Manifestindependent plugin directory
manifest / performance / convesio-static-proxy

Convesio Static Proxy

Proxy exact WordPress routes to externally hosted static pages.

by Convesio · github.com/convesio-inc/convesio-static-proxy · website

★ 7stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/convesio-inc/convesio-static-proxy/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/convesio-inc/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