orbit-multisite

Validate WordPress plugin compatibility with Multisite environments via Playwright tests.

2|1|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/adityaarsharma/orbit --skill orbit-multisite
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orbit-multisite
Source: https://github.com/adityaarsharma/orbit/tree/main/skills/orbit-multisite
Command: npx skills add https://github.com/adityaarsharma/orbit --skill orbit-multisite

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes scripts (resource) components.

What problem does it solve?

This Skill identifies compatibility issues with WordPress Multisite environments, helping you ensure your plugin functions correctly across multiple sites.

Core Features & Use Cases

  • Multisite Activation Checks: Validates activation hooks for network-wide compatibility.
  • Capability Checks: Ensures proper super-admin and per-site capabilities are set.
  • Settings Storage: Manages network-wide and per-site settings correctly.
  • switch_to_blog() Safety: Prevents issues with blog switching in multisite installations.
  • Uninstall Logic: Handles data cleanup for network and single-site installations.
  • File Uploads: Ensures correct handling of file uploads in multisite setups.
  • Sub-domain/Sub-directory: Tests compatibility with both sub-directory and sub-domain installations.
  • Use Case: Before releasing a plugin that claims to be Multisite compatible, use this Skill to ensure it works as expected across different sites.

Quick Start

Run the multisite spec for your plugin by executing: PLUGIN_SLUG=my-plugin npx playwright test --project=multisite.

Frequently Asked Questions about orbit-multisite

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test WordPress plugin compatibility with Multisite environments?

You can test WordPress plugin compatibility with Multisite environments by running automated checks for activation hooks, capability checks, and `switch_to_blog()` safety using Playwright. This validates network-wide settings storage and file uploads across sub-directory and sub-domain installations to ensure proper functionality.

What does WordPress Multisite compatibility require for plugin activation hooks?

WordPress Multisite compatibility requires plugins to properly handle activation hooks for network-wide activation. Validating these hooks ensures that database tables and options are set up correctly across all sites within the multisite network during initial activation.

Do I need Playwright to run WordPress Multisite compatibility checks?

Yes, you need Playwright installed to run these automated WordPress Multisite compatibility checks. The testing framework executes the validation scripts that inspect your plugin's settings storage, uninstall logic, and capability checks across multiple sites.

How do I prevent `switch_to_blog()` issues in a WordPress Multisite plugin?

To prevent `switch_to_blog()` issues in a WordPress Multisite plugin, you must validate blog switching logic to ensure queries and settings restore correctly after switching contexts. Automated testing checks this safety to avoid data leaking between sites.

What is the best way to verify plugin uninstall logic for WordPress Multisite?

The best way to verify plugin uninstall logic for WordPress Multisite is to run automated compatibility checks that ensure data cleanup properly removes network-wide options and per-site settings. This prevents orphaned data from remaining after deletion.

Does my WordPress plugin support both sub-domain and sub-directory Multisite setups?

Testing with automated Multisite compatibility scripts verifies whether your WordPress plugin supports both sub-domain and sub-directory installations. It checks file uploads and capability handling to ensure proper operation regardless of the multisite configuration.