Description
LanternHQ Bug Reporter is a lightweight plugin that makes it effortless to add the Lantern bug reporting widget to any WordPress site. No code editing required — simply paste your embed key from the Lantern dashboard, save, and the widget is live for every visitor.
How it works
- Install and activate the plugin.
- Go to Settings Lantern in your WordPress admin.
- Paste your embed key and click Save Embed Key.
- The Lantern widget is now active on every public page of your site.
What gets added to your site
The plugin loads a single, lightweight script from https://lanternhq.app/api/widget/script on every public page. Your embed key is passed to the script to identify your Lantern workspace. No server-side requests are made — the script is fetched entirely by the visitor’s browser.
Features
- One-field setup — just your embed key.
- Zero impact on page load — deferred script injection.
- Clean uninstall — removing the plugin stops all widget output immediately.
- No external requests from the server; the script is loaded entirely by the visitor’s browser.
External Services
This plugin connects to the Lantern bug tracking service (lanternhq.app) to enable the bug reporting widget.
When the plugin is active, it loads a JavaScript file from https://lanternhq.app/api/widget/script on all frontend pages. The embed key configured in the plugin settings is passed to this script to identify your Lantern workspace. Bug reports submitted by users are sent to the Lantern API.
- Service: Lantern (lanternhq.app)
- Data sent: embed key on page load; bug report data (title, description, browser, device) on submission
- Terms of Service: https://lanternhq.app/terms
- Privacy Policy: https://lanternhq.app/privacy
Installation
From the WordPress plugin directory (recommended)
- In your WordPress admin, go to Plugins Add New.
- Search for LanternHQ Bug Reporter.
- Click Install Now, then Activate.
- Go to Settings LanternHQ Bug Reporter, paste your embed key, and click Save Embed Key.
Manual installation
- Download the plugin zip file.
- In your WordPress admin, go to Plugins Add New Upload Plugin.
- Choose the zip file and click Install Now, then Activate.
- Go to Settings LanternHQ Bug Reporter, paste your embed key, and click Save Embed Key.
Via FTP
- Unzip the plugin and upload the
lanternfolder to/wp-content/plugins/. - Activate the plugin through the Plugins screen in WordPress.
- Go to Settings LanternHQ Bug Reporter, paste your embed key, and click Save Embed Key.
FAQ
-
Where do I find my embed key?
-
Log in to your Lantern dashboard at lanternhq.app, open your project, and go to Project Settings. Your embed key is displayed there and starts with
ltrn_. -
Will the widget slow down my site?
-
No. The widget script is injected with the
deferattribute, meaning the browser only fetches and runs it after your page has fully parsed. It will not block rendering or affect your Core Web Vitals score. -
Can I disable the widget on specific pages?
-
Not in the current version. The script is injected globally on all public-facing pages. Per-page control is planned for a future release.
-
What happens if I deactivate the plugin?
-
Deactivating the plugin immediately stops the script from being injected. Your embed key is preserved in the database so it will be restored if you reactivate. To remove the stored key entirely, delete the plugin.
-
Is the plugin compatible with caching plugins?
-
Yes. The script tag is injected at runtime via
wp_head, so it will be present in any cached page HTML that includes the full<head>section. -
Does the plugin work with page builders like Elementor or Divi?
-
Yes. Because the widget is injected into
wp_headat the theme level, it works with any page builder or theme that uses a standard WordPress<head>.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“LanternHQ Bug Reporter” is open source software. The following people have contributed to this plugin.
Contributors
Translate “LanternHQ Bug Reporter” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0 — 2025-05-24
- Initial release.
- Settings page added under Settings LanternHQ Bug Reporter.
- Embed key stored securely in
wp_optionsvia the WordPress Settings API. - Widget script injected into
wp_headon all public-facing pages when an embed key is present.