-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
503 lines (441 loc) · 24.5 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
WP-PostRatings
==============
fork of http://wordpress.org/extend/plugins/wp-postratings/ for Varnish features
Requires WP-Varinsh https://github.com/pkhamre/wp-varnish
Contributors: GamerZ, broderboy
Donate link: http://lesterchan.net/site/donation/
Tags: ratings, rating, postratings, postrating, vote, digg, ajax, post
Requires at least: 2.8
Tested up to: 3.5.0
Stable tag: trunk
Adds an AJAX rating system for your WordPress blog's post/page.
== Description ==
= Previous Versions =
* [WP-PostRatings 1.40 For WordPress 2.7.x](http://downloads.wordpress.org/plugin/wp-postratings.1.40.zip "WP-PostRatings 1.40 For WordPress 2.7.x")
* [WP-PostRatings 1.31 For WordPress 2.5.x And 2.6.x](http://downloads.wordpress.org/plugin/wp-postratings.1.31.zip "WP-PostRatings 1.31 For WordPress 2.5.x And 2.6.x")
* [WP-PostRatings 1.20 For WordPress 2.3.x](http://downloads.wordpress.org/plugin/wp-postratings.1.20.zip "WP-PostRatings 1.20 For WordPress 2.3.x")</a>
* [WP-PostRatings 1.11 For WordPress 2.1.x And 2.2.x](http://downloads.wordpress.org/plugin/wp-postratings.1.11.zip "WP-PostRatings 1.11 For WordPress 2.1.x And 2.2.x")
* [WP-PostRatings 1.05 For WordPress 2.0.x](http://downloads.wordpress.org/plugin/wp-postratings.1.05.zip "WP-PostRatings 1.05 For WordPress 2.0.x")
* [WP-PostRatings 1.03 For WordPress 1.5.2](http://downloads.wordpress.org/plugin/wp-postratings.1.03wp1.52.zip "WP-PostRatings 1.03 For WordPress 1.5.2")
= Development =
* [http://dev.wp-plugins.org/browser/wp-postratings/](http://dev.wp-plugins.org/browser/wp-postratings/ "http://dev.wp-plugins.org/browser/wp-postratings/")
= Translations =
* [http://dev.wp-plugins.org/browser/wp-postratings/i18n/](http://dev.wp-plugins.org/browser/wp-postratings/i18n/ "http://dev.wp-plugins.org/browser/wp-postratings/i18n/")
= Support Forums =
* [http://forums.lesterchan.net/index.php?board=17.0](http://forums.lesterchan.net/index.php?board=17.0 "http://forums.lesterchan.net/index.php?board=17.0")
= Credits =
* Icons courtesy of [FamFamFam](http://www.famfamfam.com/ "FamFamFam") and [Everaldo](http://www.everaldo.com "Everaldo")
* __ngetext() by [Anna Ozeritskaya](http://hweia.ru/ "Anna Ozeritskaya")
* Right To Left Language Support by [Kambiz R. Khojasteh](http://persian-programming.com/ "Kambiz R. Khojasteh")
= Donations =
* 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 appericiate it. If not feel free to use it without any obligations.
== Changelog ==
== Changelog ==
= Version 1.64 (17-12-2012) =
* Add "Ratings" Column To Manage Pages In WP-Admin
* Add Sortable "Ratings" Column To Manage Posts/Pages In WP-Admin
= Version 1.63 (21-05-2012) =
* NEW: Move AJAX Request to wp-admin/admin-ajax.php
* NEW: Added nonce To AJAX Calls And Admin Pages
* NEW: Added Support For Google Rich Snippet
= Version 1.62 (31-09-2011) =
* FIXED: Escaped Hostname
* FIXED: Ensure Ratings Post ID In Shortcode Is An Integer
= Version 1.61 (17-02-2011) =
* FIXED: XSS Vulnerability. Thanks Dion Hulse aka dd32
* FIXED: Removed Global $post
= Version 1.50 (15-06-2009) =
* NEW: Works For WordPress 2.8 Only
* NEW: Javascript Now Placed At The Footer
* NEW: Uses jQuery Instead Of tw-sack
* NEW: Minified Javascript Instead Of Packed Javascript
* NEW: Renamed postratings-admin-js-packed.js To postratings-admin-js.js
* NEW: Renamed postratings-admin-js.js To postratings-admin-js.dev.js
* NEW: Renamed postratings-js-packed.js To postratings-js.js
* NEW: Renamed postratings-js.js To postratings-js.dev.js
* NEW: Translate Javascript Variables Using wp_localize_script()
* NEW: Added In Most Rated & Highest Rated Pages To WP-Stats
* NEW: Added get_highest_score(), get_highest_score_category(), get_highest_score_range(), get_highest_score_range_category()
* NEW: Use _n() Instead Of __ngettext() And _n_noop() Instead Of __ngettext_noop()
* NEW: Uses New Widget Class From WordPress
* NEW: Merge Widget Code To wp-postratings.php And Remove wp-postratings-widget.php
* NEW: get_highest_rated_tag() And get_lowest_rated_tag()
* FIXED: Uses $_SERVER['PHP_SELF'] With plugin_basename(__FILE__) Instead Of Just $_SERVER['REQUEST_URI']
* FIXED: Ensure That Post Is Not A Revision
* FIXED: Missing + Sign For Thumbs Up/Down Ratings If Score Is Positive
* FIXED: Logged By Username Now Shows Ratings Results To Users Who Did Not Login
* FIXED: Multiple Loops Filtered Not Cleared
= Version 1.40 (12-12-2008) =
* NEW: Works For WordPress 2.7 Only
* NEW: Load Admin JS And CSS Only In WP-PostRatings Admin Pages
* NEW: Added postratings-admin-css.css For WP-PostRatings Admin CSS Styles
* NEW: Allow The Usage Of PNG Icons Or GIF Icons. See Usage Tab.*
* NEW: Added get_lowest_rated_range() Function
* NEW: Right To Left Language Support by <a href="http://persian-programming.com/" title="http://persian-programming.com/">Kambiz R. Khojasteh</a>
* NEW: Added "postratings-css-rtl.css" by <a href="http://persian-programming.com/" title="http://persian-programming.com/">Kambiz R. Khojasteh</a>
* NEW: Added 3 Functions For Creating HTML Code Of Rating Images by <a href="http://persian-programming.com/" title="http://persian-programming.com/">Kambiz R. Khojasteh</a>
* NEW: Call postratings_textdomain() In create_ratinglogs_table() and process_ratings() by <a href="http://persian-programming.com/" title="http://persian-programming.com/">Kambiz R. Khojasteh</a>
* NEW: Replaced Template Variable Calculations With expand_ratings_template() by <a href="http://persian-programming.com/" title="http://persian-programming.com/">Kambiz R. Khojasteh</a>
* NEW: Added Filter expand_ratings_template For Localizing Digits by <a href="http://persian-programming.com/" title="http://persian-programming.com/">Kambiz R. Khojasteh</a>
* NEW: Uses wp_register_style(), wp_print_styles(), plugins_url() And site_url()
* FIXED: SSL Support
= Version 1.31 (16-07-2008) =
* NEW: Works For WordPress 2.6
* NEW: Renamed GET Variables sortby To r_sortby And orderby To r_orderby
* NEW: Renamed postratings-admin-js.php To postratings-admin-js.js and Move The Dynamic Javascript Variables To The PHP Pages
* NEW: Renamed postratings-js.php To postratings-js.js and Move The Dynamic Javascript Variables To The PHP Pages
* NEW: Uses postratings-js-packed.js And postratings-admin-js-packed.js
* NEW: When Displaying The Ratings Given By Comment Author, It Check Against Cookie As Well As IP
* NEW: Better Translation Using __ngetext() by <a href="http://hweia.ru/" title="http://hweia.ru/">Anna Ozeritskaya</a>
* FIXED: MYSQL Charset Issue Should Be Solved
* FIXED: Removed WP-Cache Compatibility As It Is Not Tested
* FIXED: Able To Use r_sortby And r_orderby in query_posts()
= Version 1.30 (01-06-2008) =
* NEW: Works For WordPress 2.5 Only
* NEW: Removed 'postratings-usage.php'
* NEW: Uses ShortCode API
* NEW: Splitted Templates From PostRating Options Into Its Own File, 'postratings-templates.php'
* NEW: Able To Display The Ratings Given By Comment Author When Displaying Comments
* NEW: WP-PostRatings Will Load 'postratings-css.css' Inside Your Theme Directory If It Exists. If Not, It Will Just Load The Default 'postratings-css.css' By WP-PostRatings
* NEW: Use number_format_i18n() Instead Of number_format()
* NEW: Added Get Most/Highest Rated Post Within A Given Time Range Function
* NEW: Added Get Most/Highest Rated Post By Category ID Within A Given Time Range Function
* NEW: Added get_lowest_rated() Function
* NEW: Added get_lowest_rated_category() Function
* NEW: Added get_most_rated_category() Function
* NEW: Get Most Rated Is Now Under The Templates
* NEW: Minimum Votes Options/Parameters Added To get_lowest_rated(), get_lowest_rated_category(), get_highest_rated(), get_highest_rated_category(), get_most_rated() and get_most_rated_category() Functions
* NEW: Uses /wp-postratings/ Folder Instead Of /postratings/
* NEW: Uses wp-postratings.php Instead Of postratings.php
* NEW: Move WP-PostRatings Stats Out Of postratings.php Into postrating-stats.php
* FIXED: Thumbs Up/Down Post Should Get Sorted By Score Instead Of Average
* FIXED: Increased The Length Of The Input Box For Individual Rating Value
* FIXED: Manage Ratings Does Not Display "Numbers" Style Rating
* FIXED: %POST_EXCERPT% Variable Is Sometimes Empty
= Version 1.20 (01-10-2007) =
* NEW: Works For WordPress 2.3 Only
* NEW: Ability To Embed [ratings=1] Into Post/Excerpt, Where 1 Is The ID Of The Post/Page Ratings You Want To Display
* NEW: Ability To Embed [ratings_results=1] Into Post/Excerpt, Where 1 Is The ID Of The Post/Page Ratings Results You Want To Display
* NEW: Ability To Support Mutiple Categories For get_highest_rated_category(). By: <a href="http://pomoti.com">Dirceu P. Junior</a>
* NEW: Ability To Embed [ratings] Into Excerpt
* NEW: Added Template For No Permission To Rate
* NEW: Ability To Filter Logs By Post ID, User and Rating
* NEW: Added heart, heart_crystal, plusminus, plusminus_crystal, stars_crystal, thumbs, tickcross, tickcross_crystal and updown_crystal Rating Styles
* NEW: Supports Up/Down Or Thumbs Up/Thumbs Down Rating
* NEW: Supports Custom Image For Individual Rating Scale
* NEW: WP-Cache Compatible By <a href="http://forums.lesterchan.net/index.php/topic,227.0.html">Nir Aides</a>
* NEW: Highest Rated Widge And Most Rated Widget Added
* NEW: Ability To Uninstall WP-PostRatings
* NEW: Uses WP-Stats Filter To Add Stats Into WP-Stats Page
* FIXED: Some Translation Bug In postrating-usage.php
= Version 1.11 (01-06-2007) =
* NEW: Ratings Custom Fields Will Automatically Be Created With The Creation Of Each New Post/Page
* NEW: Added AJAX Style Option: "Show Loading Image With Text"
* NEW: Added AJAX Style Option: "Show Fading In And Fading Out Of Ratings"
* NEW: Removed Ratings From Feed If Ratings Is Embedded Into The Post Using [ratings]
* FIXED: Wrong URL For Page Under Top Rated/Highest Posts Listing
* FIXED: Next/Previous Paging Bug In WP-Admin -> Manage Ratings
* FIXED: Sort Most Rated Posts By Number Of Voters Followed By Post Average Ratings
= Version 1.10 (01-02-2007) =
* NEW: Works For WordPress 2.1 Only
* NEW: Renamed postratings-js.js To postratings-js.php To Enable PHP Parsing
* NEW: Added Function To Get Highest Rated Post By Category ID
= Version 1.05 (02-01-2007) =
* NEW: Added The Ability For Each Rating Star To Have Its Own Text
* NEW: Highest Rated Post Is Now In The Templates For Easy Modification
* NEW: Usage Instructions Is Also Included Within The Plugin Itself
* NEW: Able To Delete Ratings Logs And Data By Post IDs
* NEW: Able To Uninstall WP-PostRatings
* NEW: Localization WP-PostRatings
* FIXED: snippet_text() Function Missing
* FIXED: AJAX Not Working On Servers Running On PHP CGI
* FIXED: Highest Rated Post Is Now Based On The Ratings Followed By The Number Of Votes
* FIXED: Added Some Default Styles To postratings-css.css To Ensure That WP-PostRatings Does Not Break
= Version 1.04 (01-10-2006) =
* NEW: Ability To Logged By UserName
* NEW: get_highest_rated_sidebar(); To Display The Highest Rated Post On The Sidebar
* NEW: Added CSS Class 'post-ratings-image' To All IMG Tags
* FIXED: If Site URL Doesn't Match WP Option's Site URL, WP-PostRatings Will Not Work
= Version 1.03 (01-07-2006) =
* NEW: Total Rating Votes Stats And Total Rating Users Stats Function Added
* FIXED: Ratings Not Working On Physical Pages That Is Integrated Into WordPress
* FIXED: Modified Get Most/Highest Rated Post Function
* FIXED: Search Bots Unable To Index Site
= Version 1.02a (07-06-2006) =
* FIXED: AJAX Not Working In Opera Browser
= Version 1.02 (01-06-2006) =
* NEW: Fading In/Put Effect After You Rate A Post
* NEW: Rating Voting And Rating Results Are On The Same Image
* NEW: Added Rating Option For Logging Method
* NEW: Added Rating Option For Who Can Rate
* NEW: Added Rating Results Image To Get Highest Rated Stats
* NEW: Rating Administration Panel And The Code That WP-PostRatings Generated Is XHTML 1.0 Transitional
= Version 1.01 (01-04-2006) =
* NEW: AJAX Voting
* FIXED: Block Search Bots From Voting
* FIXED: Hard Coded Table Name In Ratings Stats
= Version 1.00 (01-03-2006) =
* NEW: Initial Release
== Installation ==
1. Open `wp-content/plugins` Folder
2. Put: `Folder: wp-PostRatings`
3. Activate `WP-PostRatings` Plugin
4. Go to `WP-Admin -> Ratings`
= Usage =
1. Open `wp-content/themes/<YOUR THEME NAME>/index.php`
2. You may place it in archive.php, single.php, post.php or page.php also.
3. Find: `<?php while (have_posts()) : the_post(); ?>`
4. Add Anywhere Below It (The Place You Want The Ratings To Show): `<?php if(function_exists('the_ratings')) { the_ratings(); } ?>`
* If you DO NOT want the ratings to appear in every post/page, DO NOT use the code above. Just type in `[ratings]` into the selected post/page content and it will embed ratings into that post/page only.
* If you want to embed other post ratings use `[ratings id="1"]`, where 1 is the ID of the post/page ratings that you want to display.
* If you want to embed other post ratings results, use `[ratings id="1" results="true"]`, where 1 is the ID of the post/page ratings results that you want to display.
== Upgrading ==
1. Deactivate `WP-PostRatings` Plugin
2. Open `wp-content/plugins` Folder
3. Put/Overwrite: `Folder: wp-postratings`
4. Activate `WP-PostRatings` Plugin
5. Go to `WP-Admin -> Ratings -> Ratings Templates` and restore all the template variables to `Default`
6. Go to `WP-Admin -> Appearance -> Widgets` and re-add the Ratings Widget
== Upgrade Notice ==
N/A
== Screenshots ==
1. Admin - Ratings Log Bottom
2. Admin - Ratings Log Top
3. Admin - Ratings Options
4. Admin - Ratings Templates
5. Ratings
6. Ratings Hover
== Frequently Asked Questions ==
= How To Display Comment Author Ratings? =
1. Open `wp-content/plugins/wp-postratings/wp-postratings.php`
2. Find: `//add_filter('comment_text', 'comment_author_ratings_filter');`
3. Replace: `add_filter('comment_text', 'comment_author_ratings_filter');`
= How To use PNG images instead of GIF images =
1. Open `wp-content/plugins/wp-postratings/wp-postratings.php`
2. Find:
<code>
define('RATINGS_IMG_EXT', 'gif');
//define('RATINGS_IMG_EXT', 'png');
</code>
3. Replace:
<code>
//define('RATINGS_IMG_EXT', 'gif');
define('RATINGS_IMG_EXT', 'png');
</code>
= How Does WP-PostRatings Load CSS? =
* WP-PostRatings will load `postratings-css.css` from your theme's 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.
= How To Use Ratings Stats With Widgets? =
1. Go to `WP-Admin -> Appearance -> Widgets`
2. The widget name is Ratings.
= How To Use Ratings Stats Outside WP Loop? =
= To Display Lowest Rated Post =
* Use:
<code>
<?php if (function_exists('get_lowest_rated')): ?>
<ul>
<?php get_lowest_rated(); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Lowest Rated Post By Tag =
* Use:
<code>
<?php if (function_exists('get_lowest_rated_tag')): ?>
<ul>
<?php get_lowest_rated_tag(TAG_ID); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Lowest Rated Post In A Category =
* Use:
<code>
<?php if (function_exists('get_lowest_rated_category')): ?>
<ul>
<?php get_lowest_rated_category(CATEGORY_ID); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Highest Rated Post =
* Use:
<code>
<?php if (function_exists('get_highest_rated')): ?>
<ul>
<?php get_highest_rated(); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Highest Rated Post By Tag =
* Use:
<code>
<?php if (function_exists('get_highest_rated_tag')): ?>
<ul>
<?php get_highest_rated_tag(TAG_ID); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Highest Rated Post In A Category =
* Use:
<code>
<?php if (function_exists('get_highest_rated_category')): ?>
<ul>
<?php get_highest_rated_category(CATEGORY_ID); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Highest Rated Post Within A Given Period =
* Use:
<code>
<?php if (function_exists('get_highest_rated_range')): ?>
<ul>
<?php get_highest_rated_range('1 day'); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Most Rated Post =
* Use:
<code>
<?php if (function_exists('get_most_rated')): ?>
<ul>
<?php get_most_rated(); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Most Rated Post In A Category =
* Use:
<code>
<?php if (function_exists('get_most_rated_category')): ?>
<ul>
<?php get_most_rated_category(CATEGORY_ID); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Most Rated Post Within A Given Period =
* Use:
<code>
<?php if (function_exists('get_most_rated_range')): ?>
<ul>
<?php get_most_rated_range('1 day'); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Highest Score Post =
* Use:
<code>
<?php if (function_exists('get_highest_score')): ?>
<ul>
<?php get_highest_score(); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Highest Score Post In A Category =
* Use:
<code>
<?php if (function_exists('get_highest_score_category')): ?>
<ul>
<?php get_highest_score_category(CATEGORY_ID); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Display Highest Score Post Within A Given Period =
* Use:
<code>
<?php if (function_exists('get_highest_score_range')): ?>
<ul>
<?php get_highest_score_range('1 day'); ?>
</ul>
<?php endif; ?>
</code>
* 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.
= To Sort Highest/Lowest Rated Posts =
* You can use: `<?php query_posts($query_string.'&r_sortby=highest_rated&r_orderby=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.
= To Sort Most/Least Rated Posts =
* You can use: `<?php query_posts($query_string.'&r_sortby=most_rated&r_orderby=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.