=== OuterWhisper ===
Contributors: outerwhisper, freemius
Tags: feedback, user feedback, customer feedback, surveys, user experience
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Collect and analyze user feedback directly in WordPress with a visual form builder, flexible display options, smart triggers, and targeting rules.

== Description ==

OuterWhisper is a lightweight and flexible feedback plugin for collecting user feedback directly on your WordPress website.

Create feedback forms with a visual form builder and display them exactly where and when they are relevant. Embed forms directly in your content, open them as overlays or slide-ins, or use a floating feedback button.

OuterWhisper provides flexible display rules, smart triggers, frequency controls, email notifications, and configurable confirmation behavior.

The free version lets you create unlimited feedback forms and manage submitted feedback directly in the WordPress admin area. View individual responses, organize feedback by status, and use basic filters. OuterWhisper Pro adds advanced analytics, detailed technical context, additional field types, and import/export tools.

Submitted feedback data is stored locally in your WordPress database.

The frontend is built with native JavaScript (ES Modules), CSS, and semantic HTML without requiring a frontend framework such as React or Vue.

== Highlights & Features ==

* **Visual Form Builder:** Create and edit feedback forms with a live preview, multi-step support, undo/redo, and reusable templates.
* **Unlimited Feedback Forms:** Create and publish as many feedback forms as you need with OuterWhisper Free or Pro.
* **Flexible Form Fields:** Build forms using headlines, descriptions, text areas, buttons, and rating fields.
* **Flexible Display Options:** Display feedback forms before or after content, via shortcode, as overlays, slide-ins, or floating feedback buttons.
* **Smart Triggers:** Open feedback forms based on clicks, time delays, scroll depth, or exit intent.
* **Display Conditions:** Control where and to whom feedback forms are shown using page and device rules.
* **AND/OR Rules:** Combine multiple display conditions to create more specific targeting rules.
* **Frequency Control:** Control how often feedback forms are displayed and prevent unwanted repeated prompts.
* **Email Notifications:** Receive automatic email notifications when new feedback is submitted.
* **Confirmation Actions:** Show a thank-you message, redirect users, or hide a form after submission.
* **Custom Styling:** Customize the appearance of feedback forms and add your own CSS.
* **Lightweight Frontend:** Frontend functionality is built with native JavaScript (ES Modules), CSS, and semantic HTML.
* **Accessibility:** Forms use semantic markup and support keyboard interaction and relevant ARIA attributes.
* **Local Feedback Storage:** Submitted feedback data is stored in your WordPress database.
* **Feedback Management:** View individual submissions, manage unread/read/archived statuses, delete entries, and filter feedback in the WordPress admin area.

== Display Options ==

OuterWhisper supports several ways to integrate feedback forms into your website:

* Before or after post content
* Shortcode: `[outerwhisper_form id="123"]`
* Overlay / modal
* Slide-in
* Floating feedback button

Triggers can be used to control when supported display types appear, including:

* Click on a CSS selector
* Time delay
* Scroll depth
* Exit intent

Frequency controls help prevent forms from being shown too often to the same visitor.

== Form Fields ==

The free version of OuterWhisper includes the following form fields:

* Headline
* Description
* Text area
* Button
* Rating

OuterWhisper Pro adds additional feedback and rating fields:

* Thumbs up / down
* Smiley / emoji rating
* Net Promoter Score (NPS 0–10)

== Targeting ==

OuterWhisper provides display conditions that allow you to control where and to whom your feedback forms are shown.

The free version includes basic targeting based on:

* Page type
* Device type

Multiple conditions can be combined using AND/OR logic.

OuterWhisper Pro adds advanced targeting based on:

* URL rules
* Cookie values

These rules can be combined with OuterWhisper's triggers and frequency controls to create targeted feedback experiences.

== Email Notifications ==

OuterWhisper can automatically send an email notification when new feedback is submitted.

Notification emails can include dynamic information such as:

* Submitted feedback values
* Date
* Time
* Page URL

Available placeholders include:

`{feedback_values}`
`{date}`
`{time}`
`{page_url}`

Email notifications complement the feedback inbox available in the WordPress admin area in both Free and Pro.

== Confirmation Actions ==

Configure what happens after a visitor submits a feedback form.

OuterWhisper can:

* Display a custom thank-you message
* Redirect the visitor
* Hide the form after submission
* Prevent unwanted repeated displays

== Feedback Data & Context ==

OuterWhisper lets you choose whether to collect additional technical and page-related information alongside feedback submissions. Tracking can be disabled entirely, and individual data points can be enabled or disabled where available.

OuterWhisper Free provides these optional tracking data points:

* Page URL (the URL where the form was submitted)
* Page title (the page's HTML title)
* Referrer URL (the previous page, when available)
* User agent (browser and system information)

OuterWhisper Pro unlocks these additional optional tracking data points:

* Browser language
* Screen resolution
* Viewport size (browser window dimensions)
* Local timezone
* Network connection type (when available)
* Device type (desktop, tablet, or mobile)
* Anonymized session ID
* Time spent on page (in seconds)
* Colour scheme (system light/dark preference)

Collecting tracking data and viewing technical details are separate features: OuterWhisper Free includes feedback responses and basic submission management in WordPress, while OuterWhisper Pro adds the detailed technical context view for individual submissions.

The anonymized session ID is randomly generated in the visitor's browser session and does not contain a WordPress user ID.

== OuterWhisper Pro ==

OuterWhisper Pro extends the free plugin with more advanced ways to collect and analyze feedback. Core feedback management, including viewing individual answers and managing submission statuses, is already available in Free.

Pro features include:

* Thumbs up / down fields
* Smiley / emoji rating fields
* Net Promoter Score (NPS) fields
* Nine additional optional technical tracking data points
* Detailed technical context view for individual submissions
* Advanced feedback analytics and dashboard insights
* Advanced feedback filtering and analysis tools
* Additional targeting rules based on URLs and cookie values
* Import and export of feedback data as CSV or JSON
* Import and export of form configurations

The free version lets you create and display unlimited feedback forms, view and manage responses in WordPress, and receive email notifications.

== Feedback Management ==

OuterWhisper Free and Pro both provide feedback management directly in the WordPress admin area.

View submitted answers for individual feedback entries, change their status, and delete entries. OuterWhisper Pro adds a detailed technical context view for individual submissions and advanced analysis capabilities.

Feedback entries can be organized using the following statuses:

* Unread
* Read
* Archived

Basic feedback filters help you find submissions by form, display type, status, or date. OuterWhisper Pro extends these capabilities with advanced filtering and analysis.

== Import & Export ==

Import and export functionality is available with OuterWhisper Pro.

Feedback data can be exported as:

* CSV
* JSON

Form configurations can also be exported and imported as JSON. This can be useful when moving forms between WordPress installations or from a staging environment to a live website.

OuterWhisper Pro also supports importing previously exported feedback data.

== Privacy & Feedback Data ==

Submitted feedback data is stored locally in your WordPress database.

OuterWhisper does not require an external feedback service to store or analyze submitted feedback. Feedback content is not sent to an external feedback cloud for storage or analysis.

Depending on your configuration and license, separate services used for licensing, updates, or plugin-related functionality may process their own technical data independently of submitted feedback content.

== Installation ==

1. Install OuterWhisper from the WordPress plugin directory or upload the plugin ZIP file.
2. Activate OuterWhisper from the Plugins screen in WordPress.
3. Open **OuterWhisper** in the WordPress admin area.
4. Create your first feedback form using the visual form builder.
5. Configure where and when the form should be displayed.
6. Publish the form.

You can also embed a form manually using the shortcode `[outerwhisper_form id="123"]`, replacing `123` with the ID of your form.

== Frequently Asked Questions ==

= How many feedback forms can I create? =

Both OuterWhisper Free and OuterWhisper Pro allow you to create and use unlimited feedback forms.

= Where is submitted feedback stored? =

Submitted feedback data is stored locally in your WordPress database.

Both Free and Pro store submitted feedback locally and let you view and manage responses in the WordPress admin area. Email notifications are also available. OuterWhisper Pro adds advanced analysis and technical context.

= How do I manually embed a form into a page? =

Use the shortcode `[outerwhisper_form id="123"]`, replacing `123` with the ID of the form you want to display.

= Which form fields are included in the free version? =

The free version includes headline, description, text area, button, and rating fields.

OuterWhisper Pro additionally provides thumbs up/down, smiley/emoji ratings, and NPS (Net Promoter Score 0–10).

= Which display types are available in the free version? =

The free version supports in-content forms, shortcodes, overlays, slide-ins, and floating feedback buttons.

These display types are not restricted to OuterWhisper Pro.

= Can I control when a feedback form appears? =

Yes. OuterWhisper supports triggers such as clicks, time delays, scroll depth, and exit intent.

Frequency controls can also be used to limit repeated displays.

OuterWhisper Pro additionally provides URL- and cookie-based targeting rules.

= Can I combine multiple display conditions? =

Yes. Display conditions can be combined using AND/OR logic to create more specific targeting rules.

= Can I manage submitted feedback in WordPress? =

Yes. OuterWhisper Free includes a feedback list, individual submitted answers, unread/read/archived statuses, deletion, and basic filtering.

OuterWhisper Pro adds detailed technical context, advanced analysis, and extended filtering capabilities.

= Can feedback data be exported? =

Yes, with OuterWhisper Pro.

Feedback can be exported as CSV or JSON. OuterWhisper Pro also supports importing feedback data and importing or exporting form configurations.

= Does OuterWhisper collect additional context about feedback submissions? =

Tracking is optional and can be turned off. You can choose which available data points to collect.

OuterWhisper Free can collect the page URL, page title, referrer URL, and user agent. OuterWhisper Pro additionally offers browser language, screen resolution, viewport size, local timezone, network connection type, device type, anonymized session ID, time spent on page, and colour scheme.

The Pro edition also unlocks a detailed technical context view for individual submissions. Availability of individual data points depends on browser support and the tracking options enabled.

= What is the anonymized session ID? =

OuterWhisper can generate a random session identifier in the visitor's browser session.

The identifier can be used to technically associate feedback submissions from the same browser session. It does not contain a WordPress user ID.

= Does OuterWhisper require an external feedback service? =

No. Submitted feedback data is stored locally in your WordPress database and does not require an external feedback service for storage or analysis.

= Does OuterWhisper require a JavaScript framework in the frontend? =

No. OuterWhisper's frontend functionality is built with native JavaScript (ES Modules) and CSS without requiring a frontend framework such as React or Vue.

== Screenshots ==

1. OuterWhisper dashboard with feedback statistics and recent activity.
2. Visual form builder with live preview and field selection.
3. Display and targeting rules for controlling where feedback forms appear.
4. Feedback inbox and individual submitted answers, available in OuterWhisper Free and Pro.
5. Optional tracking settings with Free and Pro data points.

== Links ==

* Plugin website: https://outerwhisper.de/
* Features: https://outerwhisper.de/funktionen/
* Documentation: https://outerwhisper.de/docs/
* Support forum: https://outerwhisper.de/support-forum/

== Translations ==

OuterWhisper includes translations for:

* English
* German

== Changelog ==

= 1.0.2 =

* Feature: add new form field gap setting
* Feature: add new box shadow setting
* Fix: also validate not required form fields
* Improvement: add custom validation error messages

= 1.0.1 =

* Initial public release of OuterWhisper.