4WP Style Switcher

4WP Style Switcher reads style variations from the active block theme (theme.json and /styles/*.json). A plugin by 4wp.dev. 4WP is our project brand; the letters "WP" appear only as part of that brand name, not as a reference to WordPress. This plugin is not affiliated with, endorsed, or sponsored by WordPress. Source code and releases: github.com/4wpdev/4wp-style-switcher Development Human-readable PHP source is in the public GitHub repository above. The plugin ZIP includes src/ (PSR-4 autoload via src/Autoload.php when vendor/ is absent). No npm build step — front-end scripts ship as plain JS in assets/. Live demo (WordPress Playground): https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/4wpdev/4wp-style-switcher/v1.0.0/.wordpress-org/assets/blueprints/blueprint.json The demo site Style Switcher uses Twenty Twenty-Five: About, Morning, Afternoon, and Evening pages with per-page styles, A/B light vs dark, a bottom-right visitor switcher, and Light/Dark in the header and footer menus. Page style (editor) — pick a variation for a page; optionally lock it so visitors cannot override it. Frontend switcher — visitors choose from allowed variations; the choice is stored in localStorage and synced to a cookie for server-side rendering. Light / Dark (navigation block) — add the Light/Dark block inside Navigation; map two variations (sun/moon icons). A/B testing — split new visitors between two variations; daily aggregate stats monitor the traffic split. Privacy When the visitor switcher or A/B testing is enabled, the plugin may store the selected style variation in a browser cookie (forwp_ss_style) and in localStorage on the visitor device. No personal data is sent to third-party services. A/B stats are aggregated counts stored in your WordPress database.

Hooks (developers)

• forwp_style_switcher_variations — filter theme variation list.
• forwp_style_switcher_ab_assigned — after A/B cohort assignment.
• forwp_style_switcher_analytics_track — analytics events.
• forwp_style_switcher_ab_assignment_enabled — filter A/B assignment.

1.0.1

• Plugin URI: https://4wp.dev/ (GitHub link stays in readme Development section).
• Removed FORWP_STYLE_SWITCHER_PLAYGROUND_URL from plugin PHP; no remote URLs in runtime code.

1.0.0

• First WordPress.org release (1.0.0).
• Plugin Check: inline script moved to enqueued assets; security and naming fixes.
• readme.txt: 4WP trademark disclaimer, Development, Blocks, Privacy sections.
• Playground blueprint and demo links updated for v1.0.0.

0.2.5

• Request-level caching in Style_Registry, Style_Resolver, and Style_Applicator (faster page loads).
• GitHub README banner; Playground blueprint and demo links updated for v0.2.5.

0.2.4

• Playground demo pages use theme.json variation titles (single H1 from template, slug in content).
• Morning / Afternoon / Evening / Night pages with matching per-page styles; Afternoon locked.
• Light/Dark menu toggle disabled when page style switching is locked.

0.2.3

• Per-page style meta, A/B light vs dark, visitor switcher bottom-right, two locked demo pages.
• Shared navigation in header and footer template parts.
• Fix Documentation tab accordion spacing in admin.

0.2.2

• Apply visitor style from the query param on the same request (no redirect; works in Playground iframe).
• Clean the style query param from the URL after the page loads.

0.2.1

• Fix visitor style switching on WordPress Playground (server-side cookie via query param).
• Playground setup resolves variation slugs from the active theme dynamically.
• Cookie sync uses Secure flag on HTTPS.

0.2.0

• Style registry and resolver for theme.json variations.
• Admin settings (General, Variations, A/B Testing) with REST API.
• Frontend floating switcher with localStorage and cookie sync.
• Light/Dark Gutenberg block for the Navigation menu.
• A/B testing with lightweight daily stats table.
• WordPress Playground blueprint (Morning / Afternoon / Midnight demo).
• Fixes: empty allowed-variations recovery, A/B REST recursion, partial settings save.

0.1.0

• Initial scaffold.