説明
使い方
wp-content/themes/<YOUR THEME NAME>/index.php
を開きます- archive.php、single.php、post.php、page.php に配置することもできます。
- 検索する:
<?php while (have_posts()) : the_post(); ?>
- 次のコードを任意の箇所 (Ratings を表示したい箇所) 追加してください:
<?php if(function_exists('the_ratings')) { the_ratings(); } ?>
- すべての投稿 / ページに評価を表示したくない場合は、上記のコードを使用しないでください。代わりに、選択した投稿 / ページのコンテンツに
[ratings]
と入力するだけで、その投稿 / ページのみ評価が埋め込まれます。 - 他の投稿の評価を埋め込む場合は、
[ratings id="1"]
を使用します。1は表示したい投稿 / ページの評価の ID です。 - 他の投稿の評価結果を埋め込む場合は、
[ratings id="1" results="true"]
を使用します。1は表示したい投稿 / ページの評価結果の ID です。
開発
https://github.com/lesterchan/wp-postratings
クレジット
寄付
私のほとんどの自由時間をこちらのプラグインを作成、更新、維持、サポートすることに費やしました。もしプラグインを本当に気に入っていて、わずかな寄付をしていただけるなら本当に感謝します。もしそうでない場合も、お気になさらずそのままご利用ください。
スクリーンショット
FAQ
-
スキーマタイプを変更するには ?
-
<?php add_filter( 'wp_postratings_schema_itemtype', 'wp_postratings_schema_itemtype' ); function wp_postratings_schema_itemtype( $itemtype ) { return 'itemscope itemtype="http://schema.org/Recipe"'; } ?>
デフォルトのスキーマタイプは「Article」ですが、「Recipe」に変更したい場合は、上記のサンプルコードで示されているよう
wp_postratings_schema_itemtype
フィルターを使用する必要があります。 -
Google リッチ スニペットにサイトのロゴを追加する方法
-
<?php add_filter( 'wp_postratings_site_logo', 'wp_postratings_site_logo' ); function wp_postratings_site_logo( $url ) { return 'http://placehold.it/350/150.png'; } ?>
デフォルトでは、このプラグインはサイトのヘッダー画像のURLをサイトのロゴとして使用します。これを変更したい場合は、上記のサンプルコードで示されているように、
wp_postratings_site_logo
フィルターを使用する必要があります。 -
評価画像の alt とタイトルのテキストを削除するにはどうすればよいですか ?
-
<?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' );
デフォルトでは、コメント投稿者の評価は表示されません。評価を表示したい場合は、上記のサンプルコードで示されているように、
wp_postratings_display_comment_author_ratings
フィルターを使用する必要があります。 -
GIF 画像の代わりに PNG 画像を使用するにはどうすればよいですか ?
-
function custom_rating_image_extension() { return 'png'; } add_filter( 'wp_postratings_image_extension', 'custom_rating_image_extension' );
デフォルトの画像拡張子は「gif」ですが、「png」に変更したい場合は、上記のサンプルコードで示されているように、
wp_postratings_image_extension
フィルターを使用する必要があります。 -
function custom_rating_cookie_expiration() { return strtotime( 'tomorrow' ) ; } add_filter( 'wp_postratings_cookie_expiration', 'custom_rating_cookie_expiration', 10, 0 );
Cookie のデフォルト有効期限は「time() + 30000000」です。もし有効期限の長さを変更したい場合は、上記のサンプルコードで示されているように、
wp_postratings_cookie_expiration
フィルターを使用する必要があります。 -
WP-PostRatings はどのように CSS を読み込みますか ?
-
- WP-PostRatings は、テーマの CSS ディレクトリが存在する場合、
postratings-css.css
を読み込みます。 - 存在しない場合は、WP-PostRatings に付属するデフォルトの「postrateds-css.css」が読み込まれます。
- これにより、作成した評価スタイルを上書きすることを心配せずに WP-PostRatings をアップグレードできます。
- WP-PostRatings は、テーマの CSS ディレクトリが存在する場合、
-
ウィジェットで評価統計を使用するには ?
-
WP-Admin -> 外観 -> ウィジェット
に移動します- ウィジェット名は「Ratings」です。
-
最低評価の投稿を表示するには
-
<?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をご自分のタグ ID に置き換えてください。複数のカテゴリーにまたがる場合は、TAG_ID を array(1, 2) に置き換えてください。1と2はご自分のカテゴリー IDです。
- 「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 をご自分のカテゴリー ID に置き換えてください。複数のカテゴリーにまたがる場合は、CATEGORY_IDを array(1, 2) に置き換えてください。1と2はご自分のカテゴリー IDです。
- 「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をご自分のタグ ID に置き換えてください。複数のカテゴリーにまたがる場合は、TAG_ID を array(1, 2) に置き換えてください。1と2はご自分のカテゴリー IDです。
- 「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 をご自分のカテゴリー ID に置き換えてください。複数のカテゴリーにまたがる場合は、CATEGORY_IDを array(1, 2) に置き換えてください。1と2はご自分のカテゴリー IDです。
- 「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 day」は必要な範囲になります。「2 days」や「1 month」などを使用することができます。
- 「both」を使用すると、最も評価された投稿とページの両方が表示されます。
- 最も評価された投稿のみを表示したい場合は、「both」を「page」に置き換えてください。
- 最も評価されたページのみを表示したい場合は、「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」を「page」に置き換えてください。
- 最も評価されたページのみを表示したい場合は、「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 をご自分のカテゴリー ID に置き換えてください。複数のカテゴリーにまたがる場合は、CATEGORY_IDを array(1, 2) に置き換えてください。1と2はご自分のカテゴリー IDです。
- 「both」を使用すると、最も評価された投稿とページの両方が表示されます。
- 最も評価された投稿のみを表示したい場合は、「both」を「page」に置き換えてください。
- 最も評価されたページのみを表示したい場合は、「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 day」は必要な範囲になります。「2 days」や「1 month」などを使用することができます。
- 「both」を使用すると、最も評価された投稿とページの両方が表示されます。
- 最も評価された投稿のみを表示したい場合は、「both」を「page」に置き換えてください。
- 最も評価されたページのみを表示したい場合は、「both」を「page」に置き換えてください。
- 10 を指定すると、最も評価の高い上位10の投稿 / ページのみが表示されます。
-
最高スコアの投稿を表示するには
-
<?php if (function_exists('get_highest_score')): ?> <ul> <?php get_highest_score(); ?> </ul> <?php endif; ?>
- デフォルトt: get_highest_score(‘both’, 0, 10)
- 「both」を使用すると、最も評価された投稿とページの両方が表示されます。
- 最も評価された投稿のみを表示したい場合は、「both」を「page」に置き換えてください。
- 最も評価されたページのみを表示したい場合は、「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 をご自分のカテゴリー ID に置き換えてください。複数のカテゴリーにまたがる場合は、CATEGORY_IDを array(1, 2) に置き換えてください。1と2はご自分のカテゴリー IDです。
- 「both」を使用すると、最も評価された投稿とページの両方が表示されます。
- 最も評価された投稿のみを表示したい場合は、「both」を「page」に置き換えてください。
- 最も評価されたページのみを表示したい場合は、「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 day」は必要な範囲になります。「2 days」や「1 month」などを使用することができます。
- 「both」を使用すると、最も評価された投稿とページの両方が表示されます。
- 最も評価された投稿のみを表示したい場合は、「both」を「page」に置き換えてください。
- 最も評価されたページのみを表示したい場合は、「both」を「page」に置き換えてください。
- 10 を指定すると、最も評価の高い上位10の投稿 / ページのみが表示されます。
-
最高評価 / 最低評価の投稿を並べ替えるには
-
- 次を使用できます:
<?php query_posts( array( 'meta_key' => 'ratings_average', 'orderby' => 'meta_value_num', 'order' => 'DESC' ) ); ?>
- または、変数を URL に渡します:
http://yoursite.com/?r_sortby=highest_rated&r_orderby=desc
- 最低評価の投稿が必要な場合は、desc を asc に置き換えることができます。
- 次を使用できます:
-
最も評価の高い投稿 / 最も評価の低い投稿を並べ替えるには
-
- こちらをを使用できます:
<?php query_posts( array( 'meta_key' => 'ratings_users', 'orderby' => 'meta_value_num', 'order' => 'DESC' ) ); ?>
- または、変数を URL に渡します:
http://yoursite.com/?r_sortby=most_rated&r_orderby=desc
- 最も評価の低い投稿が必要な場合は、desc を asc に置き換えることができます。
- こちらをを使用できます:
評価
貢献者と開発者
変更履歴
Version 1.91.2
- FIXED: XSS in Google Rich Text Snippets
Version 1.91.1
- FIXED: Read from default REMOTE_ADDR unless specified in options
Version 1.91
- NEW: Supports specifying which header to read the user’s IP from
Version 1.90.1
- FIXED: Support mutex lock for multi-site.
Version 1.90
- FIXED: Use mutex lock to prevent race condition
Version 1.89.1
- FIXED: Change all http://schema.org to https://schema.org
Version 1.89
- NEW: Added
post_id
to second argument ofwp_postratings_expand_ratings_template
. - NEW Removed passed by reference for
get_post()
Version 1.88
- NEW: Added filter
wp_postratings_disable_richsnippet
to disable richsnippet on the fly. - NEW: Added a setting in
WP-Admin -> Ratings -> Rating Options
to disable the ratings component of the Rich Snippet. Props @8ctopus
Version 1.87
- FIXED: Rename filter
expand_ratings_template
towp_postratings_expand_ratings_template
for consistency. - FIXED: Remove wp_print_scripts
- FIXED: Added additional to Google Structured Data despite it is no longer working. Will consider removing it next time
- NEW: Added
wp_postratings_ipaddress
andwp_postratings_hostname
to allow user to overwrite it. - NEW: Add loading alt text filer
- NEW: Add wp_postratings_always_log filter to allow user to always log no matter what
Version 1.86.2
- FIXED: Wrong type check for inser_half which affects half rating image.
Version 1.86.1
- FIXED: Sanitize file name for images folder in WP-Admin
Version 1.86
- NEW: Hashed IP and Anonymize Hostname to make it GDPR compliance
- NEW: If Do Not Log is set in Rating Options, do not log to DB
Version 1.85
- NEW: wp_postratings_post_thumbnail filter
- FIXED: Take into consideration logging method when dealing with ratings in comments
- FIXED: Compressed Images
Version 1.84.1
- NEW: New wp_postratings_google_structured_data filter to filter Google Structured Data.
- FIXED: unnamed-file.numbers due to sanitize_file_name().
- FIXED: Generate the full path to image to prevent Googlebot from 404.
Version 1.84
- NEW: Added ‘%POST_THUMBNAIL%’ Template variable.
- NEW: Added ‘wp_postratings_cookie_expiration’ filter. Props @ramiy.
- NEW: Added ‘wp_postratings_ratings_image_alt’ filter
- NEW: Added more meta itemprops to pass Structured Data Testing Tool test
- NEW: Remove po/mo files from the plugin. Props @ramiy.
- NEW: Use translate.wordpress.org to translate the plugin. Props @ramiy.
- NEW: Add phpDocs and update file headers. Props @ramiy.
- NEW: Adds the ability to restrict voting rights to members of the blog. Props @stephenharris.
- FIXED: Use the new admin headings hierarchy with H1, H2, H3 tags. Props @ramiy.
- FIXED: Move *.js files to /js/ sub-folder. Props @ramiy.
- FIXED: Move *.css files to /css/ sub-folder. Props @ramiy.
- FIXED: Move the scripts to a separate file in /includes/ sub-folder. Props @ramiy.
- FIXED: Move the widget to a separate file in /includes/ sub-folder. Props @ramiy.
- FIXED: Move the shortcode to a separate file in /includes/ sub-folder. Props @ramiy.
- FIXED: Move activation hooks to a separate file in /includes/ sub-folder. Props @ramiy.
- FIXED: Move admin functions and hooks to a separate file in /includes/ sub-folder. Props @ramiy.
- FIXED: Move the i18n load to a separate file in /includes/ sub-folder. Props @ramiy.
- FIXED: Replace die() with wp_die() and add i18n to the strings. Props @ramiy.
- FIXED: Update translation strings to avoid using ‘post’ as the post type. Props @ramiy.
- FIXED: Minor translation string fix. Props @ramiy.
- FIXED: Update rating widget. Props @ramiy.
- FIXED: Security hardening. Props @stephenharris.
Version 1.83.2
- FIXED: Unauthenticated blind SQL injection in ratings_most_orderby(). Props @Ben Bidner from Automattic.
Version 1.83.1
- FIXED: Remove No Results template from the_ratings_results()
Version 1.83
- NEW: Added ‘wp_postratings_display_comment_author_ratings’ filter. Props @ramiy.
- FIXED: Removing Loading … because SERP will index the text if the ratings is at the top of the article
- FIXED: Move ‘wp_postratings_image_extension’ filter to init()
- FIXED: Show headline, datePublished and image despite there is no ratings
- FIXED: Show post without ratings as well when sorting is done in URL. Props @talljosh.
Version 1.82
- NEW: Added ‘wp_postratings_image_extension’ filter. Props @ramiy.
- FIXED: Added headline, datePublished, image to Article Schema type
- FIXED: Deprecated PHP4 constructor in WordPress 4.3
- FIXED: Remove schema code when Rich Snippets is off
Version 1.81
- NEW: Added worstRating of 1. Props @rafaellop
- NEW: Checked for defined() for RATINGS_IMG_EXT to allow overwrite
- FIXED: Integration with WP-Stats
Version 1.80
- NEW: Suppor Custom Post Types in Widgets
- NEW: Added ‘wp_postratings_process_ratings_user’, ‘wp_postratings_process_ratings_userid’ & ‘wp_postratings_check_rated’ filters
- NEW: Supports WordPress Multisite Network Activate
- NEW: Uses WordPress native uninstall.php
Version 1.79
- NEW: Use POST for ratings instead
- NEW: Add ‘wp_postratings_schema_itemtype’ filter so that you can change the Schema Type. See the FAQ for sample.
- FIXED: Use ‘is_rtl()’ instead of $text_direction
Version 1.78
- NEW: Uses Dash Icons
- NEW: Option to turn off Google Rich Snippets
- FIXED: Use SITECOOKIEPATH instead of COOKIEPATH. Props jbrule.
- FIXED: If global $id is 0, use get_the_ID(). Props instruite.
- FIXED: use esc_attr() and esc_js() to escape characters
Version 1.77
- NEW: Add in %POST_ID% template variables
- FIXED: Ensure Google Rich Snippet only displays in main loop and not in the widget
- FIXED: Removed reviewCount from Google Rich Snippet
- FIXED: Make the ratings widget more optimized
- FIXED: Some widget templates are using postratings_template_mostrated instead of postratings_template_highestrated
Version 1.76
- FIXED: No longer needing add_post_meta() if update_post_meta() fails
- FIXED: Update ‘Individual Rating Text/Value’ Display no working due to missing nonce
- FIXED: Added stripslashes() to remove slashes in the templates
- FIXED: Check whether it is an array to prevent array_key_exists() from throwing a warning.
Version 1.75
- Change htmlspecialchars to esc_attr(). Props Ryan Satterfield.
- Change esc_attr() to wp_kses() For itemprop. Props oneTarek.
Version 1.74
- check_rated_username() should be using $user_ID. Props Artem Gordinsky.
Version 1.73
- Add Stars Flat (PNG) Icons. Props hebaf.
- Change Schema From http://schema.org/Product To http://schema.org/Article