Code

Rating Form

Rating Form

Examples Front-End Dashboard

Rating Form

Choose or create a Rating Form, choice of Stars, Hearts, Smileys, Thumbs Up & Down and many more or upload your own shapes. Lots of features and still expanding.

Reviews

Reviews

Features

  • User friendly
  • Multilingual (.pot template included) / Compatible with WPML
  • Choice of min. 1 to 10 max. shapes
  • Create multiple child rating forms of the parent through shortcode attribute custom_id
  • Every rating form has his own individual options
  • Various forms:
    • Change shape size
    • Change colors
    • Set alignment
    • Much more options!
  • Limit ratings based on time duration or no duration time (limitless), e.g. 10 votes per 1 hour (1 day, 1 week etc.) or fill in custom time duration.
  • Show rating result in search engines like Google (Rich Snippet).
  • Live rating statics (click on total ratings button).
  • Anonymize IP, set last octet of IP to zero. Example: 123.456.78 will become 123.456.0
  • Cookie / IP validation
  • Tooltips!
  • Instant AJAX rating.
  • Works on cache plugins!
  • Allow to edit previous rating!
  • Add titles (text) for each shape position
  • Choose which post types are allowed
  • Choose which user roles are allowed
  • Define which posts are allowed through Post ID(s)
  • Enable spinner update animation (loading)
  • Switch to empty shapes
  • Switch between Thumbs Up or Thumbs Down only buttons.
  • Change direction to RTL
  • Change decimal of average rounding
  • Upload your own custom shapes.
  • Enable if only registered users should rate.
  • Add shortcode inside posts/pages or in template files.
  • Add inside comments with shortcode attribute comment_id
  • Create multiple criteria ratings
  • Widget: Display Top Rating Results or use with shortcode: rating_form_top_rating_results
  • Include multiple post / pages instead of adding to all posts
  • Exclude multiple post / pages instead of adding to all posts
  • Compatible with SSL / HTTPS connection
  • Compatible with myCred
  • Export / Import rating result!
  • Block IP’s
  • Useful shortcode options you can add:
    • Hide/Show total ratings
    • Hide/Show tooltip
    • Hide/Show stats
    • Turn on/off rating result
  • See changelog for more features!

Support

If you have problems or questions, contact me and I’ll help you.

Changelog

Version 1.6.2 (16-6-2018)

  • ADDED
  • Form Settings: Hide Rating Form after vote, Show ‘thank you’ message after vote
  • FIXED
  • Return output in shortcode rating_form_user_ratings

