Controlling External Connections in WordPress: WPBridge User Guide

By default, WordPress connects to wordpress.org to fetch plugin and theme updates. However, under China’s network conditions, these connections frequently time out or fail. Even more troublesome is the fact that you cannot control which external services WordPress attempts to connect to.

WPBridge (Wenpai Cloud Bridge) solves exactly this problem—it gives you full control over WordPress’s external connections: customize update sources, manage multiple sources by priority, and control AI-related external requests.

Try It in 30 Seconds

No installation required—experience it directly in your browser:

One-click Preview of WPBridge →
Clicking the link opens an online WordPress environment with WPBridge already installed and activated—just navigate straight to the settings page.

Installation & Configuration

Step 1: Install and Activate

In your WordPress admin dashboard, go to Plugins → Add New, then search for WPBridge or Wenpai Cloud Bridge, install it, and click Activate.

Alternatively, download the ZIP package manually from Wenpai Open Source and upload it via Plugins → Add New → Upload Plugin.

Step 2: Access Settings

After activation, locate the Cloud Bridge menu item in the left-hand admin sidebar—or go directly to wp-admin/admin.php?page=wpbridge.

Step 3: Configure Update Sources

WPBridge ships with a preconfigured “Wenpai Open Source Update Source”, ready to use out-of-the-box. You can also add custom sources:

  • Source Name: A descriptive name for easy identification
  • Source Type: Supports JSON API format
  • API Endpoint: The URL of the update source’s API
  • Priority: Lower numbers indicate higher priority; when multiple sources are configured, WPBridge queries them in ascending priority order
  • Enable/Disable: Toggle a source on or off instantly—no need to delete it

Step 4: Adjust Global Settings

Additional options on the settings page include:

  • Cache Duration: Default is 12 hours—reduces redundant requests
  • Request Timeout: Default is 10 seconds—you may increase it for unstable networks
  • Fallback Behavior: Whether to fall back to WordPress’s default update source if all custom sources are unavailable
  • Debug Mode: Enable for detailed logging when troubleshooting issues

Use Cases

Scenario Without WPBridge With WPBridge
Plugin Updates Only pulls from wordpress.org—frequent timeouts in China Fetches reliably and quickly from Wenpai or custom sources
Multi-Source Management Not supported Automatic priority-based switching—if one source fails, WPBridge tries the next
AI Service Connections May connect to unknown AI endpoints (e.g., OpenAI, Anthropic) Granular control via allowlist: specify trusted AI endpoints or disable entirely
Enterprise Intranet Cannot use private/internal update sources Configure internal source URLs—fully functional offline

Frequently Asked Questions (FAQ)

Q: Will my existing update functionality still work after installing WPBridge?
A: Yes. When “Fallback Behavior” is enabled, if a custom source doesn’t provide an update for a given plugin, WPBridge automatically falls back to WordPress’s default source.

Q: Can I configure multiple update sources simultaneously?
A: Yes. Assign each source a unique priority number. WPBridge queries them sequentially—from highest to lowest priority—until it finds a valid update.

Q: What does the AI configuration do?
A: Some plugins initiate external calls to AI services (e.g., OpenAI, Anthropic). WPBridge’s AI settings let you control those connections—by defining an allowlist, specifying custom endpoints, or disabling AI requests entirely.

Q: How does WPBridge differ from WP-China-Yes?
A: WP-China-Yes (Wenpai Leaf) offers a simple one-click switch to Wenpai’s accelerated update source. WPBridge goes further: supporting multi-source management, priority ordering, and AI connection control—ideal for users and enterprises requiring fine-grained control. The two plugins can be used together.

Related Recommendations

If you’re building a Chinese-language WordPress site, consider pairing WPBridge with these complementary Wenpai plugins:

All plugins are available for instant, no-installation trial at the Wenpai Playground.