Requires WordPress 6.8 and PHP 8.2.<\/p>\n\n
Settings migrate on the first admin page load.<\/strong> The fifteen Update all seven WP-Stats plugins together.<\/strong> WP-Stats, WP-PostRatings, WP-Polls, WP-EMail, WP-PostViews, WP-DownloadManager and WP-DraftsForFriends shared two unprefixed rows, The settings screen is at Ratings -> Settings<\/strong>, with Ratings Options and Ratings Templates as two tabs of it. Two Google rich snippet settings became one, defaulting to No.<\/strong> "Enable Google Rich Snippets?" and "Enable Ratings In Rich Snippets?" are now Show ratings in Google results?<\/strong>. The old markup declared If you filtered Rating images are now CSS shapes.<\/strong> The 16 image sets are 9 shapes; whichever set you had is mapped to the matching shape automatically. A custom image folder falls back to stars \u2014 the FAQ shows how to register a shape instead, which survives updates.<\/p>\n\n Custom CSS needs updating.<\/strong> Every class and id is slug-prefixed now:<\/p>\n\n Colour, size, spacing and hover colour are CSS custom properties, so most overrides become a one-line change. See the FAQ.<\/p>\n\n Renamed with no shim left behind:<\/strong><\/p>\n\n The template tags \u2014 "Header That Contains The IP" now reads only the first valid address<\/strong> rather than storing the whole chain. Rating logs recorded through it before the update no longer match, so a few visitors may be able to rate once more. Clear the field unless you are behind a reverse proxy.<\/p>\n\n Custom JavaScript.<\/strong> The markup carries no inline WP-PostRatings adds a rating control to any post, page or custom post type. Visitors pick a value, the vote is posted in the background, and the result appears in its place without a page load.<\/p>\n\n I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appreciate it. If not feel free to use it without any obligations.<\/p>\n\n The simplest way, and the only one that works in a block theme without editing template files, is the shortcode. Put it in the post or page you want rated:<\/p>\n\n To put ratings on every post automatically, a classic theme can call the template tag from The settings live at WP-Admin -> Ratings -> Settings<\/strong>, which has a Settings tab and a Templates tab.<\/p>\n\n A Ratings<\/strong> block is available in the editor, under Widgets<\/strong>. Two settings in the sidebar:<\/p>\n\n It renders on the server, so the preview in the editor is the real rating rather than an approximation, and changing your shape, colours or templates updates every post showing it without re-saving anything. The preview is deliberately not clickable: rating from the editor would record a real vote.<\/p>\n\n The shortcode still works and is not going anywhere.<\/strong> A rating lives in two places \u2014 the running totals each post displays, and a row per vote in the log. Reading is public, because a rating is public. Rating takes the same Each response carries the rendered markup as well as the numbers, because your templates and your chosen shape decide what a rating looks like.<\/p>\n\n A refusal answers 403<\/strong>, not 400 \u2014 a rating already cast, a rating off the end of the scale, a bad nonce. 400 is kept for a parameter this plugin never had a chance to look at, and a post that does not exist is 404.<\/p>\n\n These routes are an addition.<\/strong> The Go to Hovering uses the rated colour. If you would rather tell \"about to pick\" apart from \"already recorded\", set Anything beyond the two colours is a CSS custom property on Before 2.0.0 a different colour meant a whole extra folder of images, which is why the plugin shipped Register it with the The path is SVG path data drawn in a 24x24 box. For an up\/down control use This is about the Header That Contains The IP<\/strong> field on the Ratings Options screen.<\/p>\n\n Leave it blank unless your site is genuinely behind a reverse proxy or CDN such as Cloudflare. Blank means the plugin uses the address your web server actually saw, which is what you want on a normal host.<\/p>\n\n If you are behind a proxy, name the exact header your proxy sets, for example Because the stored value has changed shape, rating logs recorded through such a header before 2.0.0 will not match any more, and some visitors may be able to rate one more time. Logs recorded without the field set are unaffected.<\/p><\/dd>\n The default schema type is 'Article', if you want to change it to 'Recipe', you need to make use of the By default, the plugin will use your site header image URL as your site logo. If you want to change it, you need to make use of the This is the description a screen reader reads out for a displayed rating, such as \"4 votes, average: 3.70 out of 5\". Since 2.0.0 the ratings are drawn with CSS rather than images, so there is no Returning an empty string removes it, which is what this filter was usually used for. Be aware that it leaves the rating with no accessible name at all, so anyone using a screen reader is told nothing about it. Prefer rewording it over removing it.<\/p><\/dd>\npostratings_*<\/code> rows, plus the shared stats_display<\/code> and stats_mostlimit<\/code> rows, are folded into one wp_postratings_options<\/code> row, and postratings_db_version<\/code> and postratings_options_version<\/code> become a single wp_postratings_version<\/code>. Code reading the old rows directly will find them gone.<\/p>\n\nstats_display<\/code> and stats_mostlimit<\/code>. Each now keeps its own copy and deletes the shared rows once it has read them, so whichever you update first takes them from the rest. A missing row means "show", so a block you had switched off may reappear \u2014 switch it off again under Ratings -> Settings -> WP-Stats<\/strong>, where the setting and the entries-per-list figure now live.<\/p>\n\nadmin.php?page=wp-postratings-options<\/code> is now admin.php?page=wp-postratings-settings<\/code>. The capability is still manage_ratings<\/code>.<\/p>\n\nschema.org\/Article<\/code>, and Google shows ratings only for Book, Course, Event, Local Business, Movie, Organization, Product, Recipe, Software App and a few subtypes \u2014 so on an ordinary post it never produced a rich result.<\/p>\n\nwp_postratings_schema_itemtype<\/code> to a supported type, you were<\/em> getting a real rich result, and it stops until you select that same type in the new setting. The filter still runs and still has the last word. Pick a type only if the content genuinely is that thing: marking a blog post as a Product<\/code> to collect stars is spammy structured markup, and it costs a manual action.<\/p>\n\n\n
.post-ratings<\/code> is now .wp-postratings<\/code><\/li>\n.post-ratings-image<\/code> is gone; there is no `` any more<\/li>\nwp-postratings-123<\/code>, not post-ratings-123<\/code><\/li>\ncss\/wp-postratings.css<\/code>, not postratings-css.css<\/code>, and there is no -rtl<\/code> variant<\/li>\n<\/ul>\n\n\n
rate_post<\/code> action is now wp_postratings_rate_post<\/code>, with the same three arguments<\/li>\nRATINGS_IMG_EXT<\/code> is now WP_POSTRATINGS_IMG_EXT<\/code><\/li>\nWP_PostRatings_*<\/code> rather than Postratings_*<\/code><\/li>\n<\/ul>\n\nthe_ratings()<\/code>, get_highest_rated()<\/code>, get_most_rated()<\/code> and the rest \u2014 and the twenty-two wp_postratings_*<\/code> filters are unchanged.<\/p>\n\nonmouseover<\/code> or onclick<\/code> handlers and there is no jQuery. Code calling current_rating()<\/code> or rate_post()<\/code> in the browser must be rewritten against the delegated listener in js\/wp-postratings.js<\/code>.<\/p>"},"ratings":{"1":19,"2":3,"3":9,"4":15,"5":133},"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":978014,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3639532,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3639532,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"wp-postratings\/ratings":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"wp-postratings\/ratings","version":"2.0.0","title":"Ratings","category":"widgets","icon":"star-filled","description":"A rating control for a post, or its result on its own.","keywords":["rating","ratings","vote","stars"],"textdomain":"wp-postratings","attributes":{"id":{"type":"number","default":0},"results":{"type":"boolean","default":false}},"supports":{"html":false,"multiple":true,"reusable":false},"editorScript":"file:.\/index.js"}},"tagged_versions":["1.00","1.00beta","1.01","1.02","1.02a","1.03","1.03(wp1.52)","1.04","1.05","1.10","1.11","1.20","1.30","1.31","1.40","1.50","1.65","1.77","1.78","1.79","1.80","1.81","1.82","1.83","1.83.1","1.83.2","1.84","1.84.1","1.85","1.86","1.86.1","1.86.2","1.87","1.88","1.89","1.89.1","1.90","1.91","1.91.1","1.91.2","1.91.3","2.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3639889,"resolution":"1","location":"assets","locale":"","width":1100,"height":1930},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3639889,"resolution":"2","location":"assets","locale":"","width":1100,"height":1872},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3639889,"resolution":"3","location":"assets","locale":"","width":1100,"height":2512},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3639889,"resolution":"4","location":"assets","locale":"","width":1000,"height":372},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3639889,"resolution":"5","location":"assets","locale":"","width":1440,"height":620}},"screenshots":{"1":"Ratings -> Settings: the shape, the scale, who may rate, and how a repeat is spotted","2":"The Templates tab, holding the markup of the control and of every result","3":"Ratings -> Logs, every vote with who cast it, filterable by user and by rating","4":"The control in a post with a star under the pointer, and the same rating read-only below","5":"The Ratings block in the editor, previewing the control for the post it is pointed at, with the sidebar choosing that post and whether the rating can be cast or only read"}},"plugin_section":[],"plugin_tags":[221,86,2295,8203,9827],"plugin_category":[53,56,59],"plugin_contributors":[77620],"plugin_business_model":[],"class_list":["post-387","plugin","type-plugin","status-publish","hentry","plugin_tags-ajax","plugin_tags-post","plugin_tags-rating","plugin_tags-ratings","plugin_tags-vote","plugin_category-ratings-and-reviews","plugin_category-social-and-sharing","plugin_category-utilities-and-tools","plugin_contributors-gamerz","plugin_committers-gamerz"],"banners":{"banner":"https:\/\/ps.w.org\/wp-postratings\/assets\/banner-772x250.png?rev=3639532","banner_2x":"https:\/\/ps.w.org\/wp-postratings\/assets\/banner-1544x500.png?rev=3639532","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/wp-postratings\/assets\/icon.svg?rev=978014","icon":"https:\/\/ps.w.org\/wp-postratings\/assets\/icon.svg?rev=978014","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/wp-postratings\/assets\/screenshot-1.png?rev=3639889","caption":"Ratings -> Settings: the shape, the scale, who may rate, and how a repeat is spotted"},{"src":"https:\/\/ps.w.org\/wp-postratings\/assets\/screenshot-2.png?rev=3639889","caption":"The Templates tab, holding the markup of the control and of every result"},{"src":"https:\/\/ps.w.org\/wp-postratings\/assets\/screenshot-3.png?rev=3639889","caption":"Ratings -> Logs, every vote with who cast it, filterable by user and by rating"},{"src":"https:\/\/ps.w.org\/wp-postratings\/assets\/screenshot-4.png?rev=3639889","caption":"The control in a post with a star under the pointer, and the same rating read-only below"},{"src":"https:\/\/ps.w.org\/wp-postratings\/assets\/screenshot-5.png?rev=3639889","caption":"The Ratings block in the editor, previewing the control for the post it is pointed at, with the sidebar choosing that post and whether the rating can be cast or only read"}],"raw_content":"\nFeatures<\/h3>\n\n
\n
Donations<\/h3>\n\n
Usage<\/h3>\n\n
\n
[ratings]<\/code> rates the post it appears in.<\/li>\n[ratings id=\"1\"]<\/code> shows the rating for post 1, wherever you put it.<\/li>\n[ratings id=\"1\" results=\"true\"]<\/code> shows post 1's result without letting anyone vote from there.<\/li>\n<\/ul>\n\nsingle.php<\/code>, archive.php<\/code> or index.php<\/code>, anywhere inside the loop:<\/p>\n\n<?php the_ratings(); ?>\n<\/code><\/pre>\n\nShowing A Rating In A Block<\/h3>\n\n
\n
[ratings]<\/code> does, or give an id to show another post's rating wherever you put the block.<\/li>\nresults=\"true\"<\/code> does.<\/li>\n<\/ul>\n\n[ratings]<\/code>, [ratings id=\"1\"]<\/code> and [ratings id=\"1\" results=\"true\"]<\/code> behave exactly as they always have, and a post already containing one needs no change. The block calls the same code the shortcode calls, so the two render identically \u2014 use whichever suits the post.<\/p>\n\nWP-CLI<\/h3>\n\n
wp postratings list\nwp postratings list --limit=50 --format=json\nwp postratings get 42\nwp postratings delete 42 --yes\nwp postratings delete --all --what=logs\n<\/code><\/pre>\n\n--what<\/code> chooses which to clear: logs<\/code>, data<\/code> or both<\/code>, and both<\/code> is the default.<\/p>\n\nREST API<\/h3>\n\n
GET \/wp-json\/postratings\/v1\/post\/<id>\nPOST \/wp-json\/postratings\/v1\/post\/<id>\/rate\n<\/code><\/pre>\n\nwp_postratings_<id>-nonce<\/code> the rendered control already carries, passed as a nonce<\/code> parameter, and is subject to the same eligibility and repeat-rating settings as rating through the page.<\/p>\n\nadmin-ajax.php<\/code> wp_postratings<\/code> action is unchanged and still supported.<\/p>\n\n\n\n
WP-Admin -> Ratings -> Settings<\/code> and choose the shape, the scale and who is allowed to rate.<\/li>\n[ratings]<\/code> into a post, add the Ratings<\/strong> block, or call the_ratings()<\/code> from your theme.<\/li>\n<\/ol>\n\n\n\n
How do I change the colour of the ratings?<\/h3><\/dt>\n
WP-Admin -> Ratings -> Settings<\/code> and look under Individual Rating Text and Value<\/strong>. Each step on the scale has its own pair of colour swatches, in the Rated<\/strong> and Not rated<\/strong> columns, which is what the old stars_crystal<\/code> and stars_dark<\/code> image sets were for.<\/p>\n\n--wp-postratings-color-hover<\/code> in your theme.<\/p><\/dd>\nHow do I change the size, spacing or hover colour?<\/h3><\/dt>\n
.wp-postratings<\/code>, so this is all it takes in your theme:<\/p>\n\n.wp-postratings {\n --wp-postratings-size: 24px;\n --wp-postratings-gap: 4px;\n --wp-postratings-color-hover: #f7c56b;\n}\n<\/code><\/pre>\n\nstars<\/code>, stars_crystal<\/code> and stars_dark<\/code> separately. They are all the same shape now.<\/p><\/dd>\nHow do I use my own rating shape?<\/h3><\/dt>\n
wp_postratings_shapes<\/code> filter. It then appears on the Ratings Options screen like any built-in shape, and unlike the old approach of dropping a folder into wp-content\/plugins\/wp-postratings\/images\/<\/code>, it survives an update.<\/p>\n\nadd_filter( 'wp_postratings_shapes', function ( $shapes ) {\n $shapes['diamond'] = array(\n 'type' => 'scale',\n 'label' => 'Diamonds',\n 'path' => 'M12 2l10 10-10 10L2 12z',\n );\n\n return $shapes;\n} );\n<\/code><\/pre>\n\n'type' => 'updown'<\/code> and supply 'up'<\/code> and 'down'<\/code> paths instead of 'path'<\/code>.<\/p><\/dd>\nEvery visitor can rate over and over, or every rating log entry shows the same IP<\/h3><\/dt>\n
HTTP_CF_CONNECTING_IP<\/code> for Cloudflare or HTTP_X_FORWARDED_FOR<\/code> for most load balancers. Two things are worth knowing:<\/p>\n\n\n
X-Forwarded-For<\/code> is a list, client, proxy1, proxy2<\/code>. As of 2.0.0 the plugin reads the first valid address in that list rather than storing the whole string. Before 2.0.0 it stored the whole string, which meant a visitor could append one more address and appear to be somebody new on every request.<\/li>\n<\/ul>\n\nHow To Change Schema Type?<\/h3><\/dt>\n
<?php \nadd_filter( 'wp_postratings_schema_itemtype', 'wp_postratings_schema_itemtype' ); \nfunction wp_postratings_schema_itemtype( $itemtype ) { \n return 'itemscope itemtype=\"https:\/\/schema.org\/Recipe\"'; \n} \n?>\n<\/code><\/pre>\n\nwp_postratings_schema_itemtype<\/code> filter as shown in the sample code above.<\/p><\/dd>\nHow To Add Your Site Logo For Google Rich Snippets<\/h3><\/dt>\n
<?php \nadd_filter( 'wp_postratings_site_logo', 'wp_postratings_site_logo' ); \nfunction wp_postratings_site_logo( $url ) { \n return 'https:\/\/example.com\/logo.png'; \n} \n?>\n<\/code><\/pre>\n\nwp_postratings_site_logo<\/code> filter as shown in the sample code above.<\/p><\/dd>\nHow To Change The Text Screen Readers Announce?<\/h3><\/dt>\n
add_filter( 'wp_postratings_ratings_image_alt', function ( $label ) {\n return $label;\n} );\n<\/code><\/pre>\n\nalt<\/code> or title<\/code> attribute involved; the value becomes the aria-label<\/code> on the rating.<\/p>\n\n