Descrição
I needed a simple and light plugin to add Thumbs Rating, I couldn’t find any so I built my own.
This plugin allows you to add a thumb up/down rating to your content (posts, pages, and custom post types). You can set it up to show anywhere you want, check out the Installation instructions.
The output is very basic, no images, no fonts, no fancy CSS. Customize the ouput overriding the CSS classes in your style.css file.
Recursos
- No output printed by default, check the Installation instructions.
- Stores the votes values for each content in the current post table (no new database tables are created).
- Uses HTML5 LocalStorage to prevent the users from voting twice.
- Easy to customize the output using CSS.
- Show the most voted (positive/negative) items using shortcodes.
- Show the buttons using shortcodes.
- No jQuery dependency.
Internet Explorer 11 support
If you want the plugin to work with IE11 users, you need jQuery. For that use the 3.4.2 version of the plugin.
From 4.0.0 onwards the plugin has no dependencies and uses vanilla JavaScript (ES6 syntax). Which will cause it not to work for IE11 users.
Línguas
- Arabic: ar (by iFlendra)
- Catalan: ca
- Chinese (China): zh_CN (by suifengtec)
- Czech: cs_CZ (by togur)
- Danish dk_DK (by BJARNE)
- Dutch nl_NL (by Thijs)
- Ingês
- French: fr_FR (by Arnaud)
- German: de_DE (by webserviceXXL)
- Italian: it_IT (by marcochiesi)
- Japanese: ja (by heySister721)
- Lithuanian: lt_LT (by Andrius)
- Persian: fa_IR (by Hamed.T)
- Portuguese: pt_BR (by Felipe)
- Polish: pl_PL (by Fafu)
- Romanian: ro_RO by (by AlexCruz1989)
- Russian: ru_RU (by anatolt)
- Serbian: sr_RS (by Andrijana Nikolic)
- Spanish: es_ES
- Turkish: tr_TR (by CrimsonIdol)
Give me a hand and translate the plugin in your language, it’s just a few words.
Solicitações
Feel free to post a request but let’s keep it simple and light.
Ping me
Are you using the plugin? Do you like it? Do you hate it? Let me know!
- Mastodon: @ricard@ricard.social
- Blog: Ricard Torres Code
Ecrãs
Basic output with the default CSS with the TwentyThirteen theme. 
This text is shown if you try to vote again.
Instalação
First of all activate the Plugin, then:
A) Add the shortcode to the posts or pages you want the Thumb Rating buttons to appear:
[thumbs-rating-buttons]
B) If you want to show the thumbs after all your content (posts, pages, custom post types) paste this snippet at the end of your functions.php file of your theme:
function thumbs_rating_print($content)
{
return $content.thumbs_rating_getlink();
}
add_filter('the_content', 'thumbs_rating_print');
C) Alternatively you can print the buttons only in certain parts of your theme. Paste the following snippet wherever you want them to show:
<?=function_exists('thumbs_rating_getlink') ? thumbs_rating_getlink() : ''?>
Perguntas frequentes
-
You must specify where do you want to show the thumbs within your theme, check out the Installation instructions.
-
Can I customize the colors?
-
Absolutely. Check out the CSS within the plugin (thumbs-rating/css/style.css) and override the classes from your theme’s style.css file.
-
When I sort the admin columns some posts disappear
-
If the post/page has 0 votes for the column your trying to sort, WordPress hides it.
It only shows the posts/pages with at least +1 or -1 votes. -
How do I show the number of votes in other parts of my theme?
-
Paste the following snippets inside the loop:
<?=function_exists('thumbs_rating_show_up_votes') ? thumbs_rating_show_up_votes() : ''?> <?=function_exists('thumbs_rating_show_down_votes') ? thumbs_rating_show_down_votes() : ''?>(Both functions accept the post ID as a parameter in case you need it)
-
Can I use the plugin to vote media images?
-
No, the plugin only works in posts and custom post types.
-
How do I run code whenever a user votes?
-
We have an action you can hook into. For instance, if you want to clear your cache.
You can add this to your theme’s functions.php
function example_callback( $post_ID, $type_of_vote, $thumbs_rating_count ) { // Place your code here } add_action( 'thumbs_rating_vote_action', 'example_callback', 10, 3) -
Shortcode
-
The shortcode [thumbs_rating_top] accept the following parameters:
- type: positive (default) / negative
- posts_per_page: 5 (default)
- category: ID (default = all)
- show_votes: yes (default) / no
- post_type: any (default) / post / page / books
- show_both: no (default) / yes
- order: DESC (default) / ASC
- orderby: DESC (default)
- exclude_posts: “133,2,54,234” (ID of posts separated by commas)
- include_posts: “133,2,54,234” (ID of posts separated by commas)
Here’s an example using some parameters:
[thumbs_rating_top type="positive" posts_per_page="10" post_type="post" show_votes="no" order="DESC"] -
The shortcode in Widgets or Comments doesn’t work
-
You might need to allow shortcodes in that sections, here’s how.
Avaliações
Contribuidores e programadores
“Thumbs Rating” é software de código aberto. As seguintes pessoas contribuíram para este plugin:
Contribuidores
“Thumbs Rating” foi traduzido para 4 locales. Obrigado aos tradutores pelas suas contribuições.
Traduza o “Thumbs Rating” para o seu idioma.
Interessado no desenvolvimento?
Consulte o código, consulte o repositório SVN, ou subscreva o registo de alterações por RSS.
Registo de alterações
5.0.0
- Make it compatible with PHP 8.0
- Bumps the minimum required version of WordPress to 6.3 to match PHP 8.0 support, although it probably works with older versions.
4.1.0
- Add a plugin action for those who need a hook from their theme. Documented in the FAQ section.
4.0.3
- Delete another piece of jQuery code.
- Read the changelog for the 4.0.2 if you haven’t upgraded to the version 4 yet.
4.0.2
- Breaking changes! Upgrade with caution.
- Drop Internet Explorer 11 support.
- Remove jQuery as a dependency.
- Uses the ES6 JavaScript syntax.
- Changed markup to use HTML button’s instead of span.
- Print the text on the button element instead of relying in CSS.
3.4.2
- Fixes critial bug with the shortcode not showing results.
3.4.1
- Fixes critial bug with the shortcode not showing results.
3.4
- Add include_posts parameter in shortcode.
3.3
- Add orderby option in shortcode
3.2
- Add exclude_posts option in shortcode (props @hpd2311)
3.1
- Author column should not be removed from admin (spotted by sosojni)
3.0
- Added Arabic translation ar