HarmonyUser Sync

English:

Do you manage multiple WordPress websites and struggle to keep user information consistent across them? Manually updating profiles, handling registrations, and managing deletions on each site is tedious and error-prone. HarmonyUser Sync solves this problem by providing robust, automated synchronization of user data (including standard users and WooCommerce customers) between your WordPress installations.

Leveraging the secure WordPress REST API and Application Passwords for authentication (we never store your admin passwords!), HarmonyUser Sync ensures that user creation, updates (profile info, roles, passwords), and deletions are seamlessly mirrored across designated target sites. It features intelligent loop prevention to avoid data storms, detailed logging for traceability, and flexible options for both automatic and manual synchronization. Ideal for brand networks, multi-store WooCommerce setups, or any scenario requiring unified user management across separate WordPress sites.

Key Features:

• Automatic Sync: Real-time synchronization for user registration, profile updates, and deletions.
• WooCommerce Support: Seamlessly syncs WooCommerce customer data.
• Manual Sync Tool: Select specific users and target sites for bulk synchronization.
• Secure Authentication: Uses Application Passwords – no admin passwords stored.
• Intelligent Loop Prevention: Prevents infinite synchronization loops.
• Global User Identification: Reliably identifies the same user across different sites.
• Target Site Management: Easy interface to add, manage, and test connections to target sites.
• Detailed Sync Logs: Track every sync operation for auditing and troubleshooting.
• Role-Based Sync: Option to sync only users with specific roles.
• Bi-directional & Chain Sync Ready: Supports complex synchronization topologies through configuration.

? HarmonyUser Sync Pro – Exclusive Features ?

1. Flexible Authentication: Manual Application Password Entry
   Gain more control over site connections. In addition to generating Application Passwords automatically using admin credentials, the Pro version allows you to directly input a pre-existing Application Password. This is perfect for environments with strict security policies where admin credential entry is not permitted.

2. Intelligent User Creation: Create User on Automatic Update
   Never miss a user again. By default, an automatic ‘update’ request for a non-existent user on a target site is ignored. The Pro version adds an option for the target site to intelligently create the user if they don’t exist locally during an automatic update sync. This ensures your sites remain perfectly aligned, even in complex sync scenarios.

3. Site-Wide Protection: Prohibit Incoming Sync Modifications
   Instantly lock down a website. A simple checkbox in the settings allows you to make a site “read-only” for synchronization. When enabled, this site will reject all incoming requests to create, update, or delete users, providing a powerful “kill switch” to protect a master site’s user data.

4. Advanced Security: IP & URL Whitelist Management
   Fortify your sites against unauthorized requests. This crucial Pro feature ensures that your site only accepts sync requests from pre-approved URLs and IP addresses.

* Full Whitelist UI: A dedicated admin menu to add, edit, and manage a list of trusted sites.
* Enable/Disable: Activate whitelist enforcement with a single click in the plugin settings.
* Enhanced Security: Prevents any possibility of unauthorized API calls, even if an Application Password were somehow compromised.

1. Granular Control (Outgoing): Per-User Sync Propagation
   Fine-tune your synchronization at the individual user level. Add a “Prohibit Sync Propagation” switch to each user’s profile. When enabled for a specific user, no create, update, or delete actions initiated by that user will be synced to any target site. This is ideal for excluding admins, test accounts, or specific members from the sync process.

2. Granular Control (Incoming): Per-User Rejection of Modifications
   Protect individual VIP user accounts from being altered by remote changes. The “Reject Modifications” switch on a user’s profile prevents any incoming sync request from updating or deleting that specific user. This ensures that critical user accounts on a target site cannot be accidentally overwritten.

With HarmonyUser Sync Pro, you are not just syncing users; you are implementing a secure, robust, and highly controllable user management strategy for your entire WordPress ecosystem.

Visit https://www.wowown.com/ to download the Pro version.

简体中文:

您是否管理着多个 WordPress 网站，并为保持它们之间用户数据的一致性而烦恼？在每个站点上手动更新个人资料、处理注册和管理删除操作既繁琐又容易出错。HarmonyUser Sync 通过提供强大、自动化的用户数据（包括标准用户和 WooCommerce 客户）同步功能，解决了这个问题。

