Title: BugPost
Author: WikiFleeksMedia
Published: <strong>April 12, 2026</strong>
Last modified: April 12, 2026

---

Search plugins

![](https://ps.w.org/bugpost/assets/banner-772x250.png?rev=3504601)

![](https://ps.w.org/bugpost/assets/icon.svg?rev=3504601)

# BugPost

 By [WikiFleeksMedia](https://profiles.wordpress.org/wpbugpost/)

[Download](https://downloads.wordpress.org/plugin/bugpost.1.2.2.zip)

 * [Details](https://wordpress.org/plugins/bugpost/#description)
 * [Reviews](https://wordpress.org/plugins/bugpost/#reviews)
 *  [Installation](https://wordpress.org/plugins/bugpost/#installation)
 * [Development](https://wordpress.org/plugins/bugpost/#developers)

 [Support](https://wordpress.org/support/plugin/bugpost/)

## Description

BugPost adds a lightweight bug reporting button to your site’s frontend. When clicked,
it opens a clean overlay panel where visitors or team members can describe an issue.
Browser details, operating system, viewport size, page URL, page load time, and 
JavaScript console errors are captured automatically — no extra effort needed from
the reporter.

**Key Features:**

 * **One-click reporting** — A “Report” tab on the right side of every page opens
   a simple form.
 * **Auto-captured context** — Browser name and version, OS, viewport dimensions,
   page URL, page load time, and console errors are sent along with every report.
 * **Console error capture** — JavaScript errors and unhandled promise rejections
   are logged automatically and attached to the report.
 * **Reporter fields** — Optional name and email fields let reporters identify themselves.
 * **Honeypot spam protection** — A hidden field traps bots without annoying humans
   with CAPTCHAs.
 * **Rate limiting** — 3 reports per IP per hour prevents abuse.
 * **“Me too” duplicate grouping** — When multiple reports target the same page,
   earlier open reports get a +1 count so you can see which issues affect the most
   people.
 * **Visibility modes** — Choose Beta (logged-in users only) or Public (everyone).
   Turn it off entirely when not needed.
 * **Admin dashboard** — All reports in a familiar WordPress list table with status
   badges, reporter info, page URL, and date columns.
 * **Report detail view** — Each report has a full meta box showing all captured
   context data.
 * **Status workflow** — Mark reports as New, Acknowledged, In Progress, Resolved,
   or Closed.
 * **CSV export** — Download all reports as a CSV file for use in spreadsheets or
   external tools.
 * **Customizable button color** — Match the report button to your site’s brand 
   via a color picker.
 * **Fully translatable** — All strings use WordPress i18n functions with the `bugpost`
   text domain.

**What this plugin does NOT do (by design):**

 * No external API calls, no tracking, no phoning home.
 * No CDN dependencies — all assets are bundled locally.
 * No account required to use the plugin.

## Screenshots

 * [[
 * The “Report” tab on the frontend — always accessible on the right side of the
   page.
 * [[
 * The bug report overlay panel with description field and optional reporter info.
 * [[
 * The admin reports list table showing status, page, reporter, and “me too” counts.
 * [[
 * The report detail view with full auto-captured browser context.
 * [[
 * The settings page with visibility mode and button color options.
 * [[
 * The summary page with total reports, status breakdown, and most-reported pages.

## Installation

 1. Upload the `bugpost` folder to the `/wp-content/plugins/` directory, or install
    directly through the WordPress plugin screen.
 2. Activate the plugin through the “Plugins” screen in WordPress.
 3. Go to **BugPost > Settings** to choose your visibility mode and button color.
 4. Visit your site’s frontend — you should see the “Report” tab on the right side 
    of the page.

## FAQ

### How do visitors submit a bug report?

A “Report” button appears as a vertical tab on the right edge of every page (when
the widget is enabled). Clicking it opens an overlay panel with a text area to describe
the issue, plus optional name and email fields. Browser details and console errors
are captured automatically.

### What data is captured automatically?

Each report includes: the page URL, page title, browser name and version, operating
system, viewport size (width x height), page load time, and any JavaScript console
errors that occurred before the report was submitted.

### How does spam protection work?

The plugin uses two mechanisms: a honeypot field (invisible to humans, filled by
bots) and IP-based rate limiting (3 reports per hour per IP address). No CAPTCHA
is needed.

### Can I export the reports?

Yes. Go to **BugPost > Summary** and click “Export All Reports as CSV.” The export
includes all report fields, context data, and status information.

### What are the visibility modes?

 * **Off** — The widget is completely hidden.
 * **Beta** — The widget appears only for logged-in WordPress users. Great for internal
   QA testing.
 * **Public** — The widget appears for all visitors.

### Does this plugin make external requests?

No. BugPost does not load any external scripts, stylesheets, fonts, or make any 
API calls to outside servers. Everything is self-contained.

### Is this plugin compatible with caching plugins?

Yes. The widget is loaded via standard WordPress script enqueueing and uses AJAX
for submissions. It works with all popular caching plugins.

### Where can I get more features?

The paid versions at [wpbugpost.com](https://wpbugpost.com/pricing.html) add screenshot
capture, annotation tools, custom categories and priorities, GitHub/Jira/Linear 
integrations, email digests, Slack notifications, and more.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“BugPost” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ WikiFleeksMedia ](https://profiles.wordpress.org/wpbugpost/)

[Translate “BugPost” into your language.](https://translate.wordpress.org/projects/wp-plugins/bugpost)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/bugpost/), check out
the [SVN repository](https://plugins.svn.wordpress.org/bugpost/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/bugpost/) by [RSS](https://plugins.trac.wordpress.org/log/bugpost/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.2.2

 * Fixed inline CSS to use wp_add_inline_style() instead of echoing style tags.
 * Improved input sanitization: POST data sanitized with map_deep() at access time.
 * Improved file upload sanitization: each $_FILES field sanitized individually 
   at access.

#### 1.2.1

 * Removed deprecated load_plugin_textdomain() call.
 * Resolved plugin checker warnings for file upload handling and query performance.

#### 1.2.0

 * Renamed plugin from WPBugPost to BugPost.
 * Updated slug, text domain, constants, and all prefixes to `bugpost`.

#### 1.1.2

 * Security: Added server-side MIME type verification for file uploads via wp_check_filetype_and_ext().
 * Security: Added filename sanitization before upload processing via sanitize_file_name().

#### 1.1.1

 * Fixed: Summary page heading now renders em dash correctly instead of showing 
   raw HTML entity.

#### 1.1.0

 * New: File attachments — reporters can attach images, PDFs, and documents to bug
   reports.
 * New: Configurable attachment settings (max files, max size, allowed types).
 * Improved: Submission now uses FormData for reliable file upload support.
 * Updated: Removed file attachments from paid-only features list.

#### 1.0.0

 * Initial release.
 * Frontend bug reporting overlay widget.
 * Auto-captured browser, OS, viewport, page URL, load time, and console errors.
 * Reporter name and email fields.
 * Honeypot spam protection.
 * Rate limiting (3 per IP per hour).
 * “Me too” duplicate grouping.
 * Admin reports list table with status, page, reporter, and date columns.
 * Report detail meta boxes.
 * Status workflow: New, Acknowledged, In Progress, Resolved, Closed.
 * CSV export of all reports.
 * Visibility modes: Off, Beta (logged-in), Public.
 * Customizable button color.
 * Summary page with stats and most-reported pages.
 * Full i18n support.

## Meta

 *  Version **1.2.2**
 *  Last updated **9 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [bug report](https://wordpress.org/plugins/tags/bug-report/)[bug-tracking](https://wordpress.org/plugins/tags/bug-tracking/)
   [error reporting](https://wordpress.org/plugins/tags/error-reporting/)[feedback](https://wordpress.org/plugins/tags/feedback/)
   [q&a](https://wordpress.org/plugins/tags/qa/)
 *  [Advanced View](https://wordpress.org/plugins/bugpost/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/bugpost/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/bugpost/reviews/)

## Contributors

 *   [ WikiFleeksMedia ](https://profiles.wordpress.org/wpbugpost/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/bugpost/)