WP-PostRatings

Часті питання

How do I change the colour of the ratings?

Go to WP-Admin -> Ratings -> Settings and look under Individual Rating Text and Value. Each step on the scale has its own pair of colour swatches, in the Rated and Not rated columns, which is what the old stars_crystal and stars_dark image sets were for.

Hovering uses the rated colour. If you would rather tell “about to pick” apart from “already recorded”, set --wp-postratings-color-hover in your theme.

How do I change the size, spacing or hover colour?

Anything beyond the two colours is a CSS custom property on .wp-postratings, so this is all it takes in your theme:

.wp-postratings {
    --wp-postratings-size: 24px;
    --wp-postratings-gap: 4px;
    --wp-postratings-color-hover: #f7c56b;
}

Before 2.0.0 a different colour meant a whole extra folder of images, which is why the plugin shipped stars, stars_crystal and stars_dark separately. They are all the same shape now.

How do I use my own rating shape?

Register it with the wp_postratings_shapes 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/, it survives an update.

add_filter( 'wp_postratings_shapes', function ( $shapes ) {
    $shapes['diamond'] = array(
        'type'  => 'scale',
        'label' => 'Diamonds',
        'path'  => 'M12 2l10 10-10 10L2 12z',
    );

    return $shapes;
} );

The path is SVG path data drawn in a 24×24 box. For an up/down control use 'type' => 'updown' and supply 'up' and 'down' paths instead of 'path'.

Every visitor can rate over and over, or every rating log entry shows the same IP

This is about the Header That Contains The IP field on the Ratings Options screen.

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.

If you are behind a proxy, name the exact header your proxy sets, for example HTTP_CF_CONNECTING_IP for Cloudflare or HTTP_X_FORWARDED_FOR for most load balancers. Two things are worth knowing:

• A visitor can send any header they like. If you name a header your own stack does not set and overwrite, anyone can put whatever they want in it and rate as many times as they please.
• X-Forwarded-For is a list, client, proxy1, proxy2. 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.

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.

Як змінити тип Схеми?

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

Тип схеми за замовчуванням – “Стаття”, якщо ви хочете змінити його на “Рецепт”, вам потрібно скористатися фільтром wp_postratings_schema_itemtype, як показано в прикладі коду вище.

Як додати логотип свого сайту для Google Rich Snippets

<?php  
add_filter( 'wp_postratings_site_logo', 'wp_postratings_site_logo' );  
function wp_postratings_site_logo( $url ) {  
    return 'https://example.com/logo.png';  
}  
?>

За замовчуванням плагін використовуватиме URL-адресу зображення заголовка вашого сайту як логотип вашого сайту. Якщо ви хочете змінити його, вам потрібно скористатися фільтром wp_postratings_site_logo, як показано у прикладі коду вище.

How To Change The Text Screen Readers Announce?

add_filter( 'wp_postratings_ratings_image_alt', function ( $label ) {
    return $label;
} );

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 alt or title attribute involved; the value becomes the aria-label on the rating.

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.

Як відобразити рейтинги Авторів коментарів?

add_filter( 'wp_postratings_display_comment_author_ratings', '__return_true' );

За замовчуванням оцінки авторів коментарів не відображаються. Якщо ви хочете відобразити оцінки, вам потрібно скористатися фільтром wp_postratings_display_comment_author_ratings, як показано у прикладі коду вище.

Як змінити час закінчення терміну дії cookie?

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

За замовчуванням термін дії кукі-файлів ‘time() + 30000000’, якщо ви хочете змінити тривалість експерименту, вам потрібно скористатися фільтром wp_postratings_cookie_expiration, як показано у прикладі коду вище.

Як WP-PostRatings завантажує CSS?

Most restyling needs no CSS file at all any more: the colours are a setting, and the size, spacing and hover colour are custom properties. See the two questions above first.

If you do want to replace the stylesheet wholesale, WP-PostRatings loads wp-postratings.css from your theme’s directory (or its css/ subdirectory) when that file exists, and its own copy otherwise, so an upgrade will not overwrite your styles.

Note the filename changed in 2.0.0: it was postratings-css.css before. A theme still shipping the old name is simply ignored, and the plugin’s own stylesheet loads instead. There is no separate RTL stylesheet any more either, because the rules use logical properties.

Як використовувати статистику рейтингів за допомогою Віджетів?

1. Перейдіть до WP-Admin -> Зовнішній вигляд -> Віджети
2. Назва віджету – Рейтинги.

Показати пости з найнижчим рейтингом

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

• За замовчуванням: get_lowest_rated(‘both’, 0, 10)
• Значення ‘both’ покаже, як пости, так і сторінки з найнижчим рейтингом.
• Якщо ви хочете показувати лише дописи з найнижчим рейтингом, замініть “both” на “post”.
• Якщо ви хочете показати лише сторінки з найнижчим рейтингом, замініть “both” на “page”.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 дописів/сторінок з найнижчим рейтингом.

Щоб відобразити пости з Найнижчим рейтингом за Тегом

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

• За замовчуванням: get_lowest_rated_tag(TAG_ID, ‘both’, 0, 10)
• Замініть TAG_ID на ваш ідентифікатор тегу. Якщо ви хочете, щоб він охоплював кілька категорій, замініть TAG_ID на array(1, 2), де 1 і 2 – це ідентифікатори ваших категорій.
• Значення ‘both’ покаже, як пости, так і сторінки з найнижчим рейтингом.
• Якщо ви хочете показувати лише дописи з найнижчим рейтингом, замініть “both” на “post”.
• Якщо ви хочете показати лише сторінки з найнижчим рейтингом, замініть “both” на “page”.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 дописів/сторінок з найнижчим рейтингом.

