WP-PostRatings Plugin

<?php add_filter( 'wp_postratings_schema_itemtype', 'wp_postratings_schema_itemtype' ); function wp_postratings_schema_itemtype( $itemtype ) { return 'itemscope itemtype="http://schema.org/Recipe"'; } ?> 

The default schema type is ‘Article’, if you want to change it to ‘Recipe’, you need to make use of the wp_postratings_schema_itemtype filter as shown in the sample code above.

<?php add_filter( 'wp_postratings_site_logo', 'wp_postratings_site_logo' ); function wp_postratings_site_logo( $url ) { return 'http://placehold.it/350/150.png'; } ?> 

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 wp_postratings_site_logo filter as shown in the sample code above.

<?php add_filter( 'wp_postratings_ratings_image_alt', 'wp_postratings_ratings_image_alt' ); function wp_postratings_ratings_image_alt( $alt_title_text ) { return ''; } ?> 

add_filter( 'wp_postratings_display_comment_author_ratings', '__return_true' ); 

By default, the comment author ratings are not displayed. If you want to display the ratings, you need to make use of the wp_postratings_display_comment_author_ratings filter as shown in the sample code above.

function custom_rating_image_extension() { return 'png'; } add_filter( 'wp_postratings_image_extension', 'custom_rating_image_extension' ); 

The default image extension if ‘gif’, if you want to change it to ‘png’, you need to make use of the wp_postratings_image_extension filter as shown in the sample code above.

function custom_rating_cookie_expiration() { return strtotime( 'tomorrow' ) ; } add_filter( 'wp_postratings_cookie_expiration', 'custom_rating_cookie_expiration', 10, 0 ); 

The default cookie expiration if ‘time() + 30000000’, if you want to change the lenght of the experation, you need to make use of the wp_postratings_cookie_expiration filter as shown in the sample code above.

• WP-PostRatings will load postratings-css.css from your theme’s CSS directory if it exists.
• If it doesn’t exists, it will just load the default ‘postratings-css.css’ that comes with WP-PostRatings.
• This will allow you to upgrade WP-PostRatings without worrying about overwriting your ratings styles that you have created.

1. Go to WP-Admin -> Appearance -> Widgets
2. The widget name is Ratings.

<?php if (function_exists('get_lowest_rated')): ?> <ul> <?php get_lowest_rated(); ?> </ul> <?php endif; ?> 

• Default: get_lowest_rated(‘both’, 0, 10)
• The value ‘both’ will display both the lowest rated posts and pages.
• If you want to display the lowest rated posts only, replace ‘both’ with ‘post’.
• If you want to display the lowest rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 lowest rated posts/pages.

<?php if (function_exists('get_lowest_rated_tag')): ?> <ul> <?php get_lowest_rated_tag(TAG_ID); ?> </ul> <?php endif; ?> 

• Default: get_lowest_rated_tag(TAG_ID, ‘both’, 0, 10)
• Replace TAG_ID will your tag ID. If you want it to span several categories, replace TAG_ID with array(1, 2) where 1 and 2 are your categories ID.
• The value ‘both’ will display both the lowest rated posts and pages.
• If you want to display the lowest rated posts only, replace ‘both’ with ‘post’.
• If you want to display the lowest rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 lowest rated posts/pages.

<?php if (function_exists('get_lowest_rated_category')): ?> <ul> <?php get_lowest_rated_category(CATEGORY_ID); ?> </ul> <?php endif; ?> 

• Default: get_lowest_rated_category(CATEGORY_ID, ‘both’, 0, 10)
• Replace CATEGORY_ID will your category ID. If you want it to span several categories, replace CATEGORY_ID with array(1, 2) where 1 and 2 are your categories ID.
• The value ‘both’ will display both the lowest rated posts and pages.
• If you want to display the lowest rated posts only, replace ‘both’ with ‘post’.
• If you want to display the lowest rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 lowest rated posts/pages.

<?php if (function_exists('get_highest_rated')): ?> <ul> <?php get_highest_rated(); ?> </ul> <?php endif; ?> 

• Default: get_highest_rated(‘both’, 0, 10)
• The value ‘both’ will display both the highest rated posts and pages.
• If you want to display the highest rated posts only, replace ‘both’ with ‘post’.
• If you want to display the highest rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 highest rated posts/pages.

<?php if (function_exists('get_highest_rated_tag')): ?> <ul> <?php get_highest_rated_tag(TAG_ID); ?> </ul> <?php endif; ?> 

• Default: get_highest_rated_tag(TAG_ID, ‘both’, 0, 10)
• Replace TAG_ID will your tag ID. If you want it to span several categories, replace TAG_ID with array(1, 2) where 1 and 2 are your categories ID.
• The value ‘both’ will display both the highest rated posts and pages.
• If you want to display the highest rated posts only, replace ‘both’ with ‘post’.
• If you want to display the highest rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 highest rated posts/pages.

<?php if (function_exists('get_highest_rated_category')): ?> <ul> <?php get_highest_rated_category(CATEGORY_ID); ?> </ul> <?php endif; ?> 

