Interactive Ratings for Contact Form 7

FAQ

Is this an official Contact Form 7 plugin?

No. It is an independent add-on. It is not affiliated with or endorsed by Rock Lobster Inc., the makers of Contact Form 7.

How do I add a rating to a form?

Edit the form, click star rating in the form-tag generator, set the options, and insert the tag. Then put the matching mail-tag, such as [your-rating], in the Mail template.

How do I make the rating required?

Check Required field in the generator, or add an asterisk to the tag name: [hbwa_starrating* your-rating]. An empty required rating uses Contact Form 7’s standard required-field message.

Can I use more than one rating on the same form?

Yes. Give each field its own name, for example [hbwa_starrating quality-rating] and [hbwa_starrating support-rating], and add both mail-tags to the Mail template.

Which themes and sizes are available?

Themes: gold, ember, ocean, forest, and mono. Sizes: sm, md, lg, and xl. Example: [hbwa_starrating your-rating theme:ocean size:lg].

Do half-stars work?

Yes. Turn on Allow half-star ratings, or add half to the tag. Visitors can then choose steps of 0.5, and a half-filled star is shown.

What do the text labels say?

On a 5-star scale they are Poor, Fair, Good, Very good, and Excellent. The words appear beside the stars while the pointer is over them or while the rating is focused. A half-star uses the nearest whole-number label. Scales other than 5 use “1 star”, “2 stars”, and so on.

Can I change the label words?

Not from the tag generator. Use nolabel (or Hide live label text) if you do not want the words shown. The email still includes the default label for that score.

Can I pre-select a rating?

Add default: to the tag, for example [hbwa_starrating your-rating default:4]. The value must fit the scale and the half-star setting.

How many stars can I show?

From 1 to 10, with max:. The default is 5.

How does the rating appear in email?

The mail-tag is replaced with stars, the score, and the label. A whole score looks like ★★★★☆ (4/5) — Very good. A half score looks like ★★★½☆ (3.5/5) — Very good.

Is the rating stored anywhere besides the email?

This plugin does not create its own ratings table. Contact Form 7 sends the formatted text in the email. The value posted with the form is the number (for example 4 or 3.5). Plugins that save Contact Form 7 submissions will store that number.

Can visitors use a keyboard?

Yes. Focus the rating and use the arrow keys to move by one step (or half a step when half-stars are on). Home selects the lowest score and End selects the highest.

What happens if Contact Form 7 is deactivated?

The plugin shows an admin notice and does not register its form-tag until Contact Form 7 is active again. It cannot be activated on its own.