== Description ==<\/p>\n
**Share Logins** keeps user accounts in sync across multiple WordPress sites. When a user registers, logs in, logs out, updates their profile, resets their password, or is deleted on one site \u2014 all connected sites reflect that change instantly.<\/p>\n
No shared database required. Each site stays independent. Share Logins connects them via an encrypted REST API.<\/p>\n
= How It Works =<\/p>\n
1. Install and activate Share Logins on all sites you want to connect.
\n2. Set the same Secret Key on every site.
\n3. Add your remote site URLs on each site’s settings page.
\n4. Configure which user roles and metadata to sync.
\n5. Done \u2014 user events now propagate across all connected sites automatically.<\/p>\n
= Features =<\/p>\n
* **Real-time sync** \u2014 login, logout, register, update, delete, and password reset events sync instantly.
\n* **Encrypted communication** \u2014 all inter-site requests use bearer token authentication with encrypted payloads.
\n* **Granular control** \u2014 choose which user roles to sync, which user metadata fields to include, and toggle incoming\/outgoing actions independently per site.
\n* **WooCommerce support** \u2014 syncs customers created via WooCommerce checkout (including Blocks-based checkout).
\n* **AffiliateWP support** \u2014 syncs users created via AffiliateWP affiliate registration.
\n* **WordPress Multisite support** \u2014 handles user creation, role assignment, and removal across multisite networks.
\n* **User migration** \u2014 export users from one site and import them on another using a `.cx` JSON file.
\n* **Activity log** \u2014 optional logging of all sync actions with direction, site, and timestamp.
\n* **Session management** \u2014 pending syncs are queued in the database and processed reliably.<\/p>\n
= Supported Sync Actions =<\/p>\n
| Action | Outgoing | Incoming |
\n|—|—|—|
\n| Login | \u2713 | \u2713 |
\n| Logout | \u2713 | \u2713 |
\n| Register | \u2713 | \u2713 |
\n| Profile Update | \u2713 | \u2713 |
\n| Password Reset | \u2713 | \u2713 |
\n| Delete | \u2713 | \u2713 |<\/p>\n
Each action can be enabled or disabled independently per direction per remote site.<\/p>\n
= Use Cases =<\/p>\n
* **Membership networks** \u2014 one registration gives access to multiple sites.
\n* **Multi-brand setups** \u2014 keep the same user base across separate WordPress installs.
\n* **Staging environments** \u2014 push users from production to staging.
\n* **WooCommerce store networks** \u2014 customers register once, shop on any connected store.<\/p>\n
== Installation ==<\/p>\n
1. Upload the `share-logins` folder to `\/wp-content\/plugins\/` or install via the WordPress plugin directory.
\n2. Activate the plugin on each site you want to connect.
\n3. Go to **Settings > Share Logins** on each site.
\n4. Under **Settings**, copy the Secret Key and set the same key on all sites.
\n5. Under **Remote Sites**, add the URLs of all other sites you want to connect.
\n6. Under **Connectivity**, select user roles and metadata to sync, and configure outgoing\/incoming actions.
\n7. Click **Save** and use the status checker to verify the connection.<\/p>\n
== Frequently Asked Questions ==<\/p>\n
= Do all sites need Share Logins installed? =<\/p>\n
Yes. The plugin must be active on every site that will participate in the sync.<\/p>\n
= Does this require a shared database? =<\/p>\n
No. Each site keeps its own database. Share Logins connects sites through REST API calls.<\/p>\n
= Is it secure? =<\/p>\n
All requests are authenticated using an encrypted bearer token derived from your Secret Key. The Secret Key must match on all connected sites. Keep it private.<\/p>\n
= What happens if a remote site is offline? =<\/p>\n
The sync request will fail silently for that site. There is no automatic retry. The activity log (if enabled) will record the attempt.<\/p>\n
= Can I control which users are synced? =<\/p>\n
Yes. Under **Connectivity**, choose which user roles to include. Users with excluded roles are ignored.<\/p>\n
= Can I sync custom user metadata? =<\/p>\n
Yes. Under **Connectivity**, select any user meta keys you want to include when syncing profile updates.<\/p>\n
= Does it work with WooCommerce? =<\/p>\n
Yes. Customers created during WooCommerce checkout (including the Blocks-based checkout) are synced to remote sites.<\/p>\n
= Does it work with AffiliateWP? =<\/p>\n
Yes. Users created via AffiliateWP affiliate registration are synced to remote sites.<\/p>\n
= Does it work with WordPress Multisite? =<\/p>\n
Yes. The plugin handles user creation and role assignment across multisite networks.<\/p>\n
= How do I migrate existing users to a new site? =<\/p>\n
Use the **Migrate Sites** tab. Export users from the source site as a `.cx` file, then import that file on the destination site.<\/p>\n
== Screenshots ==<\/p>\n
1. Remote Sites \u2014 add and manage connected site URLs.
\n2. Connectivity \u2014 configure user roles, metadata, and sync actions per direction.
\n3. Migrate Sites \u2014 export and import users between sites.
\n4. Settings \u2014 secret key, activity log toggle, and system report.<\/p>\n
== Changelog ==<\/p>\n
= 5.5.1 =
\n* Fix: WooCommerce Blocks checkout user sync now works correctly when REST_REQUEST is active.
\n* Fix: AffiliateWP affiliate registration now syncs users to remote sites.<\/p>\n
= 5.5.0 =
\n* Updated Local.php.<\/p>\n
= 5.0.0 =
\n* Major release with REST API architecture, encrypted token auth, and session management.<\/p>\n
== Upgrade Notice ==<\/p>\n
= 5.6 =
\nFixes user sync for WooCommerce Blocks checkout and AffiliateWP registrations. Update recommended for all users running WooCommerce or AffiliateWP.<\/p>\n