Відображати пости з найнижчим рейтингом у Категорії

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

• За замовчуванням: get_lowest_rated_category(CATEGORY_ID, ‘both’, 0, 10)
• Замініть CATEGORY_ID на ідентифікатор вашої категорії. Якщо ви хочете, щоб він охоплював кілька категорій, замініть CATEGORY_ID на array(1, 2), де 1 і 2 – це ідентифікатори ваших категорій.
• Значення ‘both’ покаже, як пости, так і сторінки з найнижчим рейтингом.
• Якщо ви хочете показувати лише дописи з найнижчим рейтингом, замініть “both” на “post”.
• Якщо ви хочете показати лише сторінки з найнижчим рейтингом, замініть “both” на “page”.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 дописів/сторінок з найнижчим рейтингом.

Щоб відобразити пости з Найвищим рейтингом

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

• За замовчуванням: get_highest_rated(‘both’, 0, 10)
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 постів/сторінок з найвищим рейтингом.

Щоб відобразити пости з Найвищим рейтингом за Тегом

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

• За замовчуванням: get_highest_rated_tag(TAG_ID, ‘both’, 0, 10)
• Замініть TAG_ID на ваш ідентифікатор тегу. Якщо ви хочете, щоб він охоплював кілька категорій, замініть TAG_ID на array(1, 2), де 1 і 2 – це ідентифікатори ваших категорій.
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 постів/сторінок з найвищим рейтингом.

Відобразити пости з Найбільшою кількістю балів рейтингу в Категорії

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

• За замовчуванням: get_highest_rated_category(CATEGORY_ID, ‘both’, 0, 10)
• Замініть CATEGORY_ID на ідентифікатор вашої категорії. Якщо ви хочете, щоб він охоплював кілька категорій, замініть CATEGORY_ID на array(1, 2), де 1 і 2 – це ідентифікатори ваших категорій.
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 постів/сторінок з найвищим рейтингом.

Відображати найрейтинговіші пости за певний період

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

• За замовчуванням: get_highest_rated_range(‘1 day’, ‘both’, 10)
• Значення “1 день” буде тим діапазоном, який ви хочете. Ви можете використовувати “2 дні”, “1 місяць” тощо.
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 10 покаже лише 10 найрейтинговіших постів/сторінок.

Показати найрейтинговіші пости

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

• За замовчуванням: get_most_rated(‘both’, 0, 10)
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 найрейтинговіших постів/сторінок.

Відображати найрейтинговіші пости в Категорії

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

• За замовчуванням: get_most_rated_category(CATEGORY_ID, ‘both’, 0, 10)
• Замініть CATEGORY_ID на ідентифікатор вашої категорії. Якщо ви хочете, щоб він охоплював кілька категорій, замініть CATEGORY_ID на array(1, 2), де 1 і 2 – це ідентифікатори ваших категорій.
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 найрейтинговіших постів/сторінок.

Відображати Найрейтинговіші пости за певний період

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

• За замовчуванням: get_most_rated_range(‘1 day’, ‘both’, 10)
• Значення “1 день” буде тим діапазоном, який ви хочете. Ви можете використовувати “2 дні”, “1 місяць” тощо.
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 10 покаже лише 10 найрейтинговіших постів/сторінок.

Показати постів з Найбільшою кількістю балів

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

• За замовчуванням: get_highest_score(‘both’, 0, 10)
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 найрейтинговіших постів/сторінок.

Відобразити публікацію з Найбільшою кількістю балів у Категорії

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

• За замовчуванням: get_highest_score_category(CATEGORY_ID, ‘both’, 0, 10)
• Замініть CATEGORY_ID на ідентифікатор вашої категорії. Якщо ви хочете, щоб він охоплював кілька категорій, замініть CATEGORY_ID на array(1, 2), де 1 і 2 – це ідентифікатори ваших категорій.
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 0 означає мінімальну кількість голосів, необхідну для того, щоб публікація була показана.
• Значення 10 покаже лише 10 найрейтинговіших постів/сторінок.

Відображати пости з Найвищим рейтингом за певний період

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

• Типове значення: get_highest_score_range(‘1 day’, ‘both’, 10)
• Значення “1 день” буде тим діапазоном, який ви хочете. Ви можете використовувати “2 дні”, “1 місяць” тощо.
• Значення ‘both’ покаже, як найбільш рейтингові пости, так і сторінки.
• Якщо ви хочете показати лише найбільш рейтингові дописи, замініть ‘both’ на ‘post’.
• Якщо ви хочете показати лише найбільш рейтингові сторінки, замініть ‘both’ на ‘page’.
• Значення 10 покаже лише 10 найрейтинговіших постів/сторінок.

Щоб сортувати пости з Найвищим/Найнижчим Рейтингом

$query = new WP_Query( array(
    'meta_key' => 'ratings_average',
    'orderby'  => 'meta_value_num',
    'order'    => 'DESC',
) );

Або передайте змінні URL-адресі: http://yoursite.com/?r_sortby=highest_rated&r_orderby=desc

Replace desc with asc for the lowest rated posts.

Сортування дописів з Найбільшим/Найменшим Рейтингом

$query = new WP_Query( array(
    'meta_key' => 'ratings_users',
    'orderby'  => 'meta_value_num',
    'order'    => 'DESC',
) );

Або передайте змінні URL-адресі: http://yoursite.com/?r_sortby=most_rated&r_orderby=desc

Replace desc with asc for the least rated posts.

These examples use WP_Query rather than query_posts(), which the old ones called: query_posts() replaces the main query and WordPress has discouraged it for years. To sort the main query instead, use pre_get_posts.