HarmonyUser Sync 利用安全的 WordPress REST API 和应用程序密码进行认证（我们绝不存储您的管理员密码！），确保用户的创建、更新（个人信息、角色、密码）和删除操作能够无缝地镜像到指定的目标站点。它具有智能防循环机制以避免数据风暴，提供详细的日志以保证可追溯性，并为自动和手动同步提供了灵活的选项。非常适合品牌网站群、多店铺 WooCommerce 设置或任何需要在独立 WordPress 站点间实现统一用户管理的场景。

主要功能:

• 自动同步: 实时同步用户注册、个人资料更新和删除操作。
• WooCommerce 支持: 无缝同步 WooCommerce 客户数据。
• 手动同步工具: 可选择特定用户和目标站点进行批量同步。
• 安全认证: 使用应用程序密码 – 不存储管理员密码。
• 智能防循环: 防止无限同步循环。
• 全局用户标识: 可靠地识别不同站点上的同一用户。
• 目标站点管理: 简洁的界面，用于添加、管理和测试到目标站点的连接。
• 详细同步日志: 跟踪每一次同步操作，便于审计和故障排除。
• 基于角色的同步: 可选择仅同步特定角色的用户。
• 支持双向与链式同步: 通过配置支持复杂的同步拓扑。

? HarmonyUser Sync Pro – 独家功能 ?

1. 灵活认证：手动输入应用程序密码
   获得对站点连接的更多控制权。除了使用管理员凭据自动生成应用程序密码外，Pro版还允许您直接输入一个已存在的应用程序密码。这对于有严格安全策略、不允许输入管理员凭据的环境来说是完美的选择。

2. 智能用户创建：在自动更新时创建用户
   再也不会错过任何一个用户。默认情况下，对于目标站点上不存在的用户的自动“更新”请求会被忽略。Pro版增加了一个选项，允许目标站点在自动更新同步期间，如果用户在本地不存在，则智能地创建该用户 。这可以确保即使在复杂的同步场景中，您的站点也能保持完全一致。

3. 站点级保护：禁止传入的同步修改
   立即锁定一个网站。通过设置中的一个简单复选框，您可以将一个站点设置为同步“只读” 。启用后，该站点将拒绝所有创建、更新或删除用户的传入请求 ，提供了一个强大的“紧急开关”来保护主站点的用户数据。

4. 高级安全：IP 与 URL 白名单管理
   加固您的站点，抵御未经授权的请求。这个关键的 Pro 功能可确保您的站点只接受来自预先批准的 URL 和 IP 地址的同步请求 。

* 完整的白名单管理界面: 一个专用的管理菜单，用于添加、编辑和管理受信任的站点列表 。
* 启用/禁用: 在插件设置中一键激活白名单验证 。
* 增强安全性: 即使应用程序密码意外泄露，也能防止任何未经授权的 API 调用 。

1. 精细化控制 (出站)：按用户禁止同步传播
   在单个用户级别上微调您的同步。为每个用户个人资料添加一个“禁止同步传播”的开关。为特定用户启用后，由该用户发起的任何创建、更新或删除操作都不会被同步到任何目标站点 。这对于从同步过程中排除管理员、测试账户或特定成员非常理想。

2. 精细化控制 (入站)：按用户拒绝修改
   保护个别的用户账户不被远程更改所影响。用户个人资料上的“拒绝修改”开关可防止任何传入的同步请求更新或删除该特定用户。这确保了目标站点上的关键用户账户不会被意外覆盖。

拥有 HarmonyUser Sync Pro，您不仅仅是在同步用户；您是在为您的整个 WordPress 生态系统实施一个安全、稳健且高度可控的用户管理策略。

访问 https://www.wowown.com/ 下载Pro版本。

Configuration / Usage

English:

