Transform customer feedback into Google Business Profile reviews with intelligent routing
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.
🚀 Get Started • 📖 Documentation • 🎨 Customization • 🛠️ Support
- ✨ Key Features
- 🔄 How It Works
- 🚀 Installation
- 📖 Usage
- 🎨 Customization Options
- 🔒 Security & Privacy
- 👩💻 Developer Features
- ❓ FAQ
- 📸 Screenshots
- 📝 Changelog
- 🛠️ Support
|
|
graph LR
A["Customer sees rating interface"] --> B{"Rating given"}
B -->|"1-3 stars"| C["Private feedback form"]
B -->|"4-5 stars"| D["Success message"]
C --> E["Email notification to admin"]
D --> F["Redirect to Google Business Profile"]
D --> G["QR Code display - Kiosk mode"]
| Step | Action | Result |
|---|---|---|
| 1️⃣ | Customer sees rating interface | Large, accessible 5-star selector displayed |
| 2️⃣ | Low ratings (1-3 stars) | Shows feedback form with optional contact info |
| 3️⃣ | High ratings (4-5 stars) | Shows success message + redirect/QR code |
| 4️⃣ | Admin notification | Email sent with feedback details (low ratings) |
| 5️⃣ | Optional logging | Submissions stored in WordPress database |
🏪 Retail Stores • 🍽️ Restaurants • 🏥 Healthcare • 🏨 Hospitality • 🔧 Service Businesses
🔽 Basic & Advanced Examples
[quick_feedback][quick_feedback brand_color="#ff6b35" redirect_target="_blank" show_contact="false"][quick_feedback kiosk_mode="true" qr_code_image="https://example.com/qr-code.png"]🔽 All Available Attributes
| Attribute | Type | Description | Example |
|---|---|---|---|
gbp_url |
URL | Override Google Business Profile URL | gbp_url="https://g.page/..." |
redirect_target |
String | "_self" or "_blank" for redirect |
redirect_target="_blank" |
brand_color |
Color | Custom brand color (hex code) | brand_color="#ff6b35" |
show_contact |
Boolean | Show/hide contact fields | show_contact="false" |
headline |
String | Custom main headline | headline="Rate Your Experience" |
subhead |
String | Custom subheading text | subhead="Help us improve" |
success_message_low |
String | Success message for low ratings | success_message_low="Thanks for feedback" |
success_message_high |
String | Success message for high ratings | success_message_high="Please review us!" |
kiosk_mode |
Boolean | Enable kiosk mode (QR code) | kiosk_mode="true" |
qr_code_image |
URL | Custom QR code image for kiosk | qr_code_image="https://..." |
🎯 Drag & Drop Widget with Visual Controls
|
|
🛡️ Enterprise-Grade Security with Privacy-First Design
|
|
🎯 Make it uniquely yours with extensive customization options
|
|
|
🔧 Built for developers with extensible architecture
🔽 Action Hooks
// Before email is sent
do_action('qfr_before_email_send', $email_data, $submission);
// After submission is processed
do_action('qfr_submission_processed', $submission_id, $rating, $feedback);🔽 Filter Hooks
// Customize email subject
apply_filters('qfr_email_subject', $subject, $rating, $feedback);
// Modify redirect URL
apply_filters('qfr_redirect_url', $url, $rating);
// Customize widget configuration
apply_filters('qfr_widget_config', $config, $widget_id);// Listen for rating changes
document.addEventListener("qfr:ratingChanged", function (e) {
console.log("Rating:", e.detail.rating);
});
// Low rating submitted
document.addEventListener("qfr:lowRatingSubmitted", function (e) {
// Custom analytics tracking
});
// High rating submitted
document.addEventListener("qfr:highRatingSubmitted", function (e) {
// Custom success actions
});# Custom integrations
POST /wp-json/qfr/v1/submit-feedback🔽 Click to expand installation steps
-
📁 Upload Plugin
Upload files to: /wp-content/plugins/quick-feedback-reviews/ -
⚡ Activate Plugin
- Go to WordPress Admin → Plugins
- Find "ReviewFlow.me - Quick Feedback Reviews"
- Click "Activate"
-
⚙️ Configure Settings
- Navigate to Settings → Quick Feedback
- Add your Google Business Profile URL
- Customize colors, text, and behavior
-
🎯 Add to Pages
- Use shortcode:
[quick_feedback] - Or add Elementor widget to your pages
- Use shortcode:
🔽 Step-by-step guide
- 🌐 Go to your Google Business Profile dashboard
- 📝 Click on "Get more reviews"
- 📋 Copy the provided URL (starts with
https://search.google.com/orhttps://g.page/) - 📌 Paste it in the plugin settings
✅ Supported URL formats:
https://search.google.com/local/writereview?placeid=...https://g.page/your-business/reviewhttps://maps.app.goo.gl/...
💡 Quick answers to common questions
🔗 How do I get my Google Business Profile review URL?
- Go to your Google Business Profile dashboard
- Look for the "Get more reviews" option
- Copy the provided direct URL
- Paste it in the plugin settings
✅ Accepted URL formats:
https://search.google.com/local/writereview?placeid=...https://g.page/your-business/reviewhttps://maps.app.goo.gl/...
🎨 Can I customize the appearance to match my theme?
Absolutely! The plugin is designed to:
- 🎨 Inherit your theme's typography and colors by default
- ⚙️ Allow customization through settings page
- 🎯 Provide Elementor widget controls for visual editing
- 🔧 Support CSS variables for advanced customization
♿ Is the plugin accessible for users with disabilities?
Yes! Built with WCAG 2.1 AA compliance:
- ⌨️ Keyboard Navigation - Full keyboard support for star ratings
- 📢 Screen Reader Support - Proper announcements and labels
- 🏷️ ARIA Labels - Proper roles and descriptions
- 🎯 Focus Management - Clear focus indicators
- 🌓 High Contrast - Support for high contrast modes
🔒 Does the plugin store customer data?
Privacy-first approach:
- 📧 By default: Only sends email notifications
- 💾 Optional: Enable submission logging in settings
- 🇪🇺 GDPR-compliant with proper consent management
- 🍪 No cookies required for basic functionality
🎨 Can I use this plugin without Elementor?
Yes! The plugin works perfectly with:
- 📝 Shortcode -
[quick_feedback]works anywhere - 📦 Block Editor - Compatible with Gutenberg
- 🎨 Elementor - Enhanced visual controls (optional)
🛡️ What spam protection is included?
Multiple layers of protection:
- 🍯 Honeypot Fields - Invisible to humans, catch bots
- ⏱️ Time-trap Protection - Prevents too-fast submissions
- 🔐 Nonce Verification - WordPress security tokens
- 🧹 Input Validation - All data sanitized and validated
🌍 Can I translate the plugin?
Fully internationalized:
- 🌐 All text strings use WordPress translation functions
- 📝 Ready for translation with standard WordPress tools
- 🗂️
.potfile included in/languages/directory
🔄 The 4-5 star redirect isn't working. What should I check?
Troubleshooting steps:
- ✅ Valid Google Business Profile URL in Settings → Quick Feedback
- 🔗 URL should start with approved domains (see above)
- 🔍 Check browser developer console (F12) for JavaScript errors
- 🐛 Enable Debug Mode in plugin settings
- 💻 Local testing (.local domain) should still work - check console
🍪 I'm getting a "Cookie check failed" error when submitting feedback
Usually a nonce/security token issue:
- 🔄 Refresh the page and try again
- 🧹 Clear your browser cache
- 🗂️ Clear caching plugin cache if using one
- 🛡️ Check for interfering security plugins
- 🐛 Enable Debug Mode for detailed error information
🔧 How do I troubleshoot issues?
Debug process:
- ⚙️ Go to Settings → Quick Feedback and enable "Debug Mode"
- 🔄 Try to reproduce the issue
- 📋 Check WordPress debug log (
/wp-content/debug.log) - 🔍 Look for entries starting with "[QFR]"
- 🌐 Check browser developer console (F12) for JavaScript errors
🎯 See the plugin in action
| Screenshot | Description |
|---|---|
| 🌟 Rating Interface | Clean, accessible 5-star rating selector with smooth animations |
| 📝 Feedback Form | Low rating feedback form with optional contact fields |
| ⚙️ Settings Page | Comprehensive plugin configuration with live preview |
| 🎨 Elementor Widget | Visual controls in Elementor editor with real-time preview |
| 📧 Email Notification | Rich HTML email template for low rating feedback |
| ✅ Success Messages | Customizable success messages for different rating levels |
| 🖥️ Kiosk Mode | Tablet-friendly interface with QR code display |
| ♿ Accessibility | WCAG contrast checker and keyboard navigation demo |
📷 Screenshots coming soon! Plugin is actively maintained and updated.
🚀 Latest updates and improvements
🔽 View all changes
- 🖥️ Perfect for tablets and shared devices in physical locations
- 📱 Shows QR code instead of redirecting for 4-5 star ratings
- ⚙️ Global kiosk mode setting with QR code image upload
- 🎨 Per-widget kiosk mode override in Elementor
- 📝 Shortcode support:
[quick_feedback kiosk_mode="true"] - 🔒 Enhanced security for shared device environments
- 🏪 Ideal for restaurants, shops, waiting areas, service counters
- 📲 Customers scan QR code with personal phone to leave reviews
- 📱 Responsive QR code display with clear instructions
🔽 View all changes
- 🎯 Live WCAG contrast checking in Elementor editor
- 🚦 Visual indicators: AAA (green), AA (yellow), FAIL (red)
- 📊 Coverage of all 13 color controls across sections
- 🔄 Real-time updates when navigating Elementor sections
- 🐛 Debug console respects plugin's debug mode setting
- 🏆 Enhanced WCAG 2.1 AA compliance features
- 🧮 Improved color contrast calculations with gamma correction
- 💡 Tooltips with detailed WCAG guidelines and ratios
🔽 View all changes
- ✅ "Send Test Email" button in Settings → Quick Feedback
- ⚡ Real-time feedback on email success/failure
- 🔍 Detailed error reporting for troubleshooting
- 📊 Improved email delivery diagnostics
🔽 View all changes
- 📝 Typography Section:
- Headline Typography
- Subhead Typography
- Button Typography
- NEW: Form Label Typography
- NEW: Form Input Typography
- 🎨 Style Section:
- Brand Color
- Active Star Color
- Inactive Star Color
- Button Border Radius
- Spacing
- 🌈 NEW: Form Colors Section:
- Label Color
- Input Text Color
- Input Background Color
- Input Border Color
- Input Focus Border Color
- Placeholder Color
🔽 View all features
- ⭐ 5-star rating system with smart routing
- 📝 Shortcode and Elementor widget support
- 📧 Email notifications for low ratings
- 🔗 Google Business Profile integration
- ♿ Accessibility features (WCAG 2.1 AA)
- 🛡️ Anti-spam protection
- 🔒 Privacy-focused design
- 🎨 Comprehensive customization options
- 👨💻 Developer hooks and filters
- 🌍 Internationalization support
💬 Get help when you need it
|
|
🛡️ Transparent data handling practices
This plugin may collect and process the following data only when feedback is submitted:
| Data Type | Purpose | Required |
|---|---|---|
| ⭐ Rating value (1-5 stars) | Feedback processing | ✅ Yes |
| 💬 Feedback message | Low rating responses | ❌ Optional |
| 👤 Contact info (name, email, phone) | Follow-up communication | ❌ Optional |
| 🌐 Page URL | Context tracking | ✅ Yes |
| ⏰ Timestamp | Submission tracking | ✅ Yes |
| 🔍 User agent & IP | Spam prevention | ✅ Yes |
- 📧 Contact information is only used for follow-up when consent is given
- 🗂️ Data logging can be completely disabled in plugin settings
- 🚫 No tracking of users who don't submit feedback
- 🍪 No cookies required for basic functionality
💝 Built with love for the WordPress community
Al Romano - Lead Developer
- 🎯 WordPress Coding Standards - Following best practices
- 🔒 Security First - Comprehensive security measures
- ♿ Accessibility - WCAG 2.1 AA compliance
- 🚀 Performance - Optimized for speed
- 🌍 Internationalization - Translation-ready
- 🌟 WordPress community for feedback and support
- 🎨 Elementor team for excellent widget API
- ♿ Web accessibility advocates for guidance
- 🧪 Beta testers and early adopters
⭐ If you find this plugin helpful, please consider leaving a review!