Contents

Feedback Widget — Plugixa FAQ

The feedback widget lets visitors rate each FAQ as helpful or not helpful, optionally leaving a comment. Free includes the widget; Pro adds the analytics dashboard and per-FAQ breakdown.

What visitors see

Under each FAQ answer, two buttons appear:

  Was this helpful?

  [ 👍 Yes (12) ]   [ 👎 No (3) ]

Clicking a button records the vote. If the FAQ is configured to ask for a comment, a textarea appears inline.

Feedback widget on the frontend

Enabling the widget

The widget can be enabled at four levels (highest priority wins):

  1. Shortcode — [plugixa_faq feedback_enabled="true"]
  2. FAQ-level — Feedback enabled toggle on the FAQ editor (NULL = inherit from category).
  3. Category-level — Feedback enabled toggle on the category.
  4. Global — Settings → Feedback → Enable feedback.

Settings

Plugixa FAQ → Settings → Feedback

Setting Default Description
Enable feedback Off Master toggle.
Require login Off Only logged-in users can vote.
Show counts Off Display running totals next to buttons.
Feedback cooldown (hours) 24 Minimum time before the same visitor can vote on the same FAQ again.
Text placeholder “Please tell us how we can improve this answer…” Placeholder in the comment textarea.
Thank-you message “Thank you for your feedback!” Shown after submission.
reCAPTCHA Off Require v3 reCAPTCHA pass.

Feedback settings

Voting identity

To prevent the same person voting repeatedly, the plugin tracks a combination of:

  • user_id (if logged in)
  • user_ip
  • session_id (stored in a cookie)

Within the cooldown window, duplicate votes are rejected with a 429 response.

Analytics dashboard PRO

Go to Plugixa FAQ → Feedback.

Feedback dashboard

The dashboard shows:

  • Total helpful / not helpful votes.
  • Top 10 most-helpful FAQs.
  • Bottom 10 (FAQs flagged as unhelpful — candidates to rewrite).
  • Vote volume over time (sparkline).
  • Recent feedback comments.

Filters

Feedback filters

Filter by:

  • Date range
  • Category
  • FAQ
  • Vote type (helpful / not helpful)
  • Has comment / no comment
  • Language (when multilingual is active)

Feedback analytics view

Feedback analytics breakdown

Per-FAQ breakdown includes vote distribution, trend over time, and every comment received.

REST API

Method Endpoint Description
GET /wp-json/plugixa-faq/v1/feedback List with filters. Admin-only.
POST /wp-json/plugixa-faq/v1/feedback Submit a vote. Public. Body: { faq_id, is_helpful, feedback_text?, recaptcha_token? }.
GET /wp-json/plugixa-faq/v1/feedback/check/{faq_id} Check if current user already voted.
GET /wp-json/plugixa-faq/v1/feedback/stats PRO Aggregated statistics.
DELETE /wp-json/plugixa-faq/v1/feedback/{id} Delete a feedback row (admin).
DELETE /wp-json/plugixa-faq/v1/feedback/bulk Bulk delete.

Customizing the widget

Template override

Copy templates/frontend/feedback-widget.php to {your-theme}/plugixa-faq/feedback-widget.php and edit. See Hooks → Template System.

Hooks

Hook Type Description
plugixa_faq_feedback_permission filter Determine whether the current user can vote.
plugixa_faq_feedback_data filter Modify feedback payload before save.
plugixa_faq_before_save_feedback action Run before the row is inserted.
plugixa_faq_after_save_feedback action Run after save — integrate with your CRM here.

Moderating feedback

From the admin list, delete individual or bulk rows. There is no “approve” step — feedback is recorded on submit and can be deleted after the fact.

To reset counts on a specific FAQ, delete all of its feedback rows — the counts auto-recalculate.

Common patterns

Only ask for a comment on “not helpful”

That’s the default. “Yes” is a one-click vote; “No” opens the textarea inline.

Disable for specific categories

Toggle Feedback enabled off on the category. Every FAQ in that category inherits the off state (unless overridden at the FAQ level).

Export feedback for analysis

Pro users: use the Import/Export module with the feedback scope. Free users: fetch via REST and pipe through a spreadsheet.

Quick Links

Plugin page Changelog