{"id":31780906,"url":"https://github.com/virtuallycreative/qf-gbp-wp","last_synced_at":"2025-10-10T08:29:12.647Z","repository":{"id":316279006,"uuid":"1046390773","full_name":"VirtuallyCreative/qf-gbp-wp","owner":"VirtuallyCreative","description":"A WordPress plugin that provides a shortcode and an Elementor widget for rapid in-person customer feedback.","archived":false,"fork":false,"pushed_at":"2025-09-23T17:51:19.000Z","size":249,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-23T18:29:44.354Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VirtuallyCreative.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE.md","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-28T16:05:42.000Z","updated_at":"2025-09-23T17:51:22.000Z","dependencies_parsed_at":"2025-09-23T18:29:46.158Z","dependency_job_id":null,"html_url":"https://github.com/VirtuallyCreative/qf-gbp-wp","commit_stats":null,"previous_names":["virtuallycreative/qf-gbp-wp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/VirtuallyCreative/qf-gbp-wp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VirtuallyCreative%2Fqf-gbp-wp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VirtuallyCreative%2Fqf-gbp-wp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VirtuallyCreative%2Fqf-gbp-wp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VirtuallyCreative%2Fqf-gbp-wp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VirtuallyCreative","download_url":"https://codeload.github.com/VirtuallyCreative/qf-gbp-wp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VirtuallyCreative%2Fqf-gbp-wp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279003300,"owners_count":26083555,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-10T08:29:10.119Z","updated_at":"2025-10-10T08:29:12.639Z","avatar_url":"https://github.com/VirtuallyCreative.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🌟 ReviewFlow.me - Quick Feedback Reviews\n\n**Transform customer feedback into Google Business Profile reviews with intelligent routing**\n\n[![WordPress Plugin Version](https://img.shields.io/badge/WordPress-6.0%2B-blue.svg)](https://wordpress.org/)\n[![PHP Version](https://img.shields.io/badge/PHP-7.4%2B-purple.svg)](https://php.net/)\n[![License](https://img.shields.io/badge/License-GPL%20v2%2B-green.svg)](https://www.gnu.org/licenses/gpl-2.0.html)\n[![Elementor Compatible](https://img.shields.io/badge/Elementor-Compatible-pink.svg)](https://elementor.com/)\n[![WCAG 2.1 AA](https://img.shields.io/badge/Accessibility-WCAG%202.1%20AA-brightgreen.svg)](https://www.w3.org/WAI/WCAG21/quickref/)\n\n---\n\n_A powerful WordPress plugin that provides a shortcode and Elementor widget for rapid in-person customer feedback with smart routing to Google Business Profile reviews. Features kiosk mode for tablets and real-time WCAG accessibility checking._\n\n[🚀 **Get Started**](#installation) • [📖 **Documentation**](#usage) • [🎨 **Customization**](#customization-options) • [🛠️ **Support**](#support)\n\n\u003c/div\u003e\n\n---\n\n## 📋 Table of Contents\n\n-   [✨ Key Features](#-key-features)\n-   [🔄 How It Works](#-how-it-works)\n-   [🚀 Installation](#-installation)\n-   [📖 Usage](#-usage)\n    -   [Shortcode Usage](#shortcode-usage)\n    -   [Elementor Integration](#elementor-integration)\n-   [🎨 Customization Options](#-customization-options)\n-   [🔒 Security \u0026 Privacy](#-security--privacy)\n-   [👩‍💻 Developer Features](#-developer-features)\n-   [❓ FAQ](#-frequently-asked-questions)\n-   [📸 Screenshots](#-screenshots)\n-   [📝 Changelog](#-changelog)\n-   [🛠️ Support](#-support)\n\n---\n\n## ✨ Key Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🎯 **Smart Rating System**\n\n-   ⭐ 5-star rating interface with intelligent routing\n-   🔄 Dual workflow for optimal customer experience\n-   📱 Mobile-responsive design\n\n### 🛡️ **Security \u0026 Privacy**\n\n-   🍯 Honeypot anti-spam protection\n-   ⏱️ Time-trap bot prevention\n-   🔐 Nonce verification \u0026 input sanitization\n-   🇪🇺 GDPR-compliant consent management\n\n### ♿ **Accessibility First**\n\n-   🏆 WCAG 2.1 AA compliant\n-   ⌨️ Full keyboard navigation support\n-   📢 Screen reader announcements\n-   🎨 High contrast mode support\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🔌 **Multiple Integration Options**\n\n-   📝 Shortcode: `[quick_feedback]`\n-   🎨 Elementor Widget with visual controls\n-   📦 Block Editor compatible\n-   🖥️ **NEW:** Kiosk mode for tablets\n\n### 🎨 **Highly Customizable**\n\n-   🎨 CSS variables \u0026 color schemes\n-   📝 Typography customization\n-   💬 Custom text \u0026 messages\n-   📐 Adjustable spacing controls\n\n### 👨‍💻 **Developer Friendly**\n\n-   🪝 Action \u0026 filter hooks\n-   🌐 REST API endpoint\n-   📊 JavaScript events\n-   🔧 Extensible architecture\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🔄 **Intelligent Workflow**\n\n```mermaid\ngraph LR\n    A[\"Customer sees rating interface\"] --\u003e B{\"Rating given\"}\n    B --\u003e|\"1-3 stars\"| C[\"Private feedback form\"]\n    B --\u003e|\"4-5 stars\"| D[\"Success message\"]\n    C --\u003e E[\"Email notification to admin\"]\n    D --\u003e F[\"Redirect to Google Business Profile\"]\n    D --\u003e G[\"QR Code display - Kiosk mode\"]\n```\n\n## 🔄 How It Works\n\n\u003cdiv align=\"center\"\u003e\n\n### 📱 **Step-by-Step Process**\n\n\u003c/div\u003e\n\n| Step   | Action                         | Result                                         |\n| ------ | ------------------------------ | ---------------------------------------------- |\n| **1️⃣** | Customer sees rating interface | Large, accessible 5-star selector displayed    |\n| **2️⃣** | **Low ratings (1-3 stars)**    | Shows feedback form with optional contact info |\n| **3️⃣** | **High ratings (4-5 stars)**   | Shows success message + redirect/QR code       |\n| **4️⃣** | Admin notification             | Email sent with feedback details (low ratings) |\n| **5️⃣** | Optional logging               | Submissions stored in WordPress database       |\n\n\u003cdiv align=\"center\"\u003e\n\n### 🎯 **Perfect For**\n\n🏪 **Retail Stores** • 🍽️ **Restaurants** • 🏥 **Healthcare** • 🏨 **Hospitality** • 🔧 **Service Businesses**\n\n\u003c/div\u003e\n\n## 📖 Usage\n\n### 📝 **Shortcode Usage**\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 Basic \u0026 Advanced Examples\u003c/strong\u003e\u003c/summary\u003e\n\n#### 🚀 **Basic Usage**\n\n```php\n[quick_feedback]\n```\n\n#### 🎨 **With Custom Styling**\n\n```php\n[quick_feedback brand_color=\"#ff6b35\" redirect_target=\"_blank\" show_contact=\"false\"]\n```\n\n#### 🖥️ **Kiosk Mode (Perfect for Tablets)**\n\n```php\n[quick_feedback kiosk_mode=\"true\" qr_code_image=\"https://example.com/qr-code.png\"]\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 All Available Attributes\u003c/strong\u003e\u003c/summary\u003e\n\n| Attribute              | Type    | Description                          | Example                                     |\n| ---------------------- | ------- | ------------------------------------ | ------------------------------------------- |\n| `gbp_url`              | URL     | Override Google Business Profile URL | `gbp_url=\"https://g.page/...\"`              |\n| `redirect_target`      | String  | `\"_self\"` or `\"_blank\"` for redirect | `redirect_target=\"_blank\"`                  |\n| `brand_color`          | Color   | Custom brand color (hex code)        | `brand_color=\"#ff6b35\"`                     |\n| `show_contact`         | Boolean | Show/hide contact fields             | `show_contact=\"false\"`                      |\n| `headline`             | String  | Custom main headline                 | `headline=\"Rate Your Experience\"`           |\n| `subhead`              | String  | Custom subheading text               | `subhead=\"Help us improve\"`                 |\n| `success_message_low`  | String  | Success message for low ratings      | `success_message_low=\"Thanks for feedback\"` |\n| `success_message_high` | String  | Success message for high ratings     | `success_message_high=\"Please review us!\"`  |\n| `kiosk_mode`           | Boolean | Enable kiosk mode (QR code)          | `kiosk_mode=\"true\"`                         |\n| `qr_code_image`        | URL     | Custom QR code image for kiosk       | `qr_code_image=\"https://...\"`               |\n\n\u003c/details\u003e\n\n### 🎨 **Elementor Integration**\n\n\u003cdiv align=\"center\"\u003e\n\n**🎯 Drag \u0026 Drop Widget with Visual Controls**\n\n\u003c/div\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### 📝 **Content Settings**\n\n-   📰 Headlines \u0026 messages\n-   🔗 URLs \u0026 redirects\n-   🖥️ Kiosk mode options\n\n#### 🎨 **Style Controls**\n\n-   🎨 Colors \u0026 branding\n-   📐 Spacing \u0026 layout\n-   📝 Typography settings\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### ⚙️ **Behavior Options**\n\n-   📞 Contact field settings\n-   🔄 Redirect preferences\n-   🛡️ Privacy controls\n\n#### 👁️ **Real-time Preview**\n\n-   ✅ Live editor preview\n-   🎯 WCAG contrast checking\n-   📱 Responsive design\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## 🔒 Security \u0026 Privacy\n\n\u003cdiv align=\"center\"\u003e\n\n**🛡️ Enterprise-Grade Security with Privacy-First Design**\n\n\u003c/div\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🔐 **Security Features**\n\n-   ✅ **Nonce Verification** - All submissions verified\n-   🍯 **Honeypot Protection** - Invisible spam traps\n-   ⏱️ **Time-trap Prevention** - Blocks bot submissions\n-   🧹 **Input Sanitization** - All data cleaned \u0026 validated\n-   👮 **Capability Checks** - Admin function protection\n-   🌐 **URL Validation** - Google domain allowlist\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🇪🇺 **GDPR Compliance**\n\n-   🍪 **No Cookies Required** - Basic functionality cookie-free\n-   📊 **Optional Logging** - Can be completely disabled\n-   📋 **Clear Privacy Notices** - Transparent data usage\n-   ☑️ **Consent Checkboxes** - User permission controls\n-   🗂️ **Data Retention** - Admin-controlled storage\n-   🔒 **Privacy-First** - Minimal data collection\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n### 🏆 **Compliance Standards**\n\n[![GDPR](https://img.shields.io/badge/GDPR-Compliant-green.svg)](https://gdpr.eu/)\n[![WCAG 2.1 AA](https://img.shields.io/badge/WCAG%202.1-AA%20Compliant-brightgreen.svg)](https://www.w3.org/WAI/WCAG21/quickref/)\n[![WordPress Security](https://img.shields.io/badge/WordPress-Security%20Best%20Practices-blue.svg)](https://wordpress.org/about/security/)\n\n\u003c/div\u003e\n\n## 🎨 Customization Options\n\n\u003cdiv align=\"center\"\u003e\n\n**🎯 Make it uniquely yours with extensive customization options**\n\n\u003c/div\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"33%\"\u003e\n\n### 🎨 **Visual Styling**\n\n-   🌈 **Colors** - Brand, star, button colors\n-   📝 **Typography** - Inherit theme or customize\n-   📐 **Spacing** - Adjustable spacing scale\n-   🎭 **CSS Variables** - Advanced customization\n\n\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\n\n### 💬 **Content \u0026 Text**\n\n-   📰 **Headlines** - Custom main \u0026 sub headings\n-   💬 **Messages** - Success \u0026 error messages\n-   🏷️ **Labels** - Form field labels\n-   🌍 **Translation** - Full i18n support\n\n\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\n\n### ⚙️ **Behavior Settings**\n\n-   📞 **Contact Fields** - Required/optional\n-   ☑️ **Consent Options** - GDPR compliance\n-   🔄 **Redirect Settings** - Target \u0026 timing\n-   🖥️ **Kiosk Mode** - Tablet-friendly options\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## 👩‍💻 Developer Features\n\n\u003cdiv align=\"center\"\u003e\n\n**🔧 Built for developers with extensible architecture**\n\n\u003c/div\u003e\n\n### 🪝 **WordPress Hooks**\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 Action Hooks\u003c/strong\u003e\u003c/summary\u003e\n\n```php\n// Before email is sent\ndo_action('qfr_before_email_send', $email_data, $submission);\n\n// After submission is processed\ndo_action('qfr_submission_processed', $submission_id, $rating, $feedback);\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 Filter Hooks\u003c/strong\u003e\u003c/summary\u003e\n\n```php\n// Customize email subject\napply_filters('qfr_email_subject', $subject, $rating, $feedback);\n\n// Modify redirect URL\napply_filters('qfr_redirect_url', $url, $rating);\n\n// Customize widget configuration\napply_filters('qfr_widget_config', $config, $widget_id);\n```\n\n\u003c/details\u003e\n\n### 📊 **JavaScript Events**\n\n```javascript\n// Listen for rating changes\ndocument.addEventListener(\"qfr:ratingChanged\", function (e) {\n\tconsole.log(\"Rating:\", e.detail.rating);\n});\n\n// Low rating submitted\ndocument.addEventListener(\"qfr:lowRatingSubmitted\", function (e) {\n\t// Custom analytics tracking\n});\n\n// High rating submitted\ndocument.addEventListener(\"qfr:highRatingSubmitted\", function (e) {\n\t// Custom success actions\n});\n```\n\n### 🌐 **REST API Endpoint**\n\n```bash\n# Custom integrations\nPOST /wp-json/qfr/v1/submit-feedback\n```\n\n## 🚀 Installation\n\n### 📦 **Quick Setup**\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 Click to expand installation steps\u003c/strong\u003e\u003c/summary\u003e\n\n1. **📁 Upload Plugin**\n\n    ```\n    Upload files to: /wp-content/plugins/quick-feedback-reviews/\n    ```\n\n2. **⚡ Activate Plugin**\n\n    - Go to WordPress Admin → Plugins\n    - Find \"ReviewFlow.me - Quick Feedback Reviews\"\n    - Click \"Activate\"\n\n3. **⚙️ Configure Settings**\n\n    - Navigate to **Settings → Quick Feedback**\n    - Add your Google Business Profile URL\n    - Customize colors, text, and behavior\n\n4. **🎯 Add to Pages**\n    - Use shortcode: `[quick_feedback]`\n    - Or add Elementor widget to your pages\n\n\u003c/details\u003e\n\n### 🔗 **Getting Your Google Business Profile URL**\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 Step-by-step guide\u003c/strong\u003e\u003c/summary\u003e\n\n1. 🌐 Go to your [Google Business Profile dashboard](https://business.google.com/)\n2. 📝 Click on **\"Get more reviews\"**\n3. 📋 Copy the provided URL (starts with `https://search.google.com/` or `https://g.page/`)\n4. 📌 Paste it in the plugin settings\n\n**✅ Supported URL formats:**\n\n-   `https://search.google.com/local/writereview?placeid=...`\n-   `https://g.page/your-business/review`\n-   `https://maps.app.goo.gl/...`\n\n\u003c/details\u003e\n\n## ❓ Frequently Asked Questions\n\n\u003cdiv align=\"center\"\u003e\n\n**💡 Quick answers to common questions**\n\n\u003c/div\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔗 How do I get my Google Business Profile review URL?\u003c/strong\u003e\u003c/summary\u003e\n\n1. Go to your [Google Business Profile dashboard](https://business.google.com/)\n2. Look for the **\"Get more reviews\"** option\n3. Copy the provided direct URL\n4. Paste it in the plugin settings\n\n**✅ Accepted URL formats:**\n\n-   `https://search.google.com/local/writereview?placeid=...`\n-   `https://g.page/your-business/review`\n-   `https://maps.app.goo.gl/...`\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🎨 Can I customize the appearance to match my theme?\u003c/strong\u003e\u003c/summary\u003e\n\n**Absolutely!** The plugin is designed to:\n\n-   🎨 Inherit your theme's typography and colors by default\n-   ⚙️ Allow customization through settings page\n-   🎯 Provide Elementor widget controls for visual editing\n-   🔧 Support CSS variables for advanced customization\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e♿ Is the plugin accessible for users with disabilities?\u003c/strong\u003e\u003c/summary\u003e\n\n**Yes!** Built with WCAG 2.1 AA compliance:\n\n-   ⌨️ **Keyboard Navigation** - Full keyboard support for star ratings\n-   📢 **Screen Reader Support** - Proper announcements and labels\n-   🏷️ **ARIA Labels** - Proper roles and descriptions\n-   🎯 **Focus Management** - Clear focus indicators\n-   🌓 **High Contrast** - Support for high contrast modes\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔒 Does the plugin store customer data?\u003c/strong\u003e\u003c/summary\u003e\n\n**Privacy-first approach:**\n\n-   📧 By default: Only sends email notifications\n-   💾 Optional: Enable submission logging in settings\n-   🇪🇺 GDPR-compliant with proper consent management\n-   🍪 No cookies required for basic functionality\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🎨 Can I use this plugin without Elementor?\u003c/strong\u003e\u003c/summary\u003e\n\n**Yes!** The plugin works perfectly with:\n\n-   📝 **Shortcode** - `[quick_feedback]` works anywhere\n-   📦 **Block Editor** - Compatible with Gutenberg\n-   🎨 **Elementor** - Enhanced visual controls (optional)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🛡️ What spam protection is included?\u003c/strong\u003e\u003c/summary\u003e\n\n**Multiple layers of protection:**\n\n-   🍯 **Honeypot Fields** - Invisible to humans, catch bots\n-   ⏱️ **Time-trap Protection** - Prevents too-fast submissions\n-   🔐 **Nonce Verification** - WordPress security tokens\n-   🧹 **Input Validation** - All data sanitized and validated\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🌍 Can I translate the plugin?\u003c/strong\u003e\u003c/summary\u003e\n\n**Fully internationalized:**\n\n-   🌐 All text strings use WordPress translation functions\n-   📝 Ready for translation with standard WordPress tools\n-   🗂️ `.pot` file included in `/languages/` directory\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔄 The 4-5 star redirect isn't working. What should I check?\u003c/strong\u003e\u003c/summary\u003e\n\n**Troubleshooting steps:**\n\n1. ✅ Valid Google Business Profile URL in Settings → Quick Feedback\n2. 🔗 URL should start with approved domains (see above)\n3. 🔍 Check browser developer console (F12) for JavaScript errors\n4. 🐛 Enable Debug Mode in plugin settings\n5. 💻 Local testing (.local domain) should still work - check console\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🍪 I'm getting a \"Cookie check failed\" error when submitting feedback\u003c/strong\u003e\u003c/summary\u003e\n\n**Usually a nonce/security token issue:**\n\n1. 🔄 Refresh the page and try again\n2. 🧹 Clear your browser cache\n3. 🗂️ Clear caching plugin cache if using one\n4. 🛡️ Check for interfering security plugins\n5. 🐛 Enable Debug Mode for detailed error information\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔧 How do I troubleshoot issues?\u003c/strong\u003e\u003c/summary\u003e\n\n**Debug process:**\n\n1. ⚙️ Go to **Settings → Quick Feedback** and enable **\"Debug Mode\"**\n2. 🔄 Try to reproduce the issue\n3. 📋 Check WordPress debug log (`/wp-content/debug.log`)\n4. 🔍 Look for entries starting with **\"[QFR]\"**\n5. 🌐 Check browser developer console (F12) for JavaScript errors\n\n\u003c/details\u003e\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n**🎯 See the plugin in action**\n\n\u003c/div\u003e\n\n| Screenshot                | Description                                                     |\n| ------------------------- | --------------------------------------------------------------- |\n| 🌟 **Rating Interface**   | Clean, accessible 5-star rating selector with smooth animations |\n| 📝 **Feedback Form**      | Low rating feedback form with optional contact fields           |\n| ⚙️ **Settings Page**      | Comprehensive plugin configuration with live preview            |\n| 🎨 **Elementor Widget**   | Visual controls in Elementor editor with real-time preview      |\n| 📧 **Email Notification** | Rich HTML email template for low rating feedback                |\n| ✅ **Success Messages**   | Customizable success messages for different rating levels       |\n| 🖥️ **Kiosk Mode**         | Tablet-friendly interface with QR code display                  |\n| ♿ **Accessibility**      | WCAG contrast checker and keyboard navigation demo              |\n\n\u003cdiv align=\"center\"\u003e\n\n_📷 Screenshots coming soon! Plugin is actively maintained and updated._\n\n\u003c/div\u003e\n\n## 📝 Changelog\n\n\u003cdiv align=\"center\"\u003e\n\n**🚀 Latest updates and improvements**\n\n\u003c/div\u003e\n\n### 🆕 **Version 1.0.5** - _Kiosk Mode Release_\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 View all changes\u003c/strong\u003e\u003c/summary\u003e\n\n#### ✨ **NEW: Kiosk Mode**\n\n-   🖥️ Perfect for tablets and shared devices in physical locations\n-   📱 Shows QR code instead of redirecting for 4-5 star ratings\n-   ⚙️ Global kiosk mode setting with QR code image upload\n-   🎨 Per-widget kiosk mode override in Elementor\n-   📝 Shortcode support: `[quick_feedback kiosk_mode=\"true\"]`\n-   🔒 Enhanced security for shared device environments\n-   🏪 Ideal for restaurants, shops, waiting areas, service counters\n-   📲 Customers scan QR code with personal phone to leave reviews\n-   📱 Responsive QR code display with clear instructions\n\n\u003c/details\u003e\n\n---\n\n### 🎨 **Version 1.0.4** - _Accessibility Enhancement_\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 View all changes\u003c/strong\u003e\u003c/summary\u003e\n\n#### ♿ **NEW: Real-time Accessibility Checker**\n\n-   🎯 Live WCAG contrast checking in Elementor editor\n-   🚦 Visual indicators: AAA (green), AA (yellow), FAIL (red)\n-   📊 Coverage of all 13 color controls across sections\n-   🔄 Real-time updates when navigating Elementor sections\n-   🐛 Debug console respects plugin's debug mode setting\n-   🏆 Enhanced WCAG 2.1 AA compliance features\n-   🧮 Improved color contrast calculations with gamma correction\n-   💡 Tooltips with detailed WCAG guidelines and ratios\n\n\u003c/details\u003e\n\n---\n\n### 📧 **Version 1.0.2** - _Email Testing_\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 View all changes\u003c/strong\u003e\u003c/summary\u003e\n\n#### 🧪 **Email Configuration Testing**\n\n-   ✅ \"Send Test Email\" button in Settings → Quick Feedback\n-   ⚡ Real-time feedback on email success/failure\n-   🔍 Detailed error reporting for troubleshooting\n-   📊 Improved email delivery diagnostics\n\n\u003c/details\u003e\n\n---\n\n### 🎨 **Version 1.0.1** - _Elementor Enhancements_\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 View all changes\u003c/strong\u003e\u003c/summary\u003e\n\n#### 🆕 **New Elementor Controls**\n\n-   📝 **Typography Section:**\n    -   Headline Typography\n    -   Subhead Typography\n    -   Button Typography\n    -   **NEW:** Form Label Typography\n    -   **NEW:** Form Input Typography\n-   🎨 **Style Section:**\n    -   Brand Color\n    -   Active Star Color\n    -   Inactive Star Color\n    -   Button Border Radius\n    -   Spacing\n-   🌈 **NEW: Form Colors Section:**\n    -   Label Color\n    -   Input Text Color\n    -   Input Background Color\n    -   Input Border Color\n    -   Input Focus Border Color\n    -   Placeholder Color\n\n\u003c/details\u003e\n\n---\n\n### 🎉 **Version 1.0.0** - _Initial Release_\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔽 View all features\u003c/strong\u003e\u003c/summary\u003e\n\n#### 🚀 **Core Features**\n\n-   ⭐ 5-star rating system with smart routing\n-   📝 Shortcode and Elementor widget support\n-   📧 Email notifications for low ratings\n-   🔗 Google Business Profile integration\n-   ♿ Accessibility features (WCAG 2.1 AA)\n-   🛡️ Anti-spam protection\n-   🔒 Privacy-focused design\n-   🎨 Comprehensive customization options\n-   👨‍💻 Developer hooks and filters\n-   🌍 Internationalization support\n\n\u003c/details\u003e\n\n---\n\n## 🛠️ Support\n\n\u003cdiv align=\"center\"\u003e\n\n**💬 Get help when you need it**\n\n\u003c/div\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🐛 **Bug Reports \u0026 Issues**\n\n-   🔗 [GitHub Issues](https://github.com/vip3rousmango/quick-feedback-reviews/issues)\n-   📝 Detailed bug reporting template\n-   🚀 Fast response times\n\n### 💡 **Feature Requests**\n\n-   🌟 [GitHub Discussions](https://github.com/vip3rousmango/quick-feedback-reviews/discussions)\n-   🗳️ Community voting on features\n-   🛣️ Public roadmap\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 📖 **Documentation**\n\n-   📚 Comprehensive guides\n-   🎥 Video tutorials (coming soon)\n-   💻 Code examples\n\n### 🤝 **Community**\n\n-   💬 WordPress.org support forum\n-   🐦 Follow updates on social media\n-   📧 Direct developer contact\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub Issues](https://img.shields.io/github/issues/vip3rousmango/quick-feedback-reviews.svg)](https://github.com/vip3rousmango/quick-feedback-reviews/issues)\n[![GitHub Stars](https://img.shields.io/github/stars/vip3rousmango/quick-feedback-reviews.svg)](https://github.com/vip3rousmango/quick-feedback-reviews/stargazers)\n\n\u003c/div\u003e\n\n---\n\n## 🔒 Privacy Policy\n\n\u003cdiv align=\"center\"\u003e\n\n**🛡️ Transparent data handling practices**\n\n\u003c/div\u003e\n\n### 📊 **Data Collection**\n\nThis plugin may collect and process the following data **only when feedback is submitted**:\n\n| Data Type                            | Purpose                 | Required    |\n| ------------------------------------ | ----------------------- | ----------- |\n| ⭐ Rating value (1-5 stars)          | Feedback processing     | ✅ Yes      |\n| 💬 Feedback message                  | Low rating responses    | ❌ Optional |\n| 👤 Contact info (name, email, phone) | Follow-up communication | ❌ Optional |\n| 🌐 Page URL                          | Context tracking        | ✅ Yes      |\n| ⏰ Timestamp                         | Submission tracking     | ✅ Yes      |\n| 🔍 User agent \u0026 IP                   | Spam prevention         | ✅ Yes      |\n\n### 🔐 **Data Usage**\n\n-   📧 **Contact information** is only used for follow-up when consent is given\n-   🗂️ **Data logging** can be completely disabled in plugin settings\n-   🚫 **No tracking** of users who don't submit feedback\n-   🍪 **No cookies** required for basic functionality\n\n---\n\n## 🏆 Credits\n\n\u003cdiv align=\"center\"\u003e\n\n**💝 Built with love for the WordPress community**\n\n---\n\n### 👨‍💻 **Developer**\n\n**[Al Romano](https://virtuallycreative.ca)** - _Lead Developer_\n\n[![Website](https://img.shields.io/badge/Website-virtuallycreative.ca-blue.svg)](https://virtuallycreative.ca)\n[![GitHub](https://img.shields.io/badge/GitHub-vip3rousmango-black.svg)](https://github.com/vip3rousmango)\n\n---\n\n### 🛠️ **Built With**\n\n-   🎯 **WordPress Coding Standards** - Following best practices\n-   🔒 **Security First** - Comprehensive security measures\n-   ♿ **Accessibility** - WCAG 2.1 AA compliance\n-   🚀 **Performance** - Optimized for speed\n-   🌍 **Internationalization** - Translation-ready\n\n---\n\n### 💖 **Special Thanks**\n\n-   🌟 WordPress community for feedback and support\n-   🎨 Elementor team for excellent widget API\n-   ♿ Web accessibility advocates for guidance\n-   🧪 Beta testers and early adopters\n\n---\n\n**⭐ If you find this plugin helpful, please consider leaving a review!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvirtuallycreative%2Fqf-gbp-wp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvirtuallycreative%2Fqf-gbp-wp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvirtuallycreative%2Fqf-gbp-wp/lists"}