RTC: Move implementation from jetpack-mu-wpcom to generic package by mmtr · Pull Request #47664 · Automattic/jetpack

mmtr · 2026-03-18T22:40:07Z

Fixes DOTCOM-16392

Proposed changes

Extracts the Real-time Collaboration (RTC) implementation from jetpack-mu-wpcom into a standalone automattic/jetpack-rtc package
The new package provides PingHub WebSocket transport for Gutenberg's RTC feature, including the PHP class (Automattic\Jetpack\RTC), REST API endpoint for PingHub JWT tokens, and the JS provider
registration
jetpack-mu-wpcom now only hooks into jetpack_rtc_enabled to enable/disable RTC based on the WPCOM_Features::REAL_TIME_COLLABORATION feature flag, delegating all logic to the new package
In a follow-up PR, we'll create a new Jetpack module for self-hosted sites so they can get the WebSocket transport too.

Related product discussion/links

p58i-pRN-p2

Does this pull request change what data or activity we track or use?

No

Testing instructions

Simple sites
- Apply these changes to your sandbox
- Sandbox the API and a site with a Business plan
- Make sure the site does not have the wpcom-features-edge sticker
- Go to wp-admin/options-writing.php on the sandboxed site
- Make sure the "Enable real-time collaboration" setting is not visible
- Apply the wpcom-features-edge sticker
- Make sure the "Enable real-time collaboration" setting is visible now
- Enable the RTC setting (it should be enabled by default if you never change its value)
- WebSocket transport
  - Open the same post in the editor with two different users
  - Observe the requests in the Network dev tools
  - Make sure there are no requests to the sync/updates endpoint
  - Make sure there is WebSockect connection to pinghub
  - Make sure the RTC feature works as expected (both uses can edit the post at the same time)
- HTTP polling
  - Add this code to your 0-sandbox.php file: add_filter( 'jetpack_rtc_providers', function() { return array( 'http-polling' ); }, 100 );
  - Reload the post editor with the two users
  - Make sure there are requests to the sync/updates endpoint
  - Make sure there isn't a WebSockect connection to pinghub
  - Make sure the RTC feature works as expected (both uses can edit the post at the same time)
Atomic sites
- Apply these changes to your WoW dev site
- Make sure the site does not have the wpcom-features-edge sticker
- Go to wp-admin/options-writing.php
- Make sure the "Enable real-time collaboration" setting is not visible
- Apply the wpcom-features-edge sticker
- Make sure the "Enable real-time collaboration" setting is visible now
- Enable the RTC setting (it should be enabled by default if you never change its value)
- WebSocket transport
  - Open the same post in the editor with two different users
  - Observe the requests in the Network dev tools
  - Make sure there are no requests to the sync/updates endpoint
  - Make sure there is WebSockect connection to pinghub
  - Make sure the RTC feature works as expected (both uses can edit the post at the same time)
- HTTP polling
  - Add this code to your 0-sandbox.php file: add_filter( 'jetpack_rtc_providers', function() { return array( 'http-polling' ); }, 100 );
  - Reload the post editor with the two users
  - Make sure there are requests to the sync/updates endpoint
  - Make sure there isn't a WebSockect connection to pinghub
  - Make sure the RTC feature works as expected (both uses can edit the post at the same time)

github-actions · 2026-03-18T22:40:59Z

Are you an Automattician? Please test your changes on all WordPress.com environments to help mitigate accidental explosions.

To test on WoA, go to the Plugins menu on a WoA dev site. Click on the "Upload" button and follow the upgrade flow to be able to upload, install, and activate the Jetpack Beta plugin. Once the plugin is active, go to Jetpack > Jetpack Beta, select your plugin (Jetpack or WordPress.com Site Helper), and enable the dotcom-16392-move-implementation-from-jetpack-mu-wpcom-to-jetpack-the branch.
To test on Simple, run the following command on your sandbox:

bin/jetpack-downloader test jetpack dotcom-16392-move-implementation-from-jetpack-mu-wpcom-to-jetpack-the

bin/jetpack-downloader test jetpack-mu-wpcom-plugin dotcom-16392-move-implementation-from-jetpack-mu-wpcom-to-jetpack-the

Interested in more tips and information?