Version 1.6.1 (15-6-2018)

  • ADDED
  • Shortcode – rating_form_user_ratings (more info)
    • Display a list of anonymous user / logged in user ratings
    • Options
      • limit = set number of votes
      • time_amount = set amount of time based on time period
      • time_period = choose from: sec, hour, day, week, month, year
      • sort = sort votes by new or old ratings, highest or lowest ratings (multiple sorting possible, choose from= old,new,high,down)
      • class = add any CSS classes
      • text = change default text output, available values = user_name , rating , post_link , post_title
      • anonymous_name = change text ‘Anonymous’ for anonymous users
      • tu_name = change text ‘Thumbs Up’
      • td_name = change text ‘Thumbs Down’
  • FIXED
  • PHP warning messages.
  • Vote restriction occurred after version 1.5.9.
  • Version 1.6 (7-6-2018)

    • ADDED
    • Shortcode attribute form (boolean) – rating_form_total
      • Display average data in stars / thumbs up down depending on given form id
    • CHANGES
    • Removed default style for shortcode rating_form_total

    Version 1.5.9 (31-5-2018)

    • ADDED
    • Settings page
      • Cookie (default) validation
      • Anonymize IP
      • Save IP (default turned off)
      • RTL for dashboard
    • Block List
      • Ban user ID or (anonymized) IP address
      • Autocomplete search
    • API
      • Create a new Rating Form or adjust existing form through PHP
      • Use filter hook rating_form_output to change an existing Rating Form
    • Shortcode attribute – count_type for rating_form
      • Change average rating output to percentage. Example: count_type=”percentage”
    • Shortcode attribute custom_id_group
      • Add group number in custom_id_group to trigger shortcodes: [rating_form_total] or [rating_form_results]
  • CHANGES
  • Shortcode attribute rates – Use variable count for changing position of ‘total votes’.
  • GDPR
    • Default validation is set to Cookies
    • Save IP address is disabled
  • Version 1.5.6 (6-2-2018)

    • ADDED
    • Results page
      • Filter by posts, comments, terms (categories) and users
      • Sort by Newest, Oldest, Highest and Lowest ratings
      • Save filters

    Version 1.5.5 (19-1-2018)

    • FIXED
    • Minor bug fixes
    • Results page – Not showing all ratings of a post id
    • Star hover bug
    • if shortcode attribute user_id used post_id will be set to 0 but post_id can be manually added
    • ADDED
    • New shortcode – rating_form_stats – display a list of voted posts
    • Redirect – Use user rating value in URL as parameter
    • Thumbs Up/Down – Remove + and – characters
    • CHANGED
    • Rating Form structure to avoid most CSS styles that are being overridden by site theme style.

    Version 1.5.4 (7-10-2017)

    • FIXED
    • Admin tools page – settings were not being saved, because of some cache plugins.
    • Mobile view – on long touch voting will be added.
    • ADDED
    • Meta (custom) fields to comments, users, terms + custom id’s to these objects.
      • Useful for filtering posts, comments, users and terms by average ratings and total results through WP_Query
      • Compatible with FacetWP

    Version 1.5.3 (19-7-2017)

    • ADDED
    • Top results widget and shortcode
      • Added value ‘none’ to post_title_length for displaying full length title of post
    • Settings
      • Deactivate on mobile
      • Deactivate on tablet
      • Rich Snippet – Switch between format microdata and JSON-LD
      • Public View – Show rating result to others that are voted by specified roles.
    • CHANGED
    • Admin style
    • Post meta keys (a post needs at least one vote)
      • rf_average = (real) average rating
      • rf_total = (real) total votes
      • rf_up = (real) up votes if using a thumps up / down form
      • rf_down = (real) down votes if using a thumps up / down form
      • To use ‘fake ratings’: enable option ‘Use fake ratings’ in settings of a Rating Form, change below keys for ‘fake ratings’.
      • rf_fake_average
      • rf_fake_total
      • rf_fake_up
      • rf_fake_down
    • Removed settings page on results page – no longer needed.
    • Moved option ‘Max rating’ to style page.

    Version 1.5.2 (19-10-2016)

    • FIXED
    • Rating results (dashboard) – Displayed only one vote instead of all votes
    • ADDED
    • Shortcode attribute taxonomy in rating_form_top_rating_results
      • Display top comments of a specific post by id
      • Filter by one or more taxonomies and/or terms within these taxomony
        • Seperate taxomony by | (vertical bar)
        • Add terms by using : (colon)
        • Add relation between terms through hyphen like -AND / -OR
          • AND: every term in the array must be available
          • OR (default behaviour): at least one of the term must be available
        • Example shortcode attribute
          • taxomony=”computer-AND:hp,lenovo|laptop”
      • Sort list by old or new ratings (date) and top or down ratings
        • Choose from: old, new, top_rating, down_rating
        • Example, sort new ratings by from low to top ratings: new,down_rating
    • Shortcode attributes in rating_form_total
      • custom_id
        • Display specific average result of custom_id.
          • Example: [rating_form_total custom_id=”laptop”]
          • custom_id=”0” displays result of [rating_form id=”1”] (without custom_id)
      • type_count
        • Display specific average result in percentage real numbers.
          • Example: [rating_form_total type_count=”percentage”]
      • id
        • Get same style and settings from a Rating Form by ID
    • CHANGED
    • Add New Form – Option spinner is enabled (default behaviour)

    Version 1.5.1 (2-4-2016)

    • FIXED
    • Rich snippet markup improvements
    • ADDED
    • Shortcode attribute rich_snippet – enable /disable through shortcode
    • Filter rating_form_site_logo – add a site image logo
      • In case you are missing a site image logo in rich snippet markup
    • Filter rating_form_itemtype – change itemtype Article of rich snippet markup

    Version 1.5 (21-3-2016)

    • Announcement
    • Offical website
    • Certificate from WPML
    • Backup database before updating
    • New way of creating and editing a Rating Form (see screenshots)
      • Default style
      • Custom CSS
      • No more individual stylesheet are being created
    • Folder ”/uploads/rating-form/css/ (contains stylesheet of created rating forms)”
      • Not automatically removed. Perhaps you want to copy CSS code to Custom CSS box.
    • Rating Forms load faster than before
    • ADDED
    • Quick add a Rating Form in comments before or after text
    • CHANGED
    • Database structure
    • Style of Tools, Settings and Add New page (see screenshots)
    • Rating Form structure, added default classes
      • Parent = .rating_form_wrap
      • Shape = .item
      • See rating-form.css for more default classes
    • Edit rating through button position

    Version 1.4.1 (8-2-2016)

    • FIXED
    • Rich Snippet markup – back to Article
    • Post meta (Thank you, Nexnivis)
    • ADDED
    • New shortcode [rating_form_results] – Display rating result for each star (example)
    • New extra options – enable through settings in “Extra’s”
      • Update [rating_form_results] after rating
      • Update [rating_form_total] after rating
      • Remove Rating Form on AMP pages (14-3-2016)
    • Top Rating Results widget – New option
      • Post title length: trim post title
    • New Show / Hide option – Show only itemtype aggregateRating
    • Filter rating_form_microdata – add new markup (e.g. Article to Product or Recipe etc.)
    • WPML – translate before_content and after_content through Rating Form ID

    Version 1.4 (30-1-2016)

    • FIXED
    • Bugs
    • Headers already sent message when exporting rating results
    • ADDED
    • WPML String translation (beta)
    • Alignment
      • Trough text-align: (left | center | right)
        .rating_form_1 {
            text-align: center;
        }
        
    • CHANGED
    • div#, example: RF6P80

    Version 1.3.9 (11-1-2016)

    • ADDED
    • Shortcode attribute txt_score – change score format (0/5) (25-1-2016)
    • Custom capability ‘rating_form_manage’ to administrator (reactivate plugin) (25-1-2016)
    • New forms – Thumbs Up & Down v2 and Plus and Min v2
    • New spinners – choose on settings page
    • New Show / Hide options
      • Hide total Up ratings
      • Hide total Down ratings
    • CHANGED
    • Rich snippet format (25-1-2016)

    Version 1.3.8 (8-1-2016)

    • ADDED
    • Shortcode attribute user_id – vote a specific user (id)
    • Display top rating results of users only – choose type “Users” in the widget
    • New extra option – Hide “Success” message

    Version 1.3.7 (4-1-2016)

    • FIXED
    • Warning messages in settings page (3-1-2016)
    • Switching type to custom – upload didn’t work (3-1-2016)
    • Strict Standards warnings (28-12-2015)
    • ADDED
    • New extra option – Don’t load Rating form stylesheet (28-12-2015)

    Version 1.3.6 (21-12-2015)

    • ADDED
    • Give a name (title) to a Rating Form on settings page
    • Use letters, dash – or underscore _ beside numbers in shortcode attribute custom_id
    • Import ratings through .csv
    • Top Rating Results widget – filter on multiple (custom) post types

    Version 1.3.5 (7-12-2015)

    • ADDED
    • Color pickers on style page
    • Improved RTL mode
    • Enable user statics (list) through settings page or still use shortcode attribute user_stats

    Version 1.3.4 (29-9-2015)

    • ADDED
    • CSS class to total votes named “votes”, so you can hide it (20-10-2015)
    • New setting – Redirect to URL after voting (2-10-2015)
    • Display Thumbs Up and Down type form in widget “Top Rating Results”
    • Widget option – view top results of “Type”
      • Choose between post / pages (default), comments and taxonomies (categories, tags etc.)
    • Post meta’s rf_real_average, rf_real_up, rf_real_down
    • Extra option to Thumbs Up and Down type form
      • Display difference of up and down votes, like: +3 – -2 = 1 points

    Version 1.3.3 (2-9-2015)

    • ADDED
    • New option – Show Rating Form only in pages
      • If post type “page” doesn’t work, you can enable this option
    • New option – Show Rating Form only in categories

    Version 1.3.2 (20-8-2015)

    • FIXED
    • Hover bug on Firefox
    • Shortcode rating_form_total results were not updating properly
    • Titles were not updating (29-8-2015)
    • CHANGED
    • Default value of attribute rates from “rate,rates” to “rating,ratings” (spelling error)
    • ADDED
    • Shortcode attribute user_stats (boolean)
      • Display a list of users that voted under rating stats
      • Added admin options on form settings
    • New option – Show Rating Form only on posts
      • If post type “post” doesn’t work, you can enable this option
    • Change image size of top results widget

    Version 1.3.1 (17-8-2015)

    • FIXED
    • Rich snippet added missing itemprops publishedDate, headline and image (required)
    • ADDED
    • Post meta on Results page (settings) or on post / page edit page
      • Change average result, total votes or up and down votes
    • Top results widget: Turn on / off post image

    Version 1.3 (22-6-2015)

    • FIXED
    • Duplicate form post type and user roles were not being duplicated
    • Delete form post type and user roles were not being deleted
    • ADDED
    • Shortcode [rating_form_total]
    • Hook (rating_form_new_rating): action being called after a vote has been added
      • Display average total ratings of multiple rating forms
      • Useful for multiple criteria forms
    • Information page of available shortcodes with examples to website
    • Default value Rating Form ID to 1
      • Use shortcode [rating_form] without id attribute if by default using id=”1”

    Version 1.2.9 (10-6-2015)

    • FIXED
    • bugs
    • ADDED
    • Option for singular term separate the singular term with a plural term or use one term
      • Example: [rating_form id=”1” rates=”vote,votes”]
    • New data field and shortcode attribute term_id
      • Rate category, tag or taxonomy (through custom_id with term_id)
    • Class rating_stats_active If Rating Form Stats is shown
      • Easily change style between when stats are active / inactive
    • Time Option to widget Show results of last 30 hours / weeks / days / months
    • Compatibility to myCred (15-6-2015)

    Version 1.2.6 (26-5-2015)

    • FIXED
      • Average rating was not displaying correct in Top Ratings widget
      • Smiley form was not displaying correct
    • ADDED
    • Block IP page
      • Add IP to block list or block IP directly from results page
      • Add a reason to a blocked IP (text field)
      • Edit blocked IP
    • Extra option Live Top Ratings
      • After rating, update rating result in widget

    Version 1.2.5 (12-5-2015)

    • FIXED
    • Admin url of Titles page for Multi sites
    • ADDED
    • Two options Exclude a Rating Form from Home page or RSS (Feed)

    Version 1.2.4 (27-4-2015)

    • FIXED
    • Multiple criteria inside comments.
    • If jQuery is in footer, Rating Forms were not displaying. (17-4 Thank you, galeleo)

    Version 1.2.3 (4-4-2015)

    • FIXED
    • Admin url for multi-site (Thank you, emmdub)
    • Short code attributes: tooltip, title (Thank you, emmdub)
    • ADDED
    • Tools option Display Rating Form after a paragraph

    Version 1.2.2 (24-3-2015)

    • ADDED
    • Exclude multiple pages / posts by ID
    • Shortcode attribute before_content and after_content
      • Add content (html) before or after a rating form
    • New/Missing translation .pot updated

    Version 1.2.1 (17-3-2015)

    • ADDED
    • Export rating results
    • Admin Tabs
    • New/Missing translation .pot updated
    • CHANGED
    • Quick Add Input to textarea on page Tools

    Version 1.2 (13-3-2015)

    • ADDED
    • Translation to default Titles
    • Setting option Post Ids
      • Define which posts are allowed per rating form
    • CHANGED
    • Shortcode attribute: comment_id
      • Manually add comment ID

    Version 1.1.9 (11-3-2015)

    • ADDED
    • Settings option Type Change quickly similar form type e.g. from ‘star’ to ‘heart’
    • Missing translation .pot updated
    • FIXED
    • Some bugs.

    Version 1.1.8 (9-3-2015)

    • ADDED
    • Translation template .pot file included
    • Shortcode attribute: custom_id
      • Create multiple child rating forms of the parent by assigning unique numbers

    Version 1.1.7 (1-3-2015)

    • ADDED
    • Option to remove text “Loading…” on Ajax Load
    • CHANGED
    • From “import css” to css in HEAD tag
      • Plugin version to stylesheet
    • Edit rating option to two different options with and without button
      • Show/Hide edit rating message

    Version 1.1.6 (27-2-2015)

    • REMOVED
    • Shortcode attribute: round, empty
      • Added as option in settings page (quick enable)
    • ADDED
    • Page Tools
      • Add quickly a Rating Form in before, after or both content
    • New form: Circle
    • ADDED options
      • Limit = Set rating limit for each User or IP
      • Time = Set time duration for limit in seconds
      • Extras = choose between Up or Down for standalone buttons
      • Edit last rated rating
    • Excerpt (content) (Turn on/off) in widget: Display Top Rating Results
    • New Shortcode “rating_form_top_rating_results”
      • Same functionality as widget through attributes)

    Version 1.1 (20-2-2015)

    • ADDED
    • Opacity: 1; to class .tooltip Fix Boostrap 3 style override
    • Option Ajax Load Useful for caching
      • Tested and works on cache plugins.
    • REMOVED
    • Shortcode attribute: logged, rich_snippet, spinner, rtl
      • Added as option in settings page (quick enable)
      • Spinner set as default
    • WP Compatible version 3.1, 3.2 – jQuery >= 1.7 required

    Version 1.0.5 (18-2-2015)

    • ADDED
    • Shortcode attribute: RTL
    • CHANGED
    • Structure to avoid same style elements
      • .rating_stats .header to .rf_stats_header
      • .rating_stats .close to rf_stats_close

    Version 1.0.3 (17-2-2015)

    • ADDED
    • Widget: Display Top Rating Results
    • Shortcode attribute: spinner
    • General plugin stylesheet

    Version 1.0 (16-2-2015)

    • Release
    by
    by
    by
    by
    by
    by