=== PushFeedback – Feedback Widget with Screenshots ===
Contributors: techdocsstudio
Tags: feedback, feedback widget, feedback button, user feedback, bug report
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Feedback widget with a floating button. Visitors rate pages, comment, and send annotated screenshots that land in wp-admin. Two-minute setup.

== Description ==

PushFeedback adds a feedback widget to your WordPress site.
Visitors click a feedback button, answer "Was this page helpful?", write a message, and attach an annotated screenshot, all without leaving the page.
Every entry lands in your PushFeedback dashboard and in wp-admin, so you hear about confusing pages and bugs instead of silence.

It fits any WordPress site: a blog, a shop, a membership site, a client build, or docs. The widget restyles to match your brand, so it looks native, not bolted on.

**What you get**

* **One-click feedback** - a rating and an optional message, with no forms to build
* **Annotated screenshots** - visitors highlight and comment on what they saw, so bug reports explain themselves
* **Put it anywhere** - a floating button, an edge tab, the `[pushfeedback]` shortcode inside a post, or a fully embedded form with `[pushfeedback embedded="true"]`, several at once and each configured differently
* **Make it yours** - colors, button style and roundness, your theme's font, and every label, placeholder and message, with a live preview that updates as you type
* **Read it in wp-admin** - your latest feedback with ratings, screenshots and the source page, and thumbs or stars to spot problem pages fast
* **Show it only where it helps** - include / exclude URL rules, and an optional or required email field
* **Analytics and notifications** - your PushFeedback dashboard adds a sentiment analytics view (busiest pages, what needs attention) and alerts by email, Slack, Jira, Microsoft Teams, webhooks, Zapier or Make

**Free and paid plans**

Every feature in this plugin works on every plan. Plans differ only in what the PushFeedback service stores and shows.

* **Free** - never expires, no credit card. 25 feedback entries, one site, and email notifications.
* **Past 25 entries** - feedback keeps arriving and is saved. Upgrade to unlock it. Nothing is ever deleted.
* **Paid plans** - more entries, and notifications to Slack, Jira, Microsoft Teams, webhooks, Zapier and Make.
* **Unlimited** - unlimited entries and sites, plus AI reports that summarize recurring themes and recommendations.

See https://pushfeedback.com/pricing.

**External services**

This plugin relies on PushFeedback, a third-party service, to store and manage feedback entries.
Data submitted through the widget is sent to app.pushfeedback.com.
The plugin also contacts app.pushfeedback.com to verify your project ID, load your project configuration, list your feedback entries on the wp-admin Feedback page, and update your project's site URL when you edit it.
Reading feedback uses an API key stored in your WordPress database. The key is created automatically when you connect. A PushFeedback account is required.

* Terms of service: https://pushfeedback.com/terms
* Privacy policy: https://pushfeedback.com/privacy

By default the widget uses your theme's font and makes no other third-party requests.
If you disable "Use theme font" in the settings, the widget loads the Inter font from Google Fonts (fonts.googleapis.com) in the visitor's browser. See the Google privacy policy at https://policies.google.com/privacy.
If you enable spam protection in your PushFeedback project settings, the widget loads Google reCAPTCHA from google.com on your pages, subject to the same Google policies.

The bundled widget library is the `pushfeedback` npm package (https://www.npmjs.com/package/pushfeedback), MIT licensed, which is GPL-compatible.

== Installation ==

1. Install and activate the plugin.
2. Go to the PushFeedback menu in wp-admin.
3. Click **Connect to PushFeedback** and create a free account (or log in). You are sent back to WordPress automatically.
4. Done. The feedback button is live on your site. Already have a project? Use "I already have a project ID" instead.

== Frequently Asked Questions ==

= How do I add a feedback button to WordPress? =

Install the plugin, connect a free PushFeedback account, and the floating feedback button is live on every page. No code needed. To place the button inside a page or post instead, use the `[pushfeedback]` shortcode.

= How do I add a "Was this page helpful?" button? =

That is the widget's default rating question. Leave the rating on thumbs up / down and visitors see "Was this page helpful?" when they open the feedback widget. You can reword it, or switch to a five-star rating, in the settings.

= Can visitors send screenshots with their feedback? =

Yes. Visitors click "Add a screenshot", capture the page, and can highlight and annotate the image before sending. Screenshots arrive attached to the feedback entry, so you see exactly what they saw. You can turn screenshots off in the settings.

= Is there a free plan? =

Yes. It never expires, needs no credit card, and includes your first 25 feedback entries. After that, feedback keeps arriving and is saved, and you upgrade to unlock it. Paid plans raise or remove the limit, and the Unlimited plan adds AI reports. See https://pushfeedback.com/pricing.

= What happens when I pass 25 entries? =

Nothing breaks, and nothing is deleted. Visitors keep sending feedback and never notice a limit, and entries keep being saved to your account and delivered to your integrations. Your first 25 stay visible, and newer ones are locked until you upgrade.
The moment you upgrade, every locked entry unlocks, because it was stored all along.

= How do I remove the "Powered by PushFeedback" branding? =

It is already hidden. The widget shows no "Powered by PushFeedback" link unless you turn it on in the PushFeedback settings in wp-admin (Branding), so a fresh install has no branding on the front end.

= Where is my feedback stored? =

Feedback entries are stored in your PushFeedback account on app.pushfeedback.com, not in your WordPress database.
You can read the latest entries on the Feedback page in wp-admin.
Disconnecting or uninstalling the plugin never deletes your feedback.

= Is it GDPR-friendly? =

The widget collects only what the visitor submits: their message, an optional rating, an optional email address, and an optional screenshot.
You can enable a privacy-policy consent checkbox in the widget settings.
By default no third-party fonts or scripts load in the visitor's browser. See the PushFeedback privacy policy at https://pushfeedback.com/privacy.

= Does it slow my site down? =

No. The widget loads as a single deferred script (a web component) served from your own site, and only renders a small button until a visitor opens it.

= Can I use it without a PushFeedback account? =

No. The plugin is a connector for the PushFeedback service, and entries are stored in your PushFeedback account. The free plan takes about two minutes to set up.

= Can I put the feedback button inside a page instead of floating? =

Yes. Use the `[pushfeedback]` shortcode anywhere. Add `embedded="true"` to render the form inline, and override any widget option per instance, for example `[pushfeedback button_text="Report a docs issue" modal_position="sidebar-right"]`.

= Can I change the widget's colors and text? =

Yes. Colors, button style and position, rating mode, and every text string in the widget (titles, placeholders, messages) are editable in the settings, with a live preview that updates as you type.

== Screenshots ==

1. The feedback button on a page: visitors rate the page, comment, and attach a screenshot without leaving it.
2. The modal can also open as a full-height sidebar: pick the position that fits your theme.
3. Visitors highlight and annotate their screenshot, so you see exactly what they saw.
4. Feedback in wp-admin: ratings, messages, screenshots, and the page each entry came from.
5. Settings with a live preview: colors, position, and text update as you type.

== Changelog ==

= 1.0.0 =
* Initial release: one-click connect, paste-a-project-ID fallback, floating feedback button, full widget customization (essentials plus advanced appearance, layout and text options), URL include/exclude rules, the `[pushfeedback]` shortcode with embedded mode, a wp-admin feedback list, and admin-bar-aware widget positioning for logged-in viewers.