In your local development environment, use the jetpack rsync command to sync your changes to a WoA dev blog.
Read more about our development workflow here: PCYsg-eg0-p2
Figure out when your changes will be shipped to customers here: PCYsg-eg5-p2

github-actions · 2026-03-18T22:42:52Z

Thank you for your PR!

When contributing to Jetpack, we have a few suggestions that can help us test and review your patch:

✅ Include a description of your PR changes.
✅ Add a "[Status]" label (In Progress, Needs Review, ...).
✅ Add testing instructions.
✅ Specify whether this PR includes any changes to data or privacy.
✅ Add changelog entries to affected projects

This comment will be updated as you work on your PR and make changes. If you think that some of those checks are not needed for your PR, please explain why you think so. Thanks for cooperation 🤖

Follow this PR Review Process:

Ensure all required checks appearing at the bottom of this PR are passing.
Make sure to test your changes on all platforms that it applies to. You're responsible for the quality of the code you ship.
You can use GitHub's Reviewers functionality to request a review.
When it's reviewed and merged, you will be pinged in Slack to deploy the changes to WordPress.com simple once the build is done.

If you have questions about anything, reach out in #jetpack-developers for guidance!

Mu Wpcom plugin:

Next scheduled release: WordPress.com Simple releases happen semi-continuously (PCYsg-Jjm-p2)

If you have any questions about the release process, please ask in the #jetpack-releases channel on Slack.

Wpcomsh plugin:

Next scheduled release: Atomic deploys happen twice daily on weekdays (p9o2xV-2EN-p2)

If you have any questions about the release process, please ask in the #jetpack-releases channel on Slack.

projects/packages/jetpack-mu-wpcom/src/features/gutenberg-rtc/gutenberg-rtc.php

projects/packages/rtc/README.md

jp-launch-control · 2026-03-18T23:34:01Z

Code Coverage Summary

Coverage changed in 1 file.

File	Coverage	Δ%	Δ Uncovered
projects/packages/jetpack-mu-wpcom/src/features/gutenberg-rtc/gutenberg-rtc.php	0/6 (0.00%)	-58.75%	-27 💚

2 files are newly checked for coverage.

File	Coverage
projects/packages/rtc/src/rest-api/class-rest-pinghub-token.php	0/54 (0.00%) 💔
projects/packages/rtc/src/class-rtc.php	65/84 (77.38%) 💚

Full summary · PHP report · JS report

_{Coverage check overridden by

I don't care about code coverage for this PR
Use this label to ignore the check for insufficient code coveage.
.}

rcrdortiz · 2026-03-19T13:42:45Z

Works as expected on Simple sites. I'll continue testing on WoW sites.

projects/packages/rtc/src/class-rtc.php

projects/packages/rtc/src/js/providers/pinghub/pinghub-bridge.ts

projects/packages/rtc/src/rest-api/class-rest-pinghub-token.php

rcrdortiz

LGTM let's go!

arthur791004

Nice job 👍

…7664) - Extracts the Real-time Collaboration (RTC) implementation from `jetpack-mu-wpcom` into a standalone `automattic/jetpack-rtc` package - The new package provides PingHub WebSocket transport for Gutenberg's RTC feature, including the PHP class (`Automattic\Jetpack\RTC`), REST API endpoint for PingHub JWT tokens, and the JS provider registration - `jetpack-mu-wpcom` now only hooks into `jetpack_rtc_enabled` to enable/disable RTC based on the `WPCOM_Features::REAL_TIME_COLLABORATION` feature flag, delegating all logic to the new package - In a follow-up PR, we'll create a new Jetpack module for self-hosted sites so they can get the WebSocket transport too.

RTC: Move implementation from jetpack-mu-wpcom to generic package

d5b95dc

mmtr self-assigned this Mar 18, 2026

mmtr added the [Status] In Progress label Mar 18, 2026

github-actions bot added [mu wpcom Feature] Gutenberg Rtc [Package] Jetpack mu wpcom WordPress.com Features [Plugin] mu wpcom jetpack-mu-wpcom plugin [Tests] Includes Tests Docs [Package] Rtc labels Mar 18, 2026

mmtr added 2 commits March 18, 2026 23:46

Remove composer.lock file

e6e5704

Add missing readme

861536d

mmtr requested a review from rcrdortiz March 18, 2026 22:50

