Inspect various aspects of the WordPress Updates API

Andy Fragen

Paul Biron

The WordPress Updates API is pretty much a mystery to many developers for many reasons, not least of which is the fact that there is no documentation for it.
For plugins hosted in the <a href="https://wordpress.org/plugins/" rel="ugc">WordPress Plugin Directory</a> and themes hosted in the <a href="https://wordpress.org/themes/" rel="ugc">WordPress Theme Directory</a> (and core itself), the API “just works”.
Plugins and themes hosted externally (such as premium plugins/themes) need to hook into the API and ensure the proper information is populated in the proper site transients so that core can offer updates for those externally hosted plugins/themes. What site transients are those:
<ul>
<li><code>update_plugins</code></li>
<li><code>update_themes</code></li>
</ul>
(and of course, <code>update_core</code> for core updates).
This plugin attempts to demystify the Updates API by allowing you to inspect:
<ul>
<li>how the API is queried by core</li>
<li>what the API returns in respose to a query</li>
<li>what’s in the site transients core uses when offering updates to admin users (whether manual or auto-updates)</li>
</ul>
At this point, this plugin is very preliminary (it is version 0.1.1 after all), but I’m releasing it in it’s current state because of the new <a href="https://make.wordpress.org/core/2020/07/15/controlling-plugin-and-theme-auto-updates-ui-in-wordpress-5-5/" rel="nofollow ugc">Auto-updates UI in WordPress 5.5.0</a>. While many externally hosted plugins/themes have been hooking into API for years, the new auto-updates UI has certain requirements for how the site transients are populated and not all externally hosted plugins/themes have populated them such that the new UI will work properly (see <a href="https://make.wordpress.org/core/2020/07/30/recommended-usage-of-the-updates-api-to-support-the-auto-updates-ui-for-plugins-and-themes-in-wordpress-5-5/" rel="nofollow ugc">Recommended usage of the Updates API to support the auto-updates UI for Plugins and Themes in WordPress 5.5</a>).
My hope is that by providing an easy way for developers to inspect the API queries/responses and the site transients core populates from them, they will more easily be able to update their code so that the new UI works properly for them.
In future versions, I plan to add many other features, as well as more extensive on-screen help of an “educational” nature.

Updates API Inspector

I'd put together my own self-hosted update module based on various code samples I found, but it stopped working properly in WordPress 5.5. This tool, together with the link in the description helped me to see what was going on and get it running again.

Alternatives to Updates API Inspector

Top alternatives