AFI
kk Star Ratings
kk Star Ratings adds an anonymous star-rating widget to WordPress posts and pages, with schema markup for rich snippets. Advanced Form Integration captures star ratings and routes the data to any of 200+ destinations.
What you’ll need
- The kk Star Ratings plugin installed and activated.
- Ratings enabled for at least one post type in the plugin’s settings.
- The Advanced Form Integration plugin installed and activated.
When the trigger fires
AFI registers a single Post Rated trigger for kk Star Ratings. It fires when a visitor casts a star rating on a post or page.
Data captured
| Field | Field key | Format |
|---|---|---|
| Post ID | post_id |
Numeric ID |
| Post Title | post_title |
Text |
| Post URL | post_url |
Absolute URL |
| Rating | rating |
Numeric, 0 to 5 |
| Visitor Fingerprint | fingerprint |
Text, an anonymous visitor hash |
Create the integration
- Go to WP Admin → AFI → Add New.
- Enter an Integration Title, e.g.
kk Star Ratings: Post Rated → Google Sheets. - In Trigger → Form/Data Provider, select kk Star Ratings.
- In Form/Task Name, choose Post Rated.
- In Action → Platform, pick the destination and complete the field mapping.
- Optional: configure Conditional Logic so only matching events are sent.
- Click Save Integration.
How AFI listens for ratings
AFI hooks kksr_rate from src/core/actions/save.php, which the plugin’s own source documents as a long-standing, intentionally preserved back-compat extension point. It passes the post ID, the rating already normalised to a 0 to 5 scale, and an anonymous browser fingerprint. The sibling kksr_vote hook carries the same event with a legacy argument order; AFI uses kksr_rate for its stabler signature. Registration is guarded by defined( 'KK_STAR_RATINGS' ).
Ratings are anonymous by design
There is no login, name, or email involved anywhere in this plugin. Visitor Fingerprint is a browser fingerprint used for duplicate suppression, not an identity. Use this trigger for content analytics and alerting, not for lead capture.
Troubleshooting
Re-ratings fire again
kk Star Ratings allows a visitor to change their vote depending on your unique-vote setting. Each accepted vote raises the hook. Deduplicate on Post ID plus Visitor Fingerprint if you only want the first.
Rating arrives as a decimal
The value passed is the normalised score out of 5 and can carry a fraction. Round it at the destination if you need a whole number.