=== FeedValue - User Feedback Widgets ===
Contributors: sarverenterprises
Tags: feedback, widgets, user feedback, customer feedback, surveys
Requires at least: 6.0
Tested up to: 6.4
Requires PHP: 8.0
Stable tag: 0.0.12
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Collect authentic user feedback with customizable widgets. Integrates seamlessly with your FeedValue dashboard.

== Description ==

**FeedValue** makes it easy to collect user feedback on your WordPress site without editing theme files or writing code. Simply install the plugin, connect your FeedValue account, and start gathering valuable insights from your visitors.

= Key Features =

* **Zero-Code Integration** - No theme modifications required
* **Flexible Display Options** - Use shortcodes, Gutenberg blocks, or global site-wide widgets
* **Advanced Targeting** - Show widgets on specific pages, post types, categories, or site-wide
* **Performance Optimized** - Conditional script loading and intelligent caching
* **GDPR Compliant** - No local user data storage
* **WordPress Best Practices** - Follows WordPress coding standards and security guidelines

= Perfect For =

* SaaS companies collecting product feedback
* E-commerce stores gathering customer insights
* Bloggers engaging with their audience
* Agencies managing multiple client sites
* Anyone who wants to understand their users better

= How It Works =

1. **Sign Up** - Create a free account at [feedvalue.com](https://feedvalue.com)
2. **Get Your API Key** - Create an app in your FeedValue dashboard
3. **Configure Plugin** - Enter your API key in WordPress settings
4. **Add Widgets** - Use shortcodes, blocks, or global positions
5. **Collect Feedback** - View submissions in your FeedValue dashboard

= Display Methods =

**Shortcodes**
`[feedvalue widget_id="your_widget_id"]`

**Gutenberg Blocks**
Add the "FeedValue Widget" block in the block editor and select your widget.

**Global Site-Wide**
Configure widgets to appear automatically in header, footer, before content, or after content.

= Targeting Rules =

Control exactly where widgets appear:

* **Inclusion Rules** - Show on specific pages, post types, categories, tags
* **Exclusion Rules** - Hide on specific pages (exclusion overrides inclusion)
* **URL Pattern Matching** - Use regex for advanced targeting

= Privacy & GDPR =

FeedValue is built with privacy in mind:

* No user feedback data stored locally
* API key encrypted before storage
* Complete uninstall cleanup
* Session cookies only (no tracking cookies)
* GDPR-compliant privacy policy integration

= Support =

* **Documentation**: [feedvalue.com/docs](https://feedvalue.com/docs)
* **Email**: support@feedvalue.com
* **GitHub**: [github.com/sarverenterprises/feedvalue-wordpress-plugin](https://github.com/sarverenterprises/feedvalue-wordpress-plugin)

== Installation ==

= From WordPress Plugin Directory =

1. In WordPress admin, go to **Plugins → Add New**
2. Search for "FeedValue"
3. Click **Install Now** and then **Activate**

= Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins → Add New → Upload Plugin**
3. Choose the ZIP file and click **Install Now**
4. Click **Activate Plugin**

= Configuration =

1. Go to **Settings → FeedValue**
2. Enter your FeedValue API key (get it from [feedvalue.com/app](https://feedvalue.com/app))
3. Click **Save Settings**
4. Your widgets will be loaded automatically

== Frequently Asked Questions ==

= Do I need a FeedValue account? =

Yes. You need to sign up at [feedvalue.com](https://feedvalue.com) to get an API key. Free plans are available.

= Can I use multiple FeedValue apps on one WordPress site? =

Not currently. The plugin supports one FeedValue app per WordPress site. Create multiple widgets within a single app instead.

= Will widgets slow down my site? =

No. The plugin uses conditional script loading (only loads where needed) and caches widget configuration for 5 minutes. Widget.js is <50KB gzipped and loaded asynchronously.

= Does this work with page builders? =

Yes! Use the shortcode in any page builder that supports shortcodes:
* Elementor - Use the "Shortcode" widget
* Divi - Use the "Code" module
* Beaver Builder - Use the "HTML" module
* WPBakery - Use the "Raw HTML" element

For block-based page builders, use the FeedValue Gutenberg block.

= Is this GDPR compliant? =

Yes. The plugin does not store any user feedback data locally. All submissions go directly to FeedValue's secure servers. Review FeedValue's privacy policy at [feedvalue.com/privacy](https://feedvalue.com/privacy).

= How do I uninstall the plugin? =

Deactivate and delete the plugin from **Plugins** page. All plugin data (API key, settings, cached data) will be automatically removed from your database.

= Can I customize widget styling? =

Widget styling is managed in your FeedValue dashboard, not in WordPress. This ensures consistent branding across all your sites and allows real-time updates without code changes.

= Does this work with WordPress Multisite? =

Not currently. Multisite support is planned for a future release.

== Screenshots ==

1. FeedValue settings page - Configure your API key and manage widgets
2. Widget list - Enable/disable widgets and copy shortcodes
3. Gutenberg block - Add widgets in the block editor
4. Widget preview - See how widgets appear on your site
5. Targeting rules - Control where widgets display

== Changelog ==

= 1.0.0 =
* Initial release
* Global API key management
* Auto-fetch widget list with 5-minute cache
* Shortcode support
* Gutenberg block support
* Global site-wide widget insertion
* Flexible targeting rules (inclusion + exclusion)
* Manual cache refresh
* WordPress debug.log integration
* GDPR compliance with uninstall cleanup

== Upgrade Notice ==

= 1.0.0 =
Initial release. Install and start collecting user feedback today!

== Privacy Policy ==

This plugin connects to the FeedValue API (https://api.feedvalue.com) to fetch widget configuration and submit user feedback.

**Data Sent to FeedValue:**
* API key (for authentication)
* WordPress site URL (as referrer header)
* User feedback submissions (text, email if provided, page URL, user agent)

**Data Stored Locally:**
* FeedValue API key (encrypted)
* Widget settings (enable/disable state, targeting rules)
* Widget configuration (cached for 5 minutes)

**No User Data Stored Locally:**
* User feedback submissions are NOT stored in WordPress
* No user IP addresses stored
* No tracking cookies (session cookies only)

Review FeedValue's privacy policy at https://feedvalue.com/privacy for details on data handling.

== Legal Disclaimer & GDPR ==

**Important: Your Responsibilities**

By using this plugin, you acknowledge and agree to the following:

**GDPR & Privacy Compliance:**

1. **Privacy Policy Update Required** - You MUST update your site's privacy policy to disclose the use of FeedValue and describe what data is collected through feedback widgets.

2. **Consent Requirements** - If you collect personal data through feedback widgets (such as email addresses), you must ensure appropriate consent mechanisms are in place in accordance with GDPR, CCPA, and other applicable privacy regulations.

3. **Data Controller Status** - You are the data controller for any personal data collected through FeedValue widgets. FeedValue acts as a data processor on your behalf.

4. **Data Processing Agreement** - For GDPR compliance, you may need to execute a Data Processing Agreement (DPA) with FeedValue. Contact support@feedvalue.com to request a DPA.

5. **Data Subject Requests** - You are responsible for handling data subject access requests (DSARs) that may include data collected through FeedValue widgets.

**Data Collected Through Widgets:**

* Feedback text submitted by users
* Email addresses (if collected)
* Page URL where feedback was submitted
* Browser and device information
* IP address (for rate limiting and fraud prevention)
* Timestamp of submission

**No Warranty:**

This plugin is provided "as is" without warranty of any kind, express or implied. The plugin authors and FeedValue are not liable for any damages arising from the use of this plugin.

**Compliance:**

This plugin is designed to help you comply with privacy regulations but does not guarantee compliance. It is your responsibility to ensure your use of the plugin meets all applicable legal requirements in your jurisdiction.

**For More Information:**

* FeedValue Privacy Policy: https://feedvalue.com/privacy
* FeedValue Terms of Service: https://feedvalue.com/terms
* Data Processing Agreement: Contact support@feedvalue.com
* GDPR Documentation: https://feedvalue.com/docs/gdpr
