Title: Presence API
Author: WordPress.org
Published: <strong>21 de juliol de 2026</strong>
Last modified: 10 de setembre de 2026

---

Buscar complements

![](https://ps.w.org/presence-api/assets/banner-772x250.png?rev=3620136)

![](https://ps.w.org/presence-api/assets/icon.svg?rev=3669719)

# Presence API

 Per [WordPress.org](https://profiles.wordpress.org/wordpressdotorg/)

[Baixar](https://downloads.wordpress.org/plugin/presence-api.0.5.0.zip)

[Live Preview](https://ca-valencia.wordpress.org/plugins/presence-api/?preview=1)

 * [Detalls](https://ca-valencia.wordpress.org/plugins/presence-api/#description)
 * [Ressenyes](https://ca-valencia.wordpress.org/plugins/presence-api/#reviews)
 *  [Instal·lació](https://ca-valencia.wordpress.org/plugins/presence-api/#installation)
 * [Desenvolupament](https://ca-valencia.wordpress.org/plugins/presence-api/#developers)

 [Suport](https://wordpress.org/support/plugin/presence-api/)

## Descripció

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

 * Who’s Online dashboard widget with idle detection
 * Active Posts dashboard widget grouped by post
 * Admin bar indicator showing who’s online, grouped by who’s on this page
 * Editors column in the post list
 * Online filter in the Users list

#### For Developers

PHP functions, REST endpoints, WP-CLI commands, filters, and room conventions are
documented in the [GitHub repository](https://github.com/WordPress/presence-api).

#### Background

An experimental 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](https://make.wordpress.org/core/) with the tag `#presence-
api`.

## Instal·lació

 1. In your WordPress admin, go to **Plugins  Add New Plugin** and search for “Presence
    API”, then click **Install Now**.
 2. Activate through the **Plugins** menu.

Or install manually:

 1. Download the zip and upload the `presence-api` folder to `/wp-content/plugins/`.
 2. Activate through the **Plugins** menu.

## PMF

### 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_network` capability, which on a default network means super
admins. The `wp_presence_network_capability` filter 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 within one TTL 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_enabled` and `wp_presence_network_recording_enabled`
filters take the checkboxes as their defaults, so a filter always has the last word.

## Ressenyes

No hi ha ressenyes per a este complement.

## Col·laboradors i desenvolupadors

«Presence API» és programari de codi obert. La següent gent ha col·laborat en este
complement.

Col·laboradors

 *   [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/)
 *   [ Joe Fusco ](https://profiles.wordpress.org/joefusco/)
 *   [ Ritvik Bhutani ](https://profiles.wordpress.org/intenzi/)
 *   [ Ashish Verma ](https://profiles.wordpress.org/ashishjii/)
 *   [ Deepak Kumar ](https://profiles.wordpress.org/iamchitti/)
 *   [ WP Shark ](https://profiles.wordpress.org/iqbal1hossain/)
 *   [ Asllan Maciel ](https://profiles.wordpress.org/wp24horas/)
 *   [ Aldo Rizona ](https://profiles.wordpress.org/aldorza/)
 *   [ Jignesh Bhavani ](https://profiles.wordpress.org/bejignesh/)
 *   [ stfulldev ](https://profiles.wordpress.org/stfulldev/)
 *   [ Konstantin Obenland ](https://profiles.wordpress.org/obenland/)
 *   [ mori-ikuri ](https://profiles.wordpress.org/moriikuri/)
 *   [ Ishita ](https://profiles.wordpress.org/ishitaj34/)
 *   [ AllyWorker ](https://profiles.wordpress.org/theaminuldev/)
 *   [ Muneeb Ashraf ](https://profiles.wordpress.org/muneebashraf/)
 *   [ John Parris ](https://profiles.wordpress.org/mindctrl/)
 *   [ Zahid Ul Islam ](https://profiles.wordpress.org/zahidui/)
 *   [ Guzel Mitroshina ](https://profiles.wordpress.org/mitgiselle/)

[Traduïx «Presence API» a la teua llengua.](https://translate.wordpress.org/projects/wp-plugins/presence-api)

### T’interessa el desenvolupament?

[Revisa el codi](https://plugins.trac.wordpress.org/browser/presence-api/) , dona
una ullada al [repositori SVN](https://plugins.svn.wordpress.org/presence-api/) 
o subscriu-te al [registre de desenvolupament](https://plugins.trac.wordpress.org/log/presence-api/)
per [RSS](https://plugins.trac.wordpress.org/log/presence-api/?limit=100&mode=stop_on_copy&format=rss).

## Registre de canvis

Only the most recent releases are listed here. For the full history, see https://
github.com/WordPress/presence-api/blob/main/CHANGELOG.md

#### 0.5.0

 * Add a Settings link to the plugin row actions.
 * Let wp_set_presence() accept an explicit GMT timestamp.
 * Bypass the redundant-write guard and validate $date_gmt on wp_set_presence().
 * Request a retina-sharp avatar resolution across the presence surfaces.
 * Stop PHPStan’s bootstrap from silently exiting before analysis.

#### 0.4.0

 * Carry the room’s editor count on the editor heartbeat response.
 * Gate the network column renderers on the network capability.
 * Pin the patched bullseye apt sources to the image’s own frozen snapshot.
 * Public surface read constants.
 * Skip presence writes that would only move the timestamp.

#### 0.3.0

 * Add a site and network switch for whether presence is recorded.
 * Add policy content, exporter and eraser for presence data.
 * Switch presence recording on and off from Settings and WP-CLI.
 * Add data-post-id to server-rendered Active Posts rows.
 * Collapse the duplicated online-ID assembly into one helper.
 * Count everyone present, including yourself, on every surface.
 * Count Who’s Online overflow from the heartbeat total.
 * Declare the current user next to where the bar renders it.
 * Distinguish a non-aggregating network from a quiet one.
 * Keep the network Who’s Online widget’s accessible names across a re-render.
 * List yourself in the widget so its rows match the count above them.
 * Preserve accessible names across heartbeat re-renders in the network Who’s Online
   widget.
 * Report a switched-off site rather than a failed write.
 * Report network aggregation state from the REST and CLI network reads.
 * Restore the named stack limit on the admin bar avatar cap.
 * Run workflows on the release pull request’s final commit.
 * Say so on the network dashboard widget when the network does not aggregate.
 * Say the network does not aggregate on the Users list too.
 * Skip the Playground preview publish when the built SHA is superseded.
 * Warn on the Network Sites list when the network does not aggregate presence.
 * Store network summary rows compact.

#### 0.2.1

 * Filter out archived, spam, and deleted sites from network presence.
 * Gate cross-tab relay on Web Locks availability.
 * Prune network summary rows past the read cutoff.
 * Stop tab coordinator rebroadcast loop when Web Locks is unavailable.

#### 0.2.0

 * Add a network-wide presence summary table.
 * Add a Who’s Online widget to the Network Admin dashboard.
 * Add a wp presence network CLI subcommand for the network-wide summary.
 * Add an Online column to the Network Sites list.
 * Add an Online view and column to the Network Users list.
 * Add network-scoped REST routes for reading presence across a network.
 * Add Playground blueprint for multisite network demo.
 * Announce admin room changes with an action.
 * Expose network presence via REST and WP-CLI.
 * Let the network summary skip sites so callers can paginate.
 * Push each site’s online set into the network summary.
 * Read the network summary as a capped snapshot.
 * Boot the multisite Playground preview through wp-cli steps.
 * Bring the stale-screen banner back after a dismissal.
 * Carry each site’s own scheme in the network summary row.
 * Clear a user’s presence when their account or site membership ends.
 * Detect the collaboration edge across requests.
 * Exclude Codecov config and Jest test from release zip.
 * Outlast core’s unfocused heartbeat interval in the presence TTL.
 * Preserve focus across heartbeat re-renders in the network Who’s Online widget.
 * Refresh the network summary timestamp unconditionally.
 * Register the network summary table name idempotently.
 * Register the presence table name idempotently.
 * Require manage_options to reach the debugger widget.
 * Serve Playground preview assets over an origin that allows CORS.
 * Skip an avatar-less user in the stack instead of drawing an empty img.
 * Skip notifications for no-op presence changes.
 * Store collaboration state only while two editors are present.
 * Style the avatar stack on the Network Admin Sites list.
 * Gate network presence aggregation on wp_is_large_network().
 * Gate network summary reads on wp_is_large_network().
 * Gate the network summary push on wp_is_large_network().

## Complement de la comunitat

This plugin is developed and supported by a community. [Contribuïx a este complement](https://github.com/WordPress/presence-api)

## Meta

 *  Versió **0.5.0**
 *  Última actualització **fa 1 setmana**
 *  Instal·lacions actives: **10+**
 *  Versió de WordPress: ** 7.0 o posterior **
 *  Provat fins a **7.1.1**
 *  Versió de PHP: ** 7.4 o posterior **
 *  Idioma
 * [English (US)](https://wordpress.org/plugins/presence-api/)
 * Etiquetes
 * [awareness](https://ca-valencia.wordpress.org/plugins/tags/awareness/)[heartbeat](https://ca-valencia.wordpress.org/plugins/tags/heartbeat/)
   [presence](https://ca-valencia.wordpress.org/plugins/tags/presence/)[real-time](https://ca-valencia.wordpress.org/plugins/tags/real-time/)
 *  [Vista avançada](https://ca-valencia.wordpress.org/plugins/presence-api/advanced/)

## Valoracions

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/presence-api/reviews/#new-post)

[Vore totes les ressenyes](https://wordpress.org/support/plugin/presence-api/reviews/)

## Col·laboradors

 *   [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/)
 *   [ Joe Fusco ](https://profiles.wordpress.org/joefusco/)
 *   [ Ritvik Bhutani ](https://profiles.wordpress.org/intenzi/)
 *   [ Ashish Verma ](https://profiles.wordpress.org/ashishjii/)
 *   [ Deepak Kumar ](https://profiles.wordpress.org/iamchitti/)
 *   [ WP Shark ](https://profiles.wordpress.org/iqbal1hossain/)
 *   [ Asllan Maciel ](https://profiles.wordpress.org/wp24horas/)
 *   [ Aldo Rizona ](https://profiles.wordpress.org/aldorza/)
 *   [ Jignesh Bhavani ](https://profiles.wordpress.org/bejignesh/)
 *   [ stfulldev ](https://profiles.wordpress.org/stfulldev/)
 *   [ Konstantin Obenland ](https://profiles.wordpress.org/obenland/)
 *   [ mori-ikuri ](https://profiles.wordpress.org/moriikuri/)
 *   [ Ishita ](https://profiles.wordpress.org/ishitaj34/)
 *   [ AllyWorker ](https://profiles.wordpress.org/theaminuldev/)
 *   [ Muneeb Ashraf ](https://profiles.wordpress.org/muneebashraf/)
 *   [ John Parris ](https://profiles.wordpress.org/mindctrl/)
 *   [ Zahid Ul Islam ](https://profiles.wordpress.org/zahidui/)
 *   [ Guzel Mitroshina ](https://profiles.wordpress.org/mitgiselle/)

## Suport

Tens alguna cosa a dir? Necessites ajuda?

 [Vore els fòrums de suport](https://wordpress.org/support/plugin/presence-api/)