mmtr added [Status] Needs Review This PR is ready for review. and removed [Status] In Progress labels Mar 18, 2026

github-actions bot added [Status] In Progress [Status] Needs Author Reply We need more details from you. This label will be auto-added until the PR meets all requirements. and removed [Status] Needs Review This PR is ready for review. labels Mar 18, 2026

rcrdortiz reviewed Mar 18, 2026

View reviewed changes

projects/packages/jetpack-mu-wpcom/src/features/gutenberg-rtc/gutenberg-rtc.php Show resolved Hide resolved

Add missing changelogs

51532a8

rcrdortiz reviewed Mar 18, 2026

View reviewed changes

projects/packages/rtc/README.md Outdated Show resolved Hide resolved

regenerate composer.lock file

cee28ad

github-actions bot added the [Plugin] Wpcomsh label Mar 18, 2026

mmtr added 3 commits March 19, 2026 00:09

Solve CI failures

127f3e5

update code references in readme

1608a00

fix more CI errors

e5494fb

mmtr added 2 commits March 19, 2026 00:36

more CI fixes

4979f33

Update composer.lock files

de55436

mmtr marked this pull request as ready for review March 18, 2026 23:49

github-actions bot added the [Status] In Progress label Mar 18, 2026

mmtr added 3 commits March 19, 2026 10:13

Fix build

e063bfa

Use new option

3318718

only re-register the option that Gutenberg already registered

2eb8add

This was referenced Mar 19, 2026

Enforce room limits in the front-end #47557

Closed

RTC: Add branded editor notices and room-limit enforcement for real-time collaboration rollout on WoW sites #47681

Merged

rcrdortiz reviewed Mar 19, 2026

View reviewed changes

projects/packages/rtc/src/class-rtc.php Outdated Show resolved Hide resolved

mmtr added 2 commits March 19, 2026 16:40

Fix duplicate call

1fa1797

Migrate option values

f019db1

arthur791004 reviewed Mar 20, 2026

View reviewed changes

projects/packages/rtc/src/js/providers/pinghub/pinghub-bridge.ts Show resolved Hide resolved

arthur791004 reviewed Mar 20, 2026

View reviewed changes

projects/packages/rtc/src/rest-api/class-rest-pinghub-token.php Show resolved Hide resolved

rcrdortiz approved these changes Mar 20, 2026

View reviewed changes

arthur791004 approved these changes Mar 20, 2026

View reviewed changes

mmtr merged commit 857dd98 into trunk Mar 20, 2026
121 of 122 checks passed

mmtr deleted the dotcom-16392-move-implementation-from-jetpack-mu-wpcom-to-jetpack-the branch March 20, 2026 09:35

github-actions bot removed [Status] Needs Review This PR is ready for review. [Status] In Progress labels Mar 20, 2026

This was referenced Mar 20, 2026

Revert "RTC: Move implementation from jetpack-mu-wpcom to generic package" #47712

Merged

RTC: Move implementation from jetpack-mu-wpcom to generic package (take 2) #47713

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

RTC: Move implementation from jetpack-mu-wpcom to generic package#47664

RTC: Move implementation from jetpack-mu-wpcom to generic package#47664
mmtr merged 15 commits intotrunkfrom
dotcom-16392-move-implementation-from-jetpack-mu-wpcom-to-jetpack-the

mmtr commented Mar 18, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 18, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 18, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

jp-launch-control bot commented Mar 18, 2026 •

edited

Loading

Uh oh!

rcrdortiz commented Mar 19, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

rcrdortiz left a comment

Uh oh!

arthur791004 left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

mmtr commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Proposed changes

Related product discussion/links

Does this pull request change what data or activity we track or use?

Testing instructions

Uh oh!

github-actions bot commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jp-launch-control bot commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code Coverage Summary

Uh oh!

rcrdortiz commented Mar 19, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

rcrdortiz left a comment

Choose a reason for hiding this comment

Uh oh!

arthur791004 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mmtr commented Mar 18, 2026 •

edited

Loading

github-actions bot commented Mar 18, 2026 •

edited

Loading

github-actions bot commented Mar 18, 2026 •

edited

Loading

jp-launch-control bot commented Mar 18, 2026 •

edited

Loading