Appearance
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
- Navigate to Voxel Toolkit → Widgets in your WordPress admin
- Find Article Helpful in the list
- Toggle the switch to enable the widget
- Click Save Changes
Step 2: Add to Template
- Edit your article or post template in Elementor
- Search for Article Helpful (VT)
- Drag the widget to your desired location
- Configure content and styling
- Save the template
Widget Settings
Content Settings
| Setting | Description | Default |
|---|---|---|
| Heading Text | The question displayed above buttons | “Was this article helpful?” |
| Yes Button Text | Text on the positive vote button | “Yes” |
| No Button Text | Text on the negative vote button | “No” |
| Success Message | Message shown after voting | “Thank you for your feedback!” |
| Vote Updated Message | Message when user changes vote | “Your vote has been updated.” |
| Already Voted Message | Message for duplicate vote | “You have already voted this way.” |
| Show Icons | Display thumbs up/down icons | Yes |
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 Tag | Description |
|---|---|
@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