Skip to main content

benecaster_installed_addons

Filter Free

Filters the list of add-on slugs Benecaster considers loaded on this site. Add-on plugins hook it at benecaster_boot to declare themselves, which moves their card on the Add-ons screen from ‘Ready to install’ into ‘Installed’.

This filter does not grant entitlement, and cannot be used to unlock a paid add-on. Benecaster tracks two separate things: whether you are entitled to an add-on, which comes from your license and is what benecaster_addon_is_active() reports, and whether the add-on is actually loaded on this install, which is what this filter declares. Adding a slug here changes which section a card renders in; it does not change what you are licensed for.

Declare your add-on here outside any entitlement or licence check. Benecaster reads a slug missing from this list as “not loaded”. A transcript URL your add-on owns is then withheld from feeds, the episode page and the REST API, so an add-on that stops declaring itself when its licence lapses hides its own transcripts too. See Keep a restricted transcript private when your add-on is switched off.

Parameters

Name Type Default Description
$slugs array — Array of installed add-on slug strings (e.g. 'benecaster-addon-guest-manager')

Returns: array

Affects

  • Add-ons screen — installed vs. ready-to-install card state

Need this built rather than just documented? See our services →