1. After activating the plugin, a new menu item “User Sync” will appear in your WordPress admin sidebar.
2. General Settings (User Sync > Settings):
   • Enable Auto Sync: Check this to automatically sync user changes (create, update, delete).
   • Sync User Roles: Select which user roles should trigger synchronization. Users with unselected roles will not be synced.
   • Log Retention Days: Set how long sync logs should be kept (e.g., 30 days). Older logs will be automatically purged.
   • Enable Sync Log: Check this to record detailed logs of sync operations. Recommended for troubleshooting.
   • Save your changes.
3. Target Sites (User Sync > Target Sites): This is where you define the sites to which the current site will send user data.
   • Click “Add New”.
   • Site Name: A recognizable name for the target site (e.g., “My Store Blog”).
   • Site URL: The full URL of the target WordPress site (e.g., https://target-site.com). HarmonyUser Sync must also be installed and activated on this target site.
   • Admin Username: The WordPress administrator username on the target site.
   • Admin Password: The password for the administrator username on the target site. This is used only once to generate an Application Password and IS NOT STORED.
   • Status: Set to “Active” to enable syncing to this site.
   • Test Connection: Click this button before saving. It will attempt to connect to the target site using the provided credentials and generate a secure Application Password specifically for this sync connection. You should see a success message if it works. The Application Password will be stored securely (not the original admin password).
   • Click “Save Target Site”.
4. Repeat step 3 for all other WordPress sites you want this site to sync to.
5. Manual Sync (User Sync > Manual Sync):
   • Select the user(s) you want to sync from the list.
   • Select the target site(s) you want to sync these users to.
   • Click “Apply” to start the manual synchronization process. This is useful for initial bulk syncs or syncing specific users on demand.
6. Sync Logs (User Sync > Sync Logs): View the history of all sync operations, filter by date, site, status, etc.

Important: For bi-directional sync (e.g., Site A syncs to Site B, and Site B syncs to Site A), you need to configure HarmonyUser Sync on both sites, adding the other site as a target in each respective configuration.

简体中文:

1. 激活插件后，一个新的菜单项 “User Sync” 将出现在您的 WordPress 管理侧边栏中。
2. 常规设置 (User Sync > 设置):
   • 启用自动同步: 勾选此项以自动同步用户更改（创建、更新、删除）。
   • 同步用户角色: 选择哪些用户角色应触发同步。未被选中的角色的用户将不会被同步。
   • 日志保留天数: 设置同步日志的保留时间（例如 30 天）。旧日志将被自动清除。
   • 启用同步日志: 勾选此项以记录详细的同步操作日志。推荐用于问题排查。
   • 保存您的更改。
3. 目标站点 (User Sync > 目标站点): 在这里定义当前站点将要把用户数据发送到的站点。
   • 点击 “添加”。
   • 站点名称: 目标站点易于识别的名称（例如 “我的商店博客”）。
   • 站点 URL: 目标 WordPress 站点的完整 URL（例如 https://target-site.com）。HarmonyUser Sync 插件也必须在目标站点上安装并激活。
   • 管理员用户名: 目标站点上的 WordPress 管理员用户名。
   • 管理员密码: 目标站点上该管理员用户名的密码。此项仅用于一次性生成应用程序密码，并且不会被存储。
   • 状态: 设置为 “启用” 以允许同步到此站点。
   • 测试连接: 在保存之前点击此按钮。它将尝试使用提供的凭据连接到目标站点，并为此同步连接生成一个安全的应用程序密码。如果成功，您应该会看到成功消息。应用程序密码将被安全地存储（而不是原始管理员密码）。
   • 点击 “保存目标站点”。
4. 为您希望当前站点同步到的所有其他 WordPress 站点重复步骤 3。
5. 手动同步 (User Sync > 手动同步):
   • 从列表中选择您想要同步的一个或多个用户。
   • 选择您想要将这些用户同步到的一个或多个目标站点。
   • 点击 “应用” 以开始手动同步过程。这对于初始批量同步或按需同步特定用户非常有用。
6. 同步日志 (User Sync > 同步日志): 查看所有同步操作的历史记录，可按日期、站点、状态等进行筛选。

重要提示: 对于双向同步（例如，站点 A 同步到站点 B，同时站点 B 也同步到站点 A），您需要在两个站点上都配置 HarmonyUser Sync，在各自的配置中将对方站点添加为目标站点。