WP Manifestindependent plugin directory
manifest / developer / bsf-license-debugger

BSF License Debugger

Force a live license check for all BSF products and display the raw server response. Also debugs the bsf_check_product_update() cron path (bsf_get_product_versions) that writes the stored registered/not-registered status. Install on the customer site to diagnose licensing issues, then download a diagnostic report to send back to support.

by Brainstorm Force (Support Debug Tool) · github.com/brainstormforce/bsf-license-debugger

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/brainstormforce/bsf-license-debugger/archive/refs/heads/main.zip
Readme github.com/brainstormforce/bsf-license-debugger ↗

A single-file diagnostic plugin from Brainstorm Force support. It helps diagnose cases where a BSF product license (Astra Pro, Spectra Pro, etc.) unexpectedly resets to not-registered on a site.

The entire plugin is one PHP file — bsf-license-debugger.php — so you can review exactly what it does before installing it.

What it does

  • Forces a live license check against the BSF license server for every registered product, bypassing all local caches, and shows the raw server response.
  • Probes (read-only) the bsf_get_product_versions endpoint — the one whose response is what actually writes the stored registered / not-registered status — and shows what the updater would write, without writing anything.
  • Flags automatically when the two endpoints disagree (license endpoint says valid, versions endpoint says not-registered) — the signature we've seen behind licenses deactivating after a failed renewal.
  • Generates a downloadable plain-text diagnostic report to send back to support.

What it does NOT do

  • The diagnostic report is read-only — nothing on your site is modified to produce it.
  • Purchase keys are masked everywhere in the report.
  • No data is sent anywhere except the same BSF license endpoints your site already talks to; the report only downloads to your browser.

Installation

  1. Download the latest zip from the Releases page (or Code → Download ZIP).
  2. In WordPress, go to Plugins → Add New → Upload Plugin and upload the zip.
  3. Activate the plugin.

Usage

  1. Make sure your licenses are activated (the comparison is only meaningful while the site is supposed to be licensed).
  2. Go to Tools → BSF License Debug.
  3. Click Download Diagnostic Report — this can take up to ~30 seconds since it makes live requests to the license server.
  4. Send the downloaded .txt file to Brainstorm Force support.

If the license drops again later, run the report a second time right after it happens — the mismatch is only visible while the bad state is live.

After you're done

This is a debug tool — deactivate and delete it once the investigation is complete.