Diagnostics
Use this page when the WordPress admin is acting up or WooCommerce isn't syncing, to check your website's setup and fix common host problems yourself.
Quick steps
- In your WordPress admin, go to WooCommerce > BrotherPOS Diagnostics.
- Read down the report. Each row shows OK, a warning, a problem, or information only.
- Fix what it flags (see Quick fixes below).
- Asking for help? Click the box under Copy-paste report (for support), copy it, and paste it into your message to Brother POS support.
Quick fixes
- The page editor is blank, or the media library shows errors — click Disable script concatenation (recommended if admin JS is broken), then hard-reload the WordPress admin (Ctrl+Shift+R). To undo, click Restore default concatenation.
- BrotherPOS ingest URL shows "(not set)", or Shared secret set shows "no" — save your POS API key on the plugin's API Setup tab. If it's still not set, copy the details in by hand — see Connecting the Plugin.
- A product you deactivated is still for sale online — check the Plugin version row. Update to 1.7.21 or newer.
- Images aren't importing — on the plugin's API Setup tab, set Image handling to Link to BrotherPOS image URLs (recommended for slow hosts).
- A JavaScript optimizer is flagged — exclude WordPress core and the plugin's scripts from it, or turn it off for logged-in admins.
More detail: about the Diagnostics page and the one-click fix
The Brother POS WooCommerce plugin includes a Diagnostics page on your WordPress site. It helps when something on your web host is quietly breaking the WordPress admin and you have no server access, no way to edit wp-config.php, and no CDN dashboard.
The page uses almost no JavaScript, so it still works when the rest of the WordPress admin's JavaScript is broken.
Opening the Diagnostics Page
In your WordPress admin, go to WooCommerce > BrotherPOS Diagnostics. You need permission to manage WooCommerce to open it.
WordPress only shows two levels of menu. The plugin's own settings (Weight Pricing) are already a sub-item, so Diagnostics sits directly under WooCommerce to make sure it always shows.
The One-Click Fix
The top of the page has a button to fix broken admin JavaScript.
Many budget hosts serve WordPress's admin scripts as broken "combined" bundles. When that happens you might see:
- A blank block editor when editing a page or product.
- The media library throwing "Cannot read properties of undefined (reading 'View')".
- Buttons that do nothing.
The usual fix means editing wp-config.php. Instead, click Disable script concatenation (recommended if admin JS is broken). The plugin then loads each admin script on its own instead of through the host's broken bundle. Hard-reload the WordPress admin (Ctrl+Shift+R) and check the editor or media library again.
To undo it, click Restore default concatenation.
More detail: what the report shows
What the Report Shows
Each row has a status: OK, a warning, a problem, or information only.
| Section | What it checks |
|---|---|
| WordPress & PHP | WordPress and PHP versions, multisite, active theme, site addresses, HTTPS, memory limit, execution time, cURL, and the GD/Imagick image libraries used for image imports. |
| Admin JavaScript / script loading | Whether scripts are combined, whether core admin scripts are registered, and whether WordPress's combined script file actually serves working JavaScript (the usual cause of blank-editor and media-library errors). |
| Must-use plugins & drop-ins (hidden) | Must-use plugins, drop-ins, and any persistent object cache. These never appear in the normal Plugins list. |
| Edge / CDN / optimizer | Whether Cloudflare is in front of your site, and whether a JavaScript optimizer (Cloudflare Rocket Loader, WP Rocket, LiteSpeed Cache, Autoptimize, SG Optimizer, WP Fastest Cache) is rewriting scripts in a way that can break the admin. |
| REST API & Application Passwords | Whether Application Passwords are available, and whether your site can reach its own home page and REST API. |
| BrotherPOS sync | Plugin version, whether WooCommerce is active, the Brother POS ingest URL, whether the shared secret is set, the image handling mode, and the result of the last product pull. |
Copy-Paste Report for Support
At the bottom of the page is a text box with the whole report as plain text. Click the box to select everything, copy it, and paste it into your message to Brother POS support.
When to Use Diagnostics
- Right after installing the plugin, to confirm the ingest URL and shared secret are set.
- When the WordPress editor or media library is broken. Try the one-click fix first.
- When sync isn't working. Check the BrotherPOS sync rows for the last pull result and whether the secret is set.
- When asking for support. Copy the report so support can see your host setup.
More detail: troubleshooting table
Troubleshooting
| What you see | What to do |
|---|---|
| Blank page editor or media library errors | Look at the load-scripts.php serves backbone/wp-util/media-models row. If it shows a problem, click Disable script concatenation. |
| BrotherPOS ingest URL shows "(not set)" | The plugin hasn't received its connection details yet. Make sure your POS API key is saved on the plugin's API Setup tab. If it still isn't set, an admin can copy the details from Brother POS and paste them into the plugin. See Connecting the Plugin. |
| Shared secret set shows "no" | Same as above: the connection details haven't been set. |
| A JS optimizer is flagged | An optimizer is rewriting core scripts. Exclude WordPress core and the plugin's scripts from it, or turn it off for logged-in admins. |
| A product deactivated in Brother POS is still for sale online | Check the Plugin version row. Version 1.7.21 or newer sets those products to draft on the next pull. See Plugin Sync. |
| Images not importing | Check the GD/Imagick (image import) row. On a slow or limited host, set Image handling on the plugin's API Setup tab to Link to BrotherPOS image URLs (recommended for slow hosts). See Product Sync. |
What's Next?
- Plugin Sync — How the firewall-proof plugin connection works.
- Product Sync — Catalog fields, image modes, and category images.
- Health Monitor — Sync activity from the Brother POS side.