Title: Custom Ratings
Author: Steve Puddick
Published: <strong>8 mars 2016</strong>
Last modified: 14 janvier 2023

---

Recherche d’extensions

![](https://ps.w.org/custom-ratings/assets/banner-772x250.jpg?rev=1369537)

Cette extension **n’a pas été testée avec plus de trois mises à jour majeures de
WordPress**. Elle peut ne plus être maintenue ou supportée et peut avoir des problèmes
de compatibilité lorsqu’elle est utilisée avec des versions de WordPress plus récentes.

![](https://ps.w.org/custom-ratings/assets/icon-256x256.jpg?rev=1369537)

# Custom Ratings

 Par [Steve Puddick](https://profiles.wordpress.org/stevepuddick/)

[Télécharger](https://downloads.wordpress.org/plugin/custom-ratings.1.5.1.zip)

 * [Détails](https://fr-be.wordpress.org/plugins/custom-ratings/#description)
 * [Avis](https://fr-be.wordpress.org/plugins/custom-ratings/#reviews)
 *  [Installation](https://fr-be.wordpress.org/plugins/custom-ratings/#installation)
 * [Développement](https://fr-be.wordpress.org/plugins/custom-ratings/#developers)

 [Support](https://wordpress.org/support/plugin/custom-ratings/)

## Description

Custom Ratings is a fun and creative tool that allows your visitors to interact 
and rate your site content.

 * Choose from a selection of ‘built in’ rating images or upload your own single
   image. Custom ratings automatically converts the image to grayscale for disabled
   ratings, and splits images in half for half values.
 * All text is fully customizable and translateable.
 * WPML compatible with a cumulative tallying system between languages.
 * Use the built in CSS or your own.
 * Fully compatible with caching plugins such as W3C Total Cache and Super Cache.
 * Full control over caching time for AJAX based voting data.
 * Option for manual placement of Custom Ratings components in theme templates.
 * Full support for custom post types.
 * Compatible with WooCommerce products.
 * Control over which templates Custom Ratings appears on.

Add some personality to your website and install Custom Ratings today!

Thanks to the following open source projects which Custom Ratings has utilized:

 * [Ractive](http://www.ractivejs.org/)
 * [Spectrum](https://bgrins.github.io/spectrum/)

## Captures d’écran

[⌊Front end display of rating vote interface (voted)⌉⌊Front end display of rating
vote interface (voted)⌉[

Front end display of rating vote interface (voted)

[⌊Front end display of rating vote interface (un voted)⌉⌊Front end display of rating
vote interface (un voted)⌉[

Front end display of rating vote interface (un voted)

[⌊Front end display of rating tally⌉⌊Front end display of rating tally⌉[

Front end display of rating tally

[⌊Admin settings tab 1⌉⌊Admin settings tab 1⌉[

Admin settings tab 1

[⌊Admin settings tab 2⌉⌊Admin settings tab 2⌉[

Admin settings tab 2

[⌊Admin settings tab 3⌉⌊Admin settings tab 3⌉[

Admin settings tab 3

[⌊Admin post listing⌉⌊Admin post listing⌉[

Admin post listing

[⌊Admin post edit page⌉⌊Admin post edit page⌉[

Admin post edit page

## Installation

 1.  From the plugin managment page in the WordPress admin, search for « Custom Ratings»
 2.  Select « Custom Ratings » from the list of results and click on « install »
 3.  « Custom Ratings » has now been installed. In the WordPress admin, go to « Settings»
     > « Custom Ratings »
 4.  Choose your star type from the included options, or upload your own image (will
     be uploaded to media library)
 5.  Select which post types « Custom Ratings » should be applied to. Posts are selected
     by default
 6.  Select where the rating tally and vote display positions should be in relation
     to the content
 7.  Select the background color, if desired
 8.  Edit the various text snippets, if desired
 9.  Configure other Custom Ratings settings to your preference
 10. Take a look at a « single » or « archive » page of a selected post type (or any
     other page which call the_excerpt or the_content) and you will see the custom 
     ratings components appended

## FAQ

### What is a « star »

In Custom Ratings, a « star » is a general term used to describe the rating object.
A « star » can be a cupcake, heart, star, smiley face, shoe, etc.

### What is a rating tally?

The rating tally is a non-interactive display of the current ratings of a post. 
This is displayed visually as the number of stars out of a total of 5 stars. This
hooks into the « the_excerpt » filter. Where ever that filter is used, the Custom
Ratings rating tally will be displayed (unless disabled in the settings).

### What is a vote display?

The vote display is an interactive component which allows users to rate a post. 
This rating can be 1, 2, 3, 4, or 5 stars out of 5. The vote display hooks into «
the_content » filter. Where ever that filter is used, the Custom Ratings vote display
will be displated (unless disabled in the settings).

### Will this work with WPML? How does the cumulative tallying system work?

Custom Ratings has been designed with WPML compatiblity in mind. All of the votes
of a specific post are shared amongst the different language versions. One caveat
is that a post in the default language must be created in order for Custom Ratings
to function. The default language post holds all of the rating information.

### Does this work with custom post types?

Yes. You can choose which (if any) custom post types Custom Ratings gets applied
to.

### How does the caching of AJAX vote data work?

Each time a page loads with Custom Ratings components, an AJAX request is sent to
the web server to get the vote information for the posts on that page. The « Expires»
and « Cache-Control » values can be specified for this request if desired. CDNs 
and other caching tools can read these HTTP headers and handle the caching from 
there.

### How can I use Custom Ratings in my custom development?

Custom Ratings has been designed to offer lots of flexibility for custom theme development:

 * `Custom_Ratings::get_rating_object_image_src()` can be used in your theme to 
   get the ‘star’ (rating object) image
 * `echo Custom_Ratings_Public::display()` can be used to manually output the rating
   tally
 * `echo Custom_Ratings_Public::vote()` can be used to manually output the rating
   vote interface

If you are [creating your own queries](https://codex.wordpress.org/Class_Reference/WP_Query#Order_.26_Orderby_Parameters),
you can order the results in different ways:

 * The post meta key `_wpcr_rating_stars_avg` can be used to order posts by rating
   average
 * The post meta key `_wpcr_rating_stars_count` can be used to order posts by total
   rating count

## Avis

![](https://secure.gravatar.com/avatar/2f69181fae92d5165c40a59d4aa63c5800937a45fe425b3a32046294076742b6?
s=60&d=retro&r=g)

### 󠀁[great for a few weeks, then a total meltdown](https://wordpress.org/support/topic/great-for-a-few-weeks-then-a-total-meltdown/)󠁿

 [bravium69](https://profiles.wordpress.org/bravium69/) 14 juin 2023

It just spins, it just spins the "Loading Custom Ratings" text!

![](https://secure.gravatar.com/avatar/5e7d44f7451eb436bbbab64d16a1a82fa9cd14ee8bf7c93793ef1ff78dbbbfa9?
s=60&d=retro&r=g)

### 󠀁[Gr8, almost perfect !!! How can I …](https://wordpress.org/support/topic/gr8-almost-perfect-how-can-i/)󠁿

 [drafcio](https://profiles.wordpress.org/drafcio/) 24 septembre 2017

Hello, your plugin is gr8, almost perfect. Is there any chance to pick different
image in different pages ?? For example: one page i have hearts second page i have
thumbs third page i have stars fout page i dont want to have rating I managed to
change the position to put it into my widget. The ansewer was in internet. For those
who need this: put this into yourtheme/function.php <?php add_shortcode( 'vote','
vote_custom_ratings' ); function vote_custom_ratings() { $return_text = ''; if (
class_exists( 'Custom_Ratings_Public' ) ) { $return_text .= Custom_Ratings_Public::
vote(); } return $return_text; } ?> then put [vote] where you want it on page or
widget. (Make sure to set the Vote Display Position to None in the Custom Ratings
Settings).

![](https://secure.gravatar.com/avatar/5214c2f78c35d47f803016fcb121d396e83661bd76e341f1ac2cee6e2725ebab?
s=60&d=retro&r=g)

### 󠀁[great!](https://wordpress.org/support/topic/great-6760/)󠁿

 [magicthor](https://profiles.wordpress.org/magicthor/) 10 juillet 2017

Super Plugin! Thanks!

![](https://secure.gravatar.com/avatar/e308915395c38fd65e72310d4669824eb5ce361abeae326ac5b7010a2ffda6fb?
s=60&d=retro&r=g)

### 󠀁[Great plugin for what my client required](https://wordpress.org/support/topic/great-plugin-for-what-my-client-required/)󠁿

 [doulou](https://profiles.wordpress.org/doulou/) 19 octobre 2016

Just wanted to say this plugin worked perfectly when my client wanted a custom rating
image for their site. There was a conflict with the latest Wordpress update and 
uploading images to posts, I alerted the plugin makers and they fixed the conflict
with the next plugin update and wrote back to inform me so I was very pleased with
their support.

![](https://secure.gravatar.com/avatar/8878ef916e9611754b16aa4f10b386043f742e8ceef7807e5d5eebd683290b46?
s=60&d=retro&r=g)

### 󠀁[Works Great](https://wordpress.org/support/topic/works-great-1763/)󠁿

 [steve8484](https://profiles.wordpress.org/steve8484/) 14 octobre 2016

Works great, has all the features I need, easy to customize and use.

![](https://secure.gravatar.com/avatar/abeb531302de1a90073e9a01a52d5196b31233ce9574b86e4a428f0a5b84466d?
s=60&d=retro&r=g)

### 󠀁[Nice Plugin](https://wordpress.org/support/topic/nice-plugin-1725/)󠁿

 [donadams48](https://profiles.wordpress.org/donadams48/) 3 septembre 2016 1 reply

Nice plugin but the images are way to large, couldn't find a way to reduce them.

 [ Lire les 7 avis ](https://wordpress.org/support/plugin/custom-ratings/reviews/)

## Contributeurs & développeurs

« Custom Ratings » est un logiciel libre. Les personnes suivantes ont contribué 
à cette extension.

Contributeurs

 *   [ Steve Puddick ](https://profiles.wordpress.org/stevepuddick/)

[Traduisez « Custom Ratings » dans votre langue.](https://translate.wordpress.org/projects/wp-plugins/custom-ratings)

### Le développement vous intéresse ?

[Parcourir le code](https://plugins.trac.wordpress.org/browser/custom-ratings/),
consulter le [SVN dépôt](https://plugins.svn.wordpress.org/custom-ratings/), ou 
s’inscrire au [journal de développement](https://plugins.trac.wordpress.org/log/custom-ratings/)
par [RSS](https://plugins.trac.wordpress.org/log/custom-ratings/?limit=100&mode=stop_on_copy&format=rss).

## Journal

#### 1.5.0

 * Fixed issue that prevents featured image selection from working on posts, pages,
   and other post types
 * Added rating tally and rating vote image width fields
 * Fixed issue with proper caching time output
 * Fixed issue with proper alignment of rating display
 * Added rating column to admin post listing
 * Added controls to hide rating tally on front end
 * Added conditional checks for ‘in the loop’
 * Added conditional checks for ‘front page’, ‘home’, ‘archive’, and ‘search’ templates
 * Code clean up

#### 1.0.1

 * Option to hide Custom Ratings components on front page
 * Fix to ‘money’ image file path
 * Option to disable Custom Ratings CSS
 * Full WPML compatibility
 * Removed ‘post’ as the default post type Custom Ratings is applied to
 * Set default excerpt attachment to none

#### 1.0.0

 * Initial version

## Méta

 *  Version **1.5.1**
 *  Last updated **il y a 4 années**
 *  Active installations **70+**
 *  WordPress version ** 3.5 ou plus **
 *  Tested up to **6.1.15**
 *  Language
 * [English (US)](https://wordpress.org/plugins/custom-ratings/)
 * Tags
 * [post](https://fr-be.wordpress.org/plugins/tags/post/)[rating](https://fr-be.wordpress.org/plugins/tags/rating/)
   [stars](https://fr-be.wordpress.org/plugins/tags/stars/)[user rating](https://fr-be.wordpress.org/plugins/tags/user-rating/)
   [woocommerce](https://fr-be.wordpress.org/plugins/tags/woocommerce/)
 *  [Vue avancée](https://fr-be.wordpress.org/plugins/custom-ratings/advanced/)

## Notes

 4.1 out of 5 stars.

 *  [  5 5-star reviews     ](https://wordpress.org/support/plugin/custom-ratings/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/custom-ratings/reviews/?filter=4)
 *  [  1 3-star review     ](https://wordpress.org/support/plugin/custom-ratings/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/custom-ratings/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/custom-ratings/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/custom-ratings/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/custom-ratings/reviews/)

## Contributeurs

 *   [ Steve Puddick ](https://profiles.wordpress.org/stevepuddick/)

## Support

Quelque chose à dire ? Besoin d’aide ?

 [Voir le forum de support](https://wordpress.org/support/plugin/custom-ratings/)