Customer Feedback to Notion

Overview

Customer Feedback to Notion is a powerful WordPress plugin that automatically collects customer feedback after order completion and syncs it seamlessly to your Notion database.

Installation

1. Download the Plugin

   Download the plugin zip file from the link above.

2. Upload the Plugin

   Upload the plugin folder to /wp-content/plugins/ directory, or install directly through WordPress admin (Plugins → Add New → Upload Plugin).

3. Activate

   Navigate to Plugins → Installed Plugins and activate "Customer Feedback to Notion".

4. Access Settings

   Find the plugin under Customer Feedback in your WordPress admin menu.

Notion Database Setup

Step 1: Create Notion Integration

1. Visit Notion Integrations

   Go to https://www.notion.so/my-integrations

2. Create New Integration

   Click "New integration" and give it a name (e.g., "WooCommerce Feedback").

3. Copy API Token

   Copy the "Internal Integration Token" - you'll need this for the plugin settings.

Step 2: Create Database

Create a new database in Notion with these exact properties:

Step 3: Share Database with Integration

1. Open Database

   Open your newly created database in Notion.

2. Click "..." Menu

   Click the three dots menu in the top right corner.

3. Add Connection

   Select Connections → Add your integration and choose the integration you created.

Step 4: Get Database ID

Copy the database ID from the URL. It's the part after your workspace name and before the "?":

Plugin Configuration

Notion Integration Settings

Navigate to Customer Feedback → Settings

• Notion API Token: Paste your integration token
• Notion Database ID: Paste your database ID

Email Customization

Customize the feedback request email sent to customers:

Available Placeholders:

• {customer_name} - Customer's first name
• {order_number} - WooCommerce order number
• {feedback_url} - Unique feedback form link
• {expiry_days} - Number of days until link expires

Success Message

Customize the message shown after successful feedback submission. Supports HTML tags.

Google Review Integration (Optional)

• Enable Redirect: Turn on to redirect customers to Google reviews
• Google Review URL: Your Google Business review link
• Redirect Delay: Seconds to wait before redirect (0-30)

Key Features

Automatic Feedback Collection

When a WooCommerce order status changes to "Completed", the plugin automatically sends a feedback request email to the customer with a unique, secure link.

Star Rating System

Customers rate three aspects on a 5-star scale:

• Buying Process Experience
• Website/Page Quality
• Website Speed

Security Features

• Cryptographically secure tokens using random_bytes()
• Time-limited feedback links (configurable 1-30 days)
• Rate limiting to prevent spam (3 submissions per 5 minutes per IP)
• CSRF protection with nonces
• UNIQUE constraint prevents duplicate feedback per order
• SQL injection protection with prepared statements

Dashboard & Analytics

• View total feedback count and statistics
• See average ratings across all categories
• Monitor Notion sync status
• View recent feedback submissions
• Analyze rating breakdowns by category
• Track monthly feedback trends

Duplicate Prevention

Multiple layers of protection ensure only one feedback per order:

• Email won't be sent if feedback already exists
• Form submission checks database for duplicates
• UNIQUE database constraint on order_id
• Token is deleted after successful submission
• Notion sync checks prevent duplicate syncs

Troubleshooting

Emails Not Sending

• Check your WordPress mail configuration (consider using an SMTP plugin)
• Verify the order status changed to "Completed"
• Check if feedback already exists for the order
• Look for errors in WordPress debug.log (if WP_DEBUG is enabled)

Notion Sync Errors

• Verify your API token is correct
• Ensure database ID is accurate
• Check that database properties match exactly (case-sensitive)
• Confirm integration is connected to the database
• Use "Test Connection" button to validate setup
• Check error message on Dashboard for specific details

Common Error Messages

Star Ratings Not Working

Clear your browser cache - the JavaScript file version was updated. The plugin auto-increments version numbers to force cache refresh.

Database Issues

If you experience database errors, try:

Support

Need Help?

We're here to help you get the most out of Customer Feedback to Notion!

Before Contacting Support

Please have the following information ready:

• WordPress version
• WooCommerce version
• Plugin version (currently 1.0.3)
• Error messages (if any)
• Screenshots of the issue
• Steps to reproduce the problem

Technical Specifications