Сүрөттөө
Presence API gives WordPress a system-wide awareness layer. It tracks which users are logged in, which admin screen they are on, and which posts they are editing.
Data flows through the Heartbeat API and is stored in a dedicated wp_presence table with a 150-second TTL. No writes to wp_postmeta means no post-cache invalidation on every heartbeat.
On a multisite network, Network Admin gets its own view of the same data: a Who’s Online dashboard widget listing the busiest sites and who is on each, an Online column in the Sites list, and an Online view, filter, and column in the Users list. These require the manage_network capability.
Features
- Admin bar indicator showing who’s online and who’s on this page
- Active Posts dashboard widget grouped by post
- Editors column in the post list
- Online filter in the Users list
- AI agents labelled in the admin bar, the Active Posts widget, and the Editors column, once a plugin such as Agent Users marks them
For Developers
PHP functions, REST endpoints, WP-CLI commands, filters, and room conventions are documented in the GitHub repository.
Background
A feature plugin sponsored by the WordPress Core team, exploring what system-wide presence could look like for a future WordPress release. Follow development on make.wordpress.org/core with the tag #presence-api.
Скриншоттор
Орнотуу
- In your WordPress admin, go to Plugins Add New Plugin and search for “Presence API”, then click Install Now.
- Activate through the Plugins menu.
Or install manually:
- Download the zip and upload the
presence-apifolder to/wp-content/plugins/. - Activate through the Plugins menu.
FAQ.KG
-
Does it work on multisite?
-
Yes. Network-activate it and Network Admin gains a Who’s Online dashboard widget listing the busiest sites and who is on each, an Online column in the Sites list, and an Online view, filter, and column in the Users list. Every site keeps its own widgets and lists, counting only the people on that site.
-
Who can see network-wide presence?
-
Anyone with the
manage_networkcapability, which on a default network means super admins. Thewp_presence_network_capabilityfilter changes what is required. -
Can a site stop recording presence?
-
Yes. Clear the Presence checkbox on Settings > General, or run
wp presence recording set off. Every screen empties as the rows already stored expire. On multisite, Network Admin > Settings has the same checkbox for every site at once; whichever switch is off decides.For code, the
wp_presence_recording_enabledandwp_presence_network_recording_enabledfilters take the checkboxes as their defaults, so a filter always has the last word.
Сын-пикирлер
There are no reviews for this plugin.
Contributors & Developers
“Presence API” is open source software. The following people have contributed to this plugin.
Мүчөлөрү
Translate “Presence API” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Өзгөртүүлөр
Only the most recent releases are listed here. For the full history, see https://github.com/WordPress/presence-api/blob/main/CHANGELOG.md
0.14.0
- REST presence entries no longer include
color, and wp_presence_get_user_color() returns the block editor’s color for the user ID instead of a stored one. - Stop saving and serving presence colors (#707).
- List everyone in the debugger, you first, then by name (#709).
0.13.0
- Write an agent’s presence row when it saves a post (#697).
- Skip trashing in the agent save hook and test only the guards it needs (#700).
- Style the agent badge like the block editor’s Badge (#701).
0.12.2
- Elect the Heartbeat ping leader per site among visible tabs (#675).
- Avoid repeated network summary table checks (#657).
- Read each presence query once per request until the table changes (#678).
- Trust the presence table’s version option and recheck it only after a failed write (#682).
0.12.1
- Translate Heartbeat debugger plurals and units (#660).