feedback-kit

Feedback Kit

Visual feedback for your WordPress site

Feedback Kit lets clients leave pinned comments directly on your pages—like Figma, but for websites. They click anywhere, leave a note, and you get notified. No more confusing emails about "the button in the middle of the page."

Getting Started

What you need:

  • WordPress 5.8 or newer
  • PHP 7.4 or newer
  • Admin access to your site

To install:

  1. Download the plugin from your CraftedPath account
  2. In WordPress, go to Plugins → Add New → Upload Plugin
  3. Upload the zip file and click Activate
  4. Go to CraftedPath → License and enter your license key

That's it. The plugin creates its database tables automatically.

Leaving Feedback

To start a feedback session:

  1. Go to any page on your site (while logged in as admin)
  2. Click Feedback in the black admin bar
  3. The page loads in feedback mode with a toolbar at the top

To leave a pin:

  1. Click anywhere on the page
  2. A numbered pin appears where you clicked
  3. Type your comment and click Submit
  4. The pin is saved with your note

What you can do with pins:

  • Move them by dragging
  • Add replies to start a thread
  • Mark them resolved when the issue is fixed
  • Reopen if needed

Comments and Mentions

Each pin can have multiple comments in a thread—like a conversation about that specific spot on the page.

To reply to a pin:

  1. Click on any pin to open it
  2. Type in the reply box
  3. Click Submit

To mention someone: Type @ and start typing a name. A dropdown shows matching users and guests. Click to select them—they'll get an email notification.

Mentions work for:

  • WordPress users on your site
  • Guests who have left feedback before (matched by email)

Rounds

Rounds let you organize feedback into versions. Think of them as "Round 1 of revisions" and "Round 2 of revisions."

Why use rounds:

  • Keep old feedback for reference without it cluttering the current view
  • Track progress across revision cycles
  • Pin numbers reset each round (Pin #1, #2, etc.)

To create a new round:

  1. In feedback mode, find the round dropdown in the toolbar
  2. Click New Round
  3. All new pins go into this round

To switch between rounds: Use the dropdown to view feedback from previous rounds. Old rounds are read-only—you can see them but not add new pins.

Access Modes

Control who can leave feedback on each page.

Three access modes:

Mode Who can access
Public Anyone with the link can leave feedback
Logged In Only WordPress users who are logged in
Secret Link Only people with a special link (for clients without WP accounts)

To set access mode:

  1. Go to CraftedPath → Feedback Kit
  2. Find the page in your list
  3. Click the access mode dropdown and choose

Secret links: When you set a page to "Secret Link" mode, copy the link from the settings. Send this link to your client—they can leave feedback without logging in. Anyone without the link can't access feedback mode.

Default access mode: Go to CraftedPath → Feedback Kit → Settings to set what access mode new pages get by default.

Desktop and Mobile

You can leave feedback for both desktop and mobile layouts.

To switch viewports:

  1. In feedback mode, find the viewport toggle in the toolbar
  2. Click Desktop or Mobile
  3. The iframe resizes to that viewport width

Pins are saved per viewport—desktop pins show on desktop view, mobile pins show on mobile view. This way you can give feedback on mobile-specific issues without cluttering the desktop view.

Email Notifications

When someone leaves feedback or replies, relevant people get notified by email.

Who gets notified:

  • Thread participants (anyone who commented on that pin)
  • Mentioned users (anyone @mentioned)
  • Admins (configurable)

Notification types:

  • New pin created
  • Reply to a thread you're in
  • Someone mentioned you
  • Your feedback was resolved

Digest emails: If you get multiple notifications within 30 minutes, they're bundled into one digest email instead of flooding your inbox.

To disable notifications: Every email has an unsubscribe link at the bottom. Click it to stop receiving feedback emails for that address. You can re-subscribe anytime.

Global settings: Admins can enable/disable notifications site-wide in CraftedPath → Feedback Kit → Settings.

Managing Feedback

The admin dashboard at CraftedPath → Feedback Kit shows:

  • All pages with feedback
  • Pin counts (total and open)
  • Last activity date
  • Access mode for each page

To archive a page: If a project is done, you can archive its feedback page. Archived pages don't show in the default list, but their data is preserved.

To delete feedback permanently: You can delete a page and all its pins/comments if you no longer need them.

Troubleshooting

"I don't see the Feedback button in the admin bar"

  • Make sure you're logged in as an admin
  • Check that the plugin is activated
  • The button only appears on the frontend, not in wp-admin

"Pins aren't showing up"

  • Verify you're in the correct round
  • Check the viewport (desktop vs mobile)
  • Clear any page caching

"Guests can't leave feedback"

  • Check the page's access mode—if set to "Logged In", guests are blocked
  • For clients without WP accounts, use "Public" or "Secret Link" mode

"Not getting email notifications"

  • Check spam folders
  • Verify your WordPress can send emails (test with a plugin like WP Mail SMTP)
  • Check if you accidentally unsubscribed
  • Make sure notifications are enabled in settings

"The page looks different in feedback mode"

  • Feedback mode loads your page in an iframe
  • Some themes/plugins behave differently in iframes
  • Admin bar and other admin-only elements are hidden

Technical Details

Cookie: cpfk_guest_* — stores guest info for return visits

Database tables:

  • wp_cpfk_pages — pages with feedback enabled
  • wp_cpfk_rounds — feedback rounds/versions
  • wp_cpfk_pins — the pins on each page
  • wp_cpfk_comments — comments on each pin
  • wp_cpfk_notifications — pending email notifications
  • wp_cpfk_email_preferences — unsubscribe preferences

Email schedule: Notifications are processed every 30 minutes via WordPress cron. Multiple notifications to the same person are bundled into a digest.

Privacy: Guest names and emails are stored to enable mentions and notifications. No other personal data is collected.

To uninstall completely:

  1. Deactivate and delete the plugin
  2. Tables stay in your database by default
  3. To remove everything: drop all wp_cpfk_* tables and delete the cpfk_db_version and cpfk_settings options