Voxel Toolkit 1.6.1 is Available!

Article Helpful Widget

The Article Helpful widget adds a “Was this article helpful?” feedback section to your posts. Visitors can vote Yes or No, and the votes are tracked for use with dynamic tags and search sorting.


Overview

Add a simple thumbs up/down voting widget to knowledge base articles, FAQs, tutorials, or any content where you want to measure helpfulness. Votes are stored per post and can be displayed using dynamic tags or used for sorting search results.

Key Features

  • Yes/No voting buttons with thumbs icons
  • Customizable button text and messages
  • Vote tracking for logged-in users and guests
  • Users can change their vote
  • Full Elementor styling controls
  • Dynamic tags for vote counts
  • Works with Helpful Votes Sorting function

Setup Instructions

Step 1: Enable the Widget

  1. Navigate to Voxel Toolkit > Widgets in your WordPress admin
  2. Find Article Helpful in the list
  3. Toggle the switch to enable the widget
  4. Click Save Changes

Step 2: Add to Template

  1. Edit your article or post template in Elementor
  2. Search for Article Helpful (VT)
  3. Drag the widget to your desired location
  4. Configure content and styling
  5. Save the template

Widget Settings

Content Settings

SettingDescriptionDefault
Heading TextThe question displayed above buttons“Was this article helpful?”
Yes Button TextText on the positive vote button“Yes”
No Button TextText on the negative vote button“No”
Success MessageMessage shown after voting“Thank you for your feedback!”
Vote Updated MessageMessage when user changes vote“Your vote has been updated.”
Already Voted MessageMessage for duplicate vote“You have already voted this way.”
Show IconsDisplay thumbs up/down iconsYes

Styling Options

Heading Style

  • Text color
  • Typography (font family, size, weight)
  • Spacing below heading
  • Alignment (left, center, right)

Button Style

  • Typography
  • Padding
  • Spacing between buttons
  • Border radius
  • Alignment

Yes Button Colors

  • Normal: text color, background color
  • Hover: text color, background color

No Button Colors

  • Normal: text color, background color
  • Hover: text color, background color

Icon Style

  • Icon size
  • Icon spacing
  • Icon colors (normal and hover for each button)

Container Style

  • Padding
  • Background color
  • Border
  • Border radius

Dynamic Tags

When the widget is enabled, these dynamic tags become available:

Dynamic TagDescription
@post(article_helpful_yes_count)Number of “Yes” votes
@post(article_helpful_no_count)Number of “No” votes
@post(article_helpful_total_votes)Total votes (yes + no)
@post(article_helpful_percentage)Percentage of yes votes (0-100)

Vote Tracking

Logged-in Users

Votes are stored in user meta, so they persist across devices and sessions.

Guest Users

Votes are stored in browser cookies, so they persist in the same browser.

Changing Votes

Users can change their vote at any time. The vote counts update automatically.


Use Cases

Knowledge Base

Add to help articles to measure which documentation is most useful.

FAQ Pages

Let users vote on which FAQ answers were helpful.

Tutorials

Measure tutorial effectiveness and identify content needing improvement.

Product Guides

Collect feedback on product documentation and guides.


Troubleshooting

Votes Not Saving

  • Check browser console for JavaScript errors
  • Verify AJAX requests aren’t being blocked
  • For guests, ensure cookies are enabled

Dynamic Tags Returning 0

  • The post may not have any votes yet
  • Verify you’re using the tag in a post context

Widget Not Appearing

  • Check that the widget is enabled in Toolkit settings
  • Verify it’s added to the correct template
  • Clear caching plugins
AI Assistant