• Default: get_highest_rated_category(CATEGORY_ID, ‘both’, 0, 10)
• Replace CATEGORY_ID will your category ID. If you want it to span several categories, replace CATEGORY_ID with array(1, 2) where 1 and 2 are your categories ID.
• The value ‘both’ will display both the highest rated posts and pages.
• If you want to display the highest rated posts only, replace ‘both’ with ‘post’.
• If you want to display the highest rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 highest rated posts/pages.

<?php if (function_exists('get_highest_rated_range')): ?> <ul> <?php get_highest_rated_range('1 day'); ?> </ul> <?php endif; ?> 

• Default: get_highest_rated_range(‘1 day’, ‘both’, 10)
• The value ‘1 day’ will be the range that you want. You can use ‘2 days’, ‘1 month’, etc.
• The value ‘both’ will display both the most rated posts and pages.
• If you want to display the most rated posts only, replace ‘both’ with ‘post’.
• If you want to display the most rated pages only, replace ‘both’ with ‘page’.
• The value 10 will display only the top 10 most rated posts/pages.

<?php if (function_exists('get_most_rated')): ?> <ul> <?php get_most_rated(); ?> </ul> <?php endif; ?> 

• Default: get_most_rated(‘both’, 0, 10)
• The value ‘both’ will display both the most rated posts and pages.
• If you want to display the most rated posts only, replace ‘both’ with ‘post’.
• If you want to display the most rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 most rated posts/pages.

<?php if (function_exists('get_most_rated_category')): ?> <ul> <?php get_most_rated_category(CATEGORY_ID); ?> </ul> <?php endif; ?> 

• Default: get_most_rated_category(CATEGORY_ID, ‘both’, 0, 10)
• Replace CATEGORY_ID will your category ID. If you want it to span several categories, replace CATEGORY_ID with array(1, 2) where 1 and 2 are your categories ID.
• The value ‘both’ will display both the most rated posts and pages.
• If you want to display the most rated posts only, replace ‘both’ with ‘post’.
• If you want to display the most rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 most rated posts/pages.

<?php if (function_exists('get_most_rated_range')): ?> <ul> <?php get_most_rated_range('1 day'); ?> </ul> <?php endif; ?> 

• Default: get_most_rated_range(‘1 day’, ‘both’, 10)
• The value ‘1 day’ will be the range that you want. You can use ‘2 days’, ‘1 month’, etc.
• The value ‘both’ will display both the most rated posts and pages.
• If you want to display the most rated posts only, replace ‘both’ with ‘post’.
• If you want to display the most rated pages only, replace ‘both’ with ‘page’.
• The value 10 will display only the top 10 most rated posts/pages.

<?php if (function_exists('get_highest_score')): ?> <ul> <?php get_highest_score(); ?> </ul> <?php endif; ?> 

• Default: get_highest_score(‘both’, 0, 10)
• The value ‘both’ will display both the most rated posts and pages.
• If you want to display the most rated posts only, replace ‘both’ with ‘post’.
• If you want to display the most rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 most rated posts/pages.

<?php if (function_exists('get_highest_score_category')): ?> <ul> <?php get_highest_score_category(CATEGORY_ID); ?> </ul> <?php endif; ?> 

• Default: get_highest_score_category(CATEGORY_ID, ‘both’, 0, 10)
• Replace CATEGORY_ID will your category ID. If you want it to span several categories, replace CATEGORY_ID with array(1, 2) where 1 and 2 are your categories ID.
• The value ‘both’ will display both the most rated posts and pages.
• If you want to display the most rated posts only, replace ‘both’ with ‘post’.
• If you want to display the most rated pages only, replace ‘both’ with ‘page’.
• The value 0 refers to the minimum votes required before the post get shown.
• The value 10 will display only the top 10 most rated posts/pages.

<?php if (function_exists('get_highest_score_range')): ?> <ul> <?php get_highest_score_range('1 day'); ?> </ul> <?php endif; ?> 

• Default: get_highest_score_range(‘1 day’, ‘both’, 10)
• The value ‘1 day’ will be the range that you want. You can use ‘2 days’, ‘1 month’, etc.
• The value ‘both’ will display both the most rated posts and pages.
• If you want to display the most rated posts only, replace ‘both’ with ‘post’.
• If you want to display the most rated pages only, replace ‘both’ with ‘page’.
• The value 10 will display only the top 10 most rated posts/pages.

• You can use: <?php query_posts( array( 'meta_key' => 'ratings_average', 'orderby' => 'meta_value_num', 'order' => 'DESC' ) ); ?>
• Or pass in the variables to the URL: http://yoursite.com/?r_sortby=highest_rated&r_orderby=desc
• You can replace desc with asc if you want the lowest rated posts.

• You can use: <?php query_posts( array( 'meta_key' => 'ratings_users', 'orderby' => 'meta_value_num', 'order' => 'DESC' ) ); ?>
• Or pass in the variables to the URL: http://yoursite.com/?r_sortby=most_rated&r_orderby=desc
• You can replace desc with asc if you want the least rated posts.