Title: Help Metric Article Helpful Feedback
Author: Jose Varghese
Published: <strong>May 3, 2026</strong>
Last modified: August 24, 2026

---

Search plugins

![](https://ps.w.org/help-metric-article-helpful-feedback/assets/banner-772x250.
png?rev=3582415)

![](https://ps.w.org/help-metric-article-helpful-feedback/assets/icon-256x256.gif?
rev=3582595)

# Help Metric Article Helpful Feedback

 By [Jose Varghese](https://profiles.wordpress.org/josevarghese/)

[Download](https://downloads.wordpress.org/plugin/help-metric-article-helpful-feedback.1.1.4.zip)

 * [Details](https://vec.wordpress.org/plugins/help-metric-article-helpful-feedback/#description)
 * [Reviews](https://vec.wordpress.org/plugins/help-metric-article-helpful-feedback/#reviews)
 *  [Installation](https://vec.wordpress.org/plugins/help-metric-article-helpful-feedback/#installation)
 * [Development](https://vec.wordpress.org/plugins/help-metric-article-helpful-feedback/#developers)

 [Support](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/)

## Description

Ever wondered if your readers actually find your articles helpful? **Help Metric
Article Helpful Feedback** makes it incredibly easy for your visitors to tell you
if your content hits the mark.

We built this plugin because we wanted a lightning-fast alternative to heavy survey
plugins and a much better option than basic vote counters. It adds a clean, friendly“
Was this page helpful?” widget right at the bottom of your posts, pages, or WooCommerce
products.

Visitors simply click Yes or No, and they can optionally drop a quick comment to
explain why. You get a real-time picture of exactly what’s working and what needs
improvement, right inside your WordPress dashboard. If you’re looking for the best
WordPress feedback plugin that balances simplicity with powerful analytics, you’ve
found it!

No third-party services, no tracking scripts, no bloat. All data stays in your own
database.

#### Why use Help Metric Article Helpful Feedback?

Most feedback plugins are either too simple (just a vote counter) or too complex(
full survey tools). This plugin sits in the sweet spot: it’s quick for visitors 
to use, gives you genuinely useful data, and has the professional features – GDPR
tools, rate limiting, email alerts, analytics charts – that serious sites need without
paying for a SaaS platform.

#### Key Features

**Widget & Placement**

 * **Easy Setup** – works out of the box with sensible defaults; no configuration
   required to get started
 * **Gutenberg Block** – insert the widget anywhere using the native block editor
 * **Shortcode** – place the widget manually with `[hmahf_widget]` in any classic
   editor, page builder, or text widget
 * **Content Type Selection** – choose which post types display the widget (posts,
   pages, custom post types, WooCommerce products)
 * **Per-Post Disable Toggle** – hide the widget on individual posts from the editor
   sidebar without touching global settings
 * **Auto-Hide on Old Posts** – optionally stop showing the widget on posts older
   than a set number of days
 * **WooCommerce Support** – display the widget on product pages

**Appearance**

 * **5 SVG Icon Styles** – choose from Thumbs, Stars, Hearts, Faces, or Arrows with
   a live visual picker in Settings; icons update across the widget, feedback form,
   dashboard cards, and admin bar
 * **Customizable Text** – change every text element (title, subtitle, button labels,
   success messages, form text) to match your brand voice
 * **Clean Design** – professional, minimal layout that fits any theme without CSS
   conflicts
 * **Mobile Responsive** – touch-friendly buttons, stacked layouts on small screens
 * **Accessibility Ready** – full keyboard navigation and ARIA screen reader support

**Feedback Collection**

 * **Optional Written Comments** – visitors who click “Not helpful” can explain 
   why in a short text field
 * **Vote Change / Retraction** – a “Changed your mind?” link lets visitors update
   their vote after submitting
 * **Duplicate Submission Prevention** – cookie-based, IP-based, or open (your choice)
 * **Rate Limiting** – server-side protection against spam (max 5 submissions per
   IP per hour)
 * **AJAX Powered** – smooth experience with no page reloads

**Analytics & Reporting**

 * **Analytics Dashboard** – overview cards showing total, positive, negative, and
   ratio stats; cards use your selected icon style
 * **30-Day Trend Chart** – pure CSS bar chart showing daily positive and negative
   counts over the last 30 days (no external libraries)
 * **Distribution Chart** – CSS conic-gradient donut showing your overall positive/
   negative split
 * **Statistics Page** – per-post feedback breakdown with sortable columns and date/
   post-type filters
 * **Feedback List** – browse, filter, and search all individual feedback entries
   and comments with pagination
 * **CSV Export** – export your statistics data with one click
 * **Admin Bar Stats** – The WP admin bar shows today’s feedback counts with your
   selected icons, keeping them visible to administrators at all times

**Notifications & Privacy**

 * **Email Notifications** – get an email alert (including the visitor’s comment)
   whenever a visitor submits negative feedback; configure the recipient address
   as needed
 * **GDPR Tools** – configurable data retention period (auto-purge entries older
   than N days) and one-click deletion of all collected data
 * **IP Anonymization** – The plugin masks IP addresses in the admin feedback display

**Developer-Friendly**

 * **Four Action/Filter Hooks** – `hmahf_widget_html`, `hmahf_max_submissions_per_hour`,`
   hmahf_before_feedback_submit`, `hmahf_after_feedback_submit`
 * **Translation Ready** – fully internationalized with proper text domains
 * **No External Dependencies** – no CDN calls, no third-party APIs, no tracking

#### Perfect For

 * Documentation and knowledge base sites
 * Blog posts and tutorials
 * Help centre articles
 * WooCommerce product pages
 * Any content where knowing what resonates helps you improve

#### Customization Options

 * Enable/disable the feedback widget globally
 * Select which content types show the widget
 * Choose from 5 SVG icon styles via a visual picker
 * Customize all widget and form text to match your brand
 * Choose duplicate-submission prevention method (cookie, IP, or none)
 * Set cookie expiration in days
 * Auto-hide widget on posts older than N days
 * Per-post disable toggle from the editor sidebar
 * Configure data retention period for GDPR compliance
 * Set a custom email address for negative-feedback notifications

We take your privacy seriously. The plugin safely stores all feedback data as WordPress
post meta right in your own database. It never sends anything to an external service.

## Screenshots

[⌊Admin dashboard with overview cards, trend chart, and distribution chart⌉⌊Admin
dashboard with overview cards, trend chart, and distribution chart⌉[

Admin dashboard with overview cards, trend chart, and distribution chart

[⌊Settings page - General Settings with the visual icon style picker⌉⌊Settings page-
General Settings with the visual icon style picker⌉[

Settings page – General Settings with the visual icon style picker

[⌊Settings page - Text customization options for all text⌉⌊Settings page - Text 
customization options for all text⌉[

Settings page – Text customization options for all text

[⌊Settings page - Form settings and GDPR⌉⌊Settings page - Form settings and GDPR⌉[

Settings page – Form settings and GDPR

[⌊Settings page - Admin display and Email notifications option⌉⌊Settings page - 
Admin display and Email notifications option⌉[

Settings page – Admin display and Email notifications option

[⌊Feedback list with search, type filter, and pagination⌉⌊Feedback list with search,
type filter, and pagination⌉[

Feedback list with search, type filter, and pagination

## Blocks

This plugin provides 1 block.

 *   Helpful Feedback Widget

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/help-metric-article-helpful-
    feedback` directory, or install the plugin through the WordPress plugins screen
    directly.
 2. Activate the plugin through the **Plugins** screen in WordPress.
 3. Navigate to **Settings > Helpful Feedback** to configure the plugin.
 4. Choose your icon style, customize the text, and select which content types show
    the widget.
 5. The feedback widget will automatically appear on your selected content types.
 6. View results under the **Helpful Feedback** menu in the WordPress admin sidebar.

## FAQ

### Does this plugin work with any theme?

Yes. The widget uses clean, minimal styling that blends with any properly coded 
WordPress theme. No theme-specific overrides needed.

### Can I customize the appearance?

Yes. Choose from 5 SVG icon styles (Thumbs, Stars, Hearts, Faces, Arrows) via a 
visual picker in Settings, and customize all text elements. Additional layout options
are planned for future releases.

### Where does the plugin store the feedback data?

The plugin stores all data as WordPress post meta in your own database. It sends
nothing to any external service.

### Does the plugin support translations?

Yes! We built the plugin to be fully translation ready, using proper text domains
and translation functions everywhere.

### Does it work on mobile devices?

Yes. The widget is fully responsive with touch-friendly buttons and stacked layouts
on small screens.

### Can I see feedback statistics?

Yes. Navigate to **Helpful Feedback > Statistics** to see per-post feedback counts,
ratios, and trends. Filter by post type and date range, sort any column, and export
to CSV. The main dashboard also shows a 30-day trend bar chart and a distribution
donut chart.

### How does duplicate submission prevention work?

Choose from three methods in Settings:
 – **Cookie** (recommended): The plugin sets
a browser cookie after submission, expiring after your configured number of days.–**
IP Address**: The plugin records the visitor’s IP and checks it on future submissions.–**
None**: The plugin allows multiple submissions (useful for open polls).

### Can visitors change their vote?

Yes. After submitting, a “Changed your mind? Update your vote.” link appears below
the success message. Clicking it re-shows the widget so the visitor can select a
different option.

### How do the SVG icon styles work?

Go to **Settings > Helpful Feedback > Icon Style** and click any of the five icon
pairs shown (Thumbs, Stars, Hearts, Faces, Arrows). Save settings and the icon you
chose will appear on the widget buttons, the feedback form, the dashboard cards,
and the admin bar stats – everywhere consistently.

### Is there spam protection?

Yes. The plugin enforces a server-side rate limit of 5 submissions per IP address
per hour, regardless of the duplicate-submission setting.

### Is it GDPR compliant?

Yes. You can set an automatic data retention period (the plugin purges entries older
than N days on retrieval) and use the “Delete All Feedback Data” button in Settings
to permanently remove all collected feedback. The plugin anonymizes IP addresses
shown in the admin.

### Will this slow down my site?

No. The plugin is lightweight and only loads its CSS/JS on pages where the widget
displays. The plugin only loads admin scripts on its own pages. Dashboard queries
use object caching and target only posts that actually have feedback data.

### Can I disable the widget on a specific post?

Yes. Open any post or page in the editor and look for the **Helpful Feedback** panel
in the right sidebar. Check “Disable feedback widget on this post” to hide it on
that individual post without affecting global settings.

### Can I place the widget manually?

Yes. Use the `[hmahf_widget]` shortcode in any classic editor or page builder, or
insert the **Helpful Feedback Widget** block from the Gutenberg block inserter.

### Does it work with WooCommerce products?

Yes. Select “Products” under Content Types in Settings and the widget will appear
on your WooCommerce product pages automatically.

### How do email notifications work?

Enable notifications under **Settings > Helpful Feedback > Email Notifications**.
You will receive an email whenever a visitor submits negative feedback, including
any comment they left. Leave the address blank to use the WordPress admin email,
or enter a custom address.

### What are the admin bar stats?

When logged in as an administrator, the WordPress admin bar shows today’s positive
and negative feedback counts using your chosen icon style. Clicking the stat takes
you directly to the dashboard.

### How do I change the IP rate limit for duplicate submissions?

By default, the plugin limits submissions to 5 per hour per IP address to block 
spam bots. If you are running a site on a shared network or intranet where many 
legitimate users share the same IP, you can increase this limit using a filter in
your theme’s `functions.php`:
 `function my_custom_hmahf_rate_limit( $limit ) { 
return 50; } add_filter( 'hmahf_max_submissions_per_hour', 'my_custom_hmahf_rate_limit');

### Can developers extend the plugin?

Yes. The following hooks are available. (Note: use `add_filter()` or `add_action()`
in your code to hook into these):
 – `hmahf_widget_html` (filter) – modify the widget
output. Passes `$html`, `$settings`, `$post_id`. – `hmahf_max_submissions_per_hour`(
filter) – change the maximum number of submissions allowed per IP address per hour.
Passes `$max_submissions` (default: 5). – `hmahf_before_feedback_submit` (action)–
fires before the plugin stores data. Passes `$post_id`, `$feedback`, `$comment`.–`
hmahf_after_feedback_submit` (action) – fires after the plugin stores data. Passes`
$post_id`, `$feedback`, `$comment`.

## Reviews

![](https://secure.gravatar.com/avatar/94e13b5bf9584492a07f1d6ff43310c55a6b8e23384caf7d15e3896dfe24fa80?
s=60&d=retro&r=g)

### 󠀁[Simple and effective user feedback tool](https://wordpress.org/support/topic/simple-and-effective-user-feedback-tool/)󠁿

 [Sid](https://profiles.wordpress.org/isildur00/) May 5, 2026 1 reply

A lightweight and straightforward plugin for collecting helpful feedback directly
on articles. Easy to set up, works out of the box, and provides a clear way to understand
whether your content is useful to readers. Great option if you want quick insights
without adding complexity to your site.

 [ Read all 2 reviews ](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/reviews/)

## Contributors & Developers

“Help Metric Article Helpful Feedback” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ Jose Varghese ](https://profiles.wordpress.org/josevarghese/)

[Translate “Help Metric Article Helpful Feedback” into your language.](https://translate.wordpress.org/projects/wp-plugins/help-metric-article-helpful-feedback)

### Interested in development?

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

## Changelog

#### 1.1.4

 * Minor tweaks to the modal.

#### 1.1.2

 * Fix – Custom success message from settings now displays correctly on the frontend
 * Dev – Added `hmahf_max_submissions_per_hour` filter to allow developers to adjust
   the global IP-based rate limiting threshold, check FAQ for details.

#### 1.1.1

**Compatibility**

 * Fixed compatibility with the WordPress 7.0 Real-Time Collaboration feature – 
   the plugin now suppresses the classic per-post metabox in the block editor so
   it no longer locks the post for collaborators

#### 1.1.0

 * Added deactivation feedback modal – prompts for a reason when deactivating the
   plugin

#### 1.0.0

 * Initial release
 * Full customization options for all text elements
 * Content type selection (posts, pages, custom post types)
 * AJAX-powered feedback submission
 * Duplicate submission prevention (cookie and IP methods)
 * Mobile responsive design
 * Accessibility features (ARIA labels, keyboard navigation)
 * Added Gutenberg block – insert the “Helpful Feedback Widget” block anywhere in
   the block editor
 * Added `[hmahf_widget]` shortcode for manual widget placement in classic content
   and page builders
 * Added per-post disable toggle – hide the widget on individual posts via the editor
   sidebar metabox
 * Added WooCommerce product page support – enable the widget on product pages via
   Content Type settings
 * Added vote change/retraction – visitors can update their vote after submitting
   via a “Changed your mind?” link
 * Added full analytics dashboard with overview cards (total, positive, negative,
   ratio)
 * Added Statistics page with sortable columns and post type / date range filters
 * Added Feedback List page with search, type filter, and pagination
 * Added CSV export for statistics data
 * Added GDPR data retention setting – automatically purge entries older than N 
   days
 * Added “Delete All Feedback Data” button with confirmation for full data removal
 * Added IP anonymization in admin feedback display
 * Added server-side rate limiting (max 5 submissions per IP per hour)
 * Option to hide the admin bar stats widget via Settings > Notifications > Admin
   Bar Stats
 * Updated Tested up to: 6.9
 * Added SVG icon styles – choose from Thumbs, Stars, Hearts, Faces, or Arrows via
   a visual icon picker in Settings

## Meta

 *  Version **1.1.4**
 *  Last updated **1 month ago**
 *  Active installations **10+**
 *  WordPress version ** 6.1 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/help-metric-article-helpful-feedback/)
 * Tags
 * [documentation](https://vec.wordpress.org/plugins/tags/documentation/)[feedback](https://vec.wordpress.org/plugins/tags/feedback/)
   [helpful](https://vec.wordpress.org/plugins/tags/helpful/)[rating](https://vec.wordpress.org/plugins/tags/rating/)
   [user experience](https://vec.wordpress.org/plugins/tags/user-experience/)
 *  [Advanced View](https://vec.wordpress.org/plugins/help-metric-article-helpful-feedback/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/reviews/)

## Contributors

 *   [ Jose Varghese ](https://profiles.wordpress.org/josevarghese/)

## Support

Issues resolved in last two months:

     1 out of 1

 [View support forum](https://wordpress.org/support/plugin/help-metric-article-helpful-feedback/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://buymeacoffee.com/josevarghese)