WP-PostRatings

Nejčastější dotazy

Jak mohu změnit barvu hodnocení?

Přejděte na WP-Admin -> Hodnocení -> Nastavení a podívejte se do sekce Text a hodnota jednotlivých hodnocení. Každý stupeň na stupnici má vlastní dvojici barevných vzorků ve sloupcích Ohodnoceno a Nehodnoceno, k čemuž sloužily staré sady obrázků stars_crystal a stars_dark.

Při najetí myší se zobrazí barva hodnocení. Pokud byste raději odlišili stav „chystám se vybrat“ od stavu „již zaznamenáno“, nastavte ve svém šabloně --wp-postratings-color-hover.

Jak mohu změnit velikost, mezery nebo barvu při najetí myší?

Vše, co přesahuje tyto dvě barvy, představuje vlastní vlastnost CSS na stránce .wp-postratings, takže ve vašem šabloně stačí pouze toto:

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

Před verzí 2.0.0 znamenala odlišná barva celou samostatnou složku obrázků, a proto plugin dodával stars, stars_crystal a stars_dark samostatně. Nyní mají všechny stejný tvar.

Jak mohu použít vlastní tvar hodnocení?

Zaregistrujte jej pomocí filtru wp_postratings_shapes. Poté se zobrazí na obrazovce „Možnosti hodnocení“ stejně jako jakýkoli vestavěný tvar a na rozdíl od starého postupu, kdy se složka vkládala do adresáře wp-content/plugins/wp-postratings/images/, zůstane zachován i po aktualizaci.

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

    return $shapes;
} );

Cesta představuje data cesty ve formátu SVG vykreslená v rámečku o rozměrech 24×24. Pro ovládací prvek typu „nahoru/dolů“ použijte 'type' => 'updown' a místo 'path' zadejte cesty 'up' a 'down'.

Každý návštěvník může hodnotit opakovaně, nebo každý záznam v protokolu hodnocení vykazuje stejnou IP adresu

Jedná se o pole Záhlaví obsahující IP adresu na obrazovce Možnosti hodnocení.

Nechte toto pole prázdné, pokud váš web skutečně není za reverzním proxy serverem nebo službou CDN, jako je například Cloudflare. Prázdné pole znamená, že plugin použije adresu, kterou váš webový server skutečně zaznamenal, což je u běžného hostingu žádoucí.

Pokud používáte proxy, uveďte přesný název hlavičky, kterou váš proxy nastavuje, například HTTP_CF_CONNECTING_IP v případě Cloudflare nebo HTTP_X_FORWARDED_FOR u většiny vyvažovačů zátěže. Je dobré vědět dvě věci:

• Návštěvník může odeslat libovolnou hlavičku. Pokud pojmenujete hlavičku tak, že ji váš vlastní systém nenastavuje ani nepřepíše, může do ní kdokoli vložit, co chce, a hodnotit tolikrát, kolikrát se mu zlíbí.
• X-Forwarded-For je seznam: klient, proxy1, proxy2. Od verze 2.0.0 plugin načítá první platnou adresu z tohoto seznamu, místo aby ukládal celý řetězec. Před verzí 2.0.0 ukládal celý řetězec, což znamenalo, že návštěvník mohl připojit ještě jednu adresu a při každém požadavku se tak jevit jako někdo nový.

Vzhledem k tomu, že se formát uloženého údaje změnil, záznamy o hodnocení zaznamenané prostřednictvím takového záhlaví před verzí 2.0.0 již nebudou odpovídat a někteří návštěvníci budou moci hodnocení provést ještě jednou. Záznamy zaznamenané bez nastavení tohoto pole tím nejsou dotčeny.

Jak změnit typ schématu?

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

Výchozí typ schématu je „Article“. Pokud jej chcete změnit na „Recipe“, musíte použít filtr wp_postratings_schema_itemtype, jak je uvedeno v ukázkovém kódu výše.

Jak přidat logo svého webu pro rozšířené výňatky Google

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

Ve výchozím nastavení plugin použije jako logo vašeho webu adresu obrázku v záhlaví webu. Pokud jej chcete změnit, musíte využít filtr wp_postratings_site_logo, jak je uvedeno v ukázkovém kódu výše.

Jak změnit text, který čte čtečka obrazovky?

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

Toto je popis, který čte čtečka obrazovky u zobrazeného hodnocení, například „4 hlasy, průměr: 3,70 z 5“. Od verze 2.0.0 se hodnocení vykresluje pomocí CSS namísto obrázků, takže se zde nepoužívají atributy alt ani title; hodnotou se stává atribut aria-label u hodnocení.

Vrácení prázdného řetězce vede k odstranění hodnocení, k čemuž se tento filtr obvykle používal. Mějte na paměti, že tím hodnocení zůstane zcela bez přístupného názvu, takže uživatelé čteček obrazovky o něm nedostanou žádnou informaci. Upřednostněte přeformulování před odstraněním.

Jak zobrazit hodnocení autorů komentářů?

add_filter( 'wp_postratings_display_comment_author_ratings', '__return_true' );

Ve výchozím nastavení se hodnocení autorů komentářů nezobrazují. Pokud chcete tato hodnocení zobrazit, musíte použít filtr wp_postratings_display_comment_author_ratings, jak je uvedeno v ukázkovém kódu výše.

Jak změnit dobu platnosti souborů cookie?

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

Výchozí doba platnosti souboru cookie je „time() + 30000000“. Pokud chcete změnit délku platnosti, musíte použít filtr wp_postratings_cookie_expiration, jak je uvedeno v ukázkovém kódu výše.

Jak plugin WP-PostRatings načítá CSS?

Většina úprav vzhledu již vůbec nevyžaduje žádný soubor CSS: barvy se nastavují v konfiguraci a velikost, mezery i barva při najetí myší jsou vlastní vlastnosti. Nejprve si přečtěte obě výše uvedené otázky.

Pokud chcete stylový list nahradit celý, WP-PostRatings načte soubor wp-postratings.css z adresáře vašeho šablony (nebo z jeho podadresáře css/), pokud tento soubor existuje; v opačném případě načte svou vlastní kopii, takže aktualizace vaše styly nepřepíše.

Všimněte si, že se ve verzi 2.0.0 změnil název souboru: dříve to bylo postratings-css.css. Šablona, která stále používá starý název, bude jednoduše ignorována a místo ní se načte vlastní stylový list pluginu. Neexistuje již ani samostatný stylový list pro RTL, protože pravidla využívají logické vlastnosti.

Jak používat statistiky hodnocení s widgety?

1. Přejděte na WP-Admin -> Vzhled -> Widgety
2. Název widgetu je „Hodnocení“.

Zobrazit příspěvek s nejnižším hodnocením

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

• Výchozí nastavení: get_lowest_rated(‚both‘, 0, 10)
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejnižším hodnocením.
• Pokud chcete zobrazit pouze příspěvky s nejnižším hodnocením, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejnižším hodnocením, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 příspěvků/stránek s nejnižším hodnocením.

Zobrazení příspěvku s nejnižším hodnocením podle štítku

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

• Výchozí nastavení: get_lowest_rated_tag(TAG_ID, ‚both‘, 0, 10)
• Nahraďte TAG_ID ID svého tagu. Pokud chcete, aby se tag vztahoval na více kategorií, nahraďte TAG_ID hodnotou array(1, 2), kde 1 a 2 jsou ID vašich kategorií.
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejnižším hodnocením.
• Pokud chcete zobrazit pouze příspěvky s nejnižším hodnocením, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejnižším hodnocením, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 příspěvků/stránek s nejnižším hodnocením.

Zobrazení příspěvku s nejnižším hodnocením v dané kategorii

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

• Výchozí nastavení: get_lowest_rated_category(CATEGORY_ID, ‚both‘, 0, 10)
• Nahraďte CATEGORY_ID ID vaší kategorie. Pokud chcete, aby se to vztahovalo na více kategorií, nahraďte CATEGORY_ID hodnotou array(1, 2), kde 1 a 2 jsou ID vašich kategorií.
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejnižším hodnocením.
• Pokud chcete zobrazit pouze příspěvky s nejnižším hodnocením, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejnižším hodnocením, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 příspěvků/stránek s nejnižším hodnocením.

Zobrazit příspěvek s nejvyšším hodnocením

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

• Výchozí nastavení: get_highest_rated(‚both‘, 0, 10)
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším hodnocením.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším hodnocením, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším hodnocením, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Zobrazení příspěvku s nejvyšším hodnocením podle štítku

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

• Výchozí nastavení: get_highest_rated_tag(TAG_ID, ‚both‘, 0, 10)
• Nahraďte TAG_ID ID svého tagu. Pokud chcete, aby se tag vztahoval na více kategorií, nahraďte TAG_ID hodnotou array(1, 2), kde 1 a 2 jsou ID vašich kategorií.
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším hodnocením.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším hodnocením, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším hodnocením, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Zobrazení příspěvku s nejvyšším hodnocením v dané kategorii

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

• Výchozí nastavení: get_highest_rated_category(CATEGORY_ID, ‚both‘, 0, 10)
• Nahraďte CATEGORY_ID ID vaší kategorie. Pokud chcete, aby se to vztahovalo na více kategorií, nahraďte CATEGORY_ID hodnotou array(1, 2), kde 1 a 2 jsou ID vašich kategorií.
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším hodnocením.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším hodnocením, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším hodnocením, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Zobrazení příspěvku s nejvyšším hodnocením za dané období

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

• Výchozí nastavení: get_highest_rated_range(‚1 den‘, ‚oba‘, 10)
• Hodnota „1 den“ bude odpovídat požadovanému časovému rozmezí. Můžete použít „2 dny“, „1 měsíc“ atd.
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším počtem hodnocení.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „page“.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Zobrazení nejlépe hodnoceného příspěvku

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

• Výchozí nastavení: get_most_rated(‚both‘, 0, 10)
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším počtem hodnocení.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Zobrazení nejlépe hodnoceného příspěvku v dané kategorii

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

• Výchozí nastavení: get_most_rated_category(CATEGORY_ID, ‚both‘, 0, 10)
• Nahraďte CATEGORY_ID ID vaší kategorie. Pokud chcete, aby se to vztahovalo na více kategorií, nahraďte CATEGORY_ID hodnotou array(1, 2), kde 1 a 2 jsou ID vašich kategorií.
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším počtem hodnocení.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Zobrazení nejlépe hodnoceného příspěvku za dané období

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

• Výchozí nastavení: get_most_rated_range(‚1 den‘, ‚oba‘, 10)
• Hodnota „1 den“ bude odpovídat požadovanému časovému rozmezí. Můžete použít „2 dny“, „1 měsíc“ atd.
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším počtem hodnocení.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „page“.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Zobrazit příspěvek s nejvyšším skóre

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

• Výchozí nastavení: get_highest_score(‚both‘, 0, 10)
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším počtem hodnocení.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Zobrazení příspěvku s nejvyšším skóre v dané kategorii

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

• Výchozí nastavení: get_highest_score_category(CATEGORY_ID, ‚both‘, 0, 10)
• Nahraďte CATEGORY_ID ID vaší kategorie. Pokud chcete, aby se to vztahovalo na více kategorií, nahraďte CATEGORY_ID hodnotou array(1, 2), kde 1 a 2 jsou ID vašich kategorií.
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším počtem hodnocení.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „page“.
• Hodnota 0 označuje minimální počet hlasů, který je nutný k tomu, aby se příspěvek zobrazil.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Zobrazení příspěvku s nejvyšším počtem bodů za dané období

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

• Výchozí nastavení: get_highest_score_range(‚1 den‘, ‚oba‘, 10)
• Hodnota „1 den“ bude odpovídat požadovanému časovému rozmezí. Můžete použít „2 dny“, „1 měsíc“ atd.
• Při zadání hodnoty „both“ se zobrazí jak příspěvky, tak stránky s nejvyšším počtem hodnocení.
• Pokud chcete zobrazit pouze příspěvky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „post“.
• Pokud chcete zobrazit pouze stránky s nejvyšším počtem hodnocení, nahraďte „both“ slovem „page“.
• Hodnota 10 zobrazí pouze 10 nejlépe hodnocených příspěvků/stránek.

Seřadit příspěvky s nejvyšším/nejnižším hodnocením

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

Nebo zadejte proměnné přímo do adresy URL: https://yoursite.com/?r_sortby=highest_rated&r_orderby=desc

Chcete-li zobrazit příspěvky s nejnižším hodnocením, nahraďte desc za asc.

Seřadit příspěvky s nejvyšším/nejnižším počtem hodnocení

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

Nebo zadejte proměnné přímo do adresy URL: https://yoursite.com/?r_sortby=most_rated&r_orderby=desc

Chcete-li zobrazit příspěvky s nejnižším hodnocením, nahraďte desc za asc.

V těchto příkladech se používá WP_Query namísto query_posts(), které se používalo v dřívějších příkladech: query_posts() nahrazuje hlavní dotaz a WordPress jeho používání již řadu let nedoporučuje. Chcete-li místo toho seřadit hlavní dotaz, použijte pre_get_posts.