Title: 4WP Style Switcher
Author: 4wpdev
Published: <strong>2026 年 6 月 9 日</strong>
Last modified: 2026 年 6 月 9 日

---

搜索插件

![](https://ps.w.org/4wp-style-switcher/assets/banner-772x250.png?rev=3566286)

![](https://ps.w.org/4wp-style-switcher/assets/icon-256x256.png?rev=3566286)

# 4WP Style Switcher

 作者：[4wpdev](https://profiles.wordpress.org/4wpdev/)

[下载](https://downloads.wordpress.org/plugin/4wp-style-switcher.1.0.1.zip)

 * [详情](https://cn.wordpress.org/plugins/4wp-style-switcher/#description)
 * [评价](https://cn.wordpress.org/plugins/4wp-style-switcher/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/4wp-style-switcher/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/4wp-style-switcher/#developers)

 [支持](https://wordpress.org/support/plugin/4wp-style-switcher/)

## 描述

4WP Style Switcher reads **style variations** from the active block theme (`theme.
json` and `/styles/*.json`).

A plugin by [4wp.dev](https://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](https://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.

### Blocks

This plugin provides 1 block.

 * **Light / Dark** — menu toggle between two mapped theme style variations (sun/
   moon icons).**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 个区块.

 *   Light / Dark Sun and moon toggle for Light/Dark style variations in the navigation
   menu.

## 安装

 1. Upload and activate the plugin.
 2. Go to **Settings  4WP Style Switcher**.
 3. On **Variations**, check which style variations visitors may use.
 4. Under **General**, set the default variation and optional Light/Dark mapping.
 5. Edit a page  **Page style** panel to assign or lock a variation.
 6. In the site editor, insert **Light / Dark** inside the **Navigation** block.

## 常见问题

### Which themes are supported?

Block themes (FSE) that ship style variations under the theme’s `/styles/` directory.

### Where is the Playground demo configured?

In the GitHub repository: `playground/setup.php` and `.wordpress-org/assets/blueprints/
blueprint.json`.

### Does the floating switcher list every theme variation?

It lists variations allowed on the **Variations** settings tab. The menu Light/Dark
block uses only the two variations mapped under **General**.

## 评价

此插件暂无评价。

## 贡献者及开发者

「4WP Style Switcher」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ 4wpdev ](https://profiles.wordpress.org/4wpdev/)

[帮助将「4WP Style Switcher」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/4wp-style-switcher)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/4wp-style-switcher/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/4wp-style-switcher/)，或通过[RSS](https://plugins.trac.wordpress.org/log/4wp-style-switcher/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/4wp-style-switcher/)。

## 更新日志

#### 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.

## 额外信息

 *  版本 **1.0.1**
 *  最后更新：**2 天前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 6.4 或更高版本 **
 *  已测试的最高版本为 **7.0**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/4wp-style-switcher/)
 * 标签
 * [block-theme](https://cn.wordpress.org/plugins/tags/block-theme/)[dark mode](https://cn.wordpress.org/plugins/tags/dark-mode/)
   [full-site-editing](https://cn.wordpress.org/plugins/tags/full-site-editing/)
   [style variations](https://cn.wordpress.org/plugins/tags/style-variations/)[theme.json](https://cn.wordpress.org/plugins/tags/theme-json/)
 *  [高级视图](https://cn.wordpress.org/plugins/4wp-style-switcher/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/4wp-style-switcher/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/4wp-style-switcher/reviews/)

## 贡献者

 *   [ 4wpdev ](https://profiles.wordpress.org/4wpdev/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/4wp-style-switcher/)