ACF: Star Rating Field

Description

Add the possibility to use rating field in ACF.

Plug-in provide three calculation method for voting:

1. calculate by cookies (any visitor);
2. by IP (any visitor);
3. by user id (registered users only).

If “calculated by cookies” is selected, the only users which use browser with
cookies enabled will be able to vote

In field settings you can also:

1. open|close vote;
2. tune the number of stars (1 to 20);
3. specify the method of re-voting – possible(period)|never

Use the_field($field_key, $post_id) or get_field($field_key, $post_id) function
in page template for field output (see ACF documentation).

In admin panel the rating is inactive.

Attention! Before removing the plugin files read uninstall.php

Languages: English, Fran?ais, Русский

I apologize for possible mistakes in plugin translation.
I will be glad to accept the help with the correct translation of a plugin into
English and to correction of my mistakes.

Gratitudes:

Thanks to Ivan Shamshur for JS.

French Translation – thanks to Nicolas Kern.

Compatibility

This ACF field type is compatible with: ACF 4

For developers: https://github.com/lienann/acf-starrating

Screenshots

Installation

1. Copy the acf-starrating folder into your wp-content/plugins folder
2. Activate the Star Rating Field plugin via the plugins admin page
3. Create a new field via ACF and select the Star Rating type
4. Add the_field ($field_key, $post->ID) function in the template of your theme.
   Please refer to the description and FAQ for more info regarding the field type
   settings.

FAQ

How to display field on the page?

Add the_field($field_key, $post_id) or get_field($field_key, $post_id) into page
template where it is necessary for you (use $field_name only, if you are sure that field value exists):

<?php
    // add fields in the Loop
    if ( have_posts() ) {
        while ( have_posts() ) {
            the_post();
            if ( function_exists( 'the_field' ) ) {
                the_field( 'quality', $post->ID );
            }
            the_content(); 
        } // end while
    } // end if
?>
<?php
    // display rating field for post_id=123
    if ( function_exists( 'the_field' ) ) {
        the_field( 'interest', '123' );
        the_field( 'field_62ad11se531h', '123' );
    }
?>
<?php
    // display rating field of user_id = 1
    // to pass $post_id value use 'user_' + user ID format
    if ( function_exists( 'get_field' ) ) {
        $field = get_field( 'field_53ac25b2e521', 'user_1' );
        echo $field;
    }
?>

For detailed information about this functions see ACF documentation.

How to display vote results and number of votes?

Use get_field() function of ACF plugin (with the third option = FALSE), to display
vote result on the page:

Reviews

how could i made it compatible with latest acf

ramineros January 15, 2021 1 reply

how could i made it compatible with latest acf

The plugin is great, if you add something it’ll be greater!

GeroNikolov March 8, 2017

Hey, The plugin is almost perfect! The only thing that is missing is a function that returns the average voting results. Can you add it please? ?? Thank you! Cheers mi amigo!

How to Enable Rich Snippets

vamban February 8, 2017

Plugin seems promising and looking to use with my blog [ link redacted, please do not post links in reviews ] How can i apply google rich snippets to the star ratings?

Contributors & Developers

Changelog

1.0.2

• Added French Translation. Thanks to Nicolas Kern.

1.0.1

• Fixed bug with cookie setup.
• Updated documentations.

1.0.0

• Initial Release.