RC Post Rating

Descripción

This plugin adds a pair of buttons that provide the ability for visitors to your website to give feedback on page / post / custom post type content by up / down rating. The Up/down rating statistics can be viewed on the respective post lists in the WordPress admin and also via a table of statistics in a Dashboard widget, these statistics can be exported in a CSV format file.

Example usage:

Enable the plugin and access the “RC Post Rating” page in the Settings menu in your WordPress Admin to configure the required settings. The settings screen allows you to enable/disable the Dashboard widget, admin columns for the various post types on your site, set the global default Up / Downvote button text and also global default CSS classes for the buttons.

There are two methods that can be used to add the buttons to your site, a shortcode and a block for the modern block editor. Note that the simplest way to use it is to set the global attributes in the settings page then add the shortcode or block to the page / post / cpt content, the global defaults will automatically be brought in to the rendered code from each of these blocks. Note however that the shortcode (unlike the block version at this time) does provide a way to override these defaults, so if alternatve Up / Down text was needed for a specific page then these can be set per page if needed. The shortcode attributes are as follows:

  • id – defaults to the ID of the page that the shortcode is on, so this doesn’t need to be specifically set in the shortcode so normally you would omit this attribute
  • classes – defaults to the global values from the plugin settings page, or empty if these haven’t been set
  • uptext – defaults to the global values from the plugin settings page, or ‘Up’ if these haven’t been set
  • downtext – defaults to the global values from the plugin settings page, or ‘Down’ if these haven’t been set

The most basic shortcode format is:

[rc_post_rating]

To override the default classes and button text you would use:

[rc_post_rating classes="my-buttons" uptext="Yes" downtext="No"]

This will use the default settings from the plugin’s admin page.

Capturas

  • This screenshot shows the administration page for the "RC Post Rating" plugin in the WordPress backend
  • This screenshot shows "Add post Rating" block in the block inserter with the block added to the page content
  • This screenshot shows the shortcode method of adding the Post ratings buttons to page content which allows setting custom attributes
  • This screenshot shows the Post ratings buttons in a web page in their default unclicked state
  • This screenshot shows the Post ratings buttons in a web page in their clicked / activated state

Bloques

Este plugin provee 1 bloque.

  • RC Post Rating

Instalación

  1. Upload the plugin package to the plugins directory of your site, or search for “RC Post Rating” in the WordPress plugins directory from the Plugins section of your WordPress dashboard.
  2. Once uploaded or installed you must activate the plugin from the Plugins section of your WordPress dashboard.
  3. Go to the “RC Post Rating” page in the Settings menu in your WordPress Admin to configure your plugin.

Preguntas frecuentes

What does this plugin do?

This plugin adds a pair of buttons that provide the ability for visitors to your website to give feedback on page / post / custom post type content by up / down rating. The Up/down rating statistics can be view on the respective post lists in the WordPress admin and also via a table of statistics in a Dashboard widget, these statistics can be exported in a CSV format file.

How do I configure the plugin settings?

You can configure all of the plugin settings from the “RC Post Rating” menu found in the “Settings” menu in your WordPress admin.

Can I use this in the block editor?

Yes, this plugin adds a new block called “Add Post Rating Block” in the ‘Widgets’ category of the block inserter. Note that using shortcode provides the ability to override the default settings, currently this is not possible with the block, however, it is possible to use the “Shortcode” block in the editor and add the buttons using the shortcode method instead.

Can I add this to my theme?

Yes, you can add this to your theme by using the shortcode, you can use the following PHP code in the appropriate file(s) within your site’s theme:

<?php echo do_shortcode( '[rc_post_rating]' ); ?>

Can I change the wording on the buttons?

Yes, you can set the default button text on the plugin settings page, use the “RC Post Rating” menu found in the “Settings” menu in your WordPress admin. If using the shortcode method of adding the buttons to your site you can also override these defaults with shortcode attributes.

How do I style the buttons? Can I customise the CSS?

This plugin doesn’t add any CSS styles so you will need to either add some CSS styles to the theme of your site or use the “Additional CSS” function in the WordPress admin to add some CSS styles.

The HTML markup for the buttons has a containing DIV element with a class of post-rating-tool, inside this div are two links, one for up-rating with a class rating-up and one for down-rating with a class rating-down. When a user clicks on one of the button links it will add an additional class of active to that button and a class of disabled to the other button (note that these states persist for the user via a local storage setting in their browser which prevents them from rating a page more than once).

Here is an example of the generated HTML markup:

<div class="post-rating-tool" data-post-rating-id="123">
    <a href="#yes" class="rating-up active">Yes</a>
    <a href="#no" class="rating-up disabled">No</a>
</div>

Here is some example CSS to provide styling for the basic states of the buttons:

.post-rating-tool a {
    border-radius: 6px;
    background-color: #bbb;
    color: #000;
    padding: 10px;
    margin-left: 5px;
    margin-right: 5px;
    box-shadow: 0 2px 3px rgba(0,0,0,0.2);
}

.post-rating-tool a:hover {
    background-color: #ddd;
    color: #000;
    box-shadow: 0 2px 3px rgba(0,0,0,0.3);
}

.post-rating-tool a.active, .post-rating-tool a.active:hover {
    background-color: #000;
    color: #fff;
}

.post-rating-tool a.disabled, .post-rating-tool a.disabled:hover {
    background-color: #ddd;
    color: #ccc;
    cursor: not-allowed;
    box-shadow: 0 2px 3px rgba(0,0,0,0.2);
}

How can I tell if it is working? Troubleshooting tips

If the plugin has been installed and activated and you have added rating buttons via either a shortcode or a block to a page on your site or to a template in your theme then you should see the buttons on the content. Click one of the Up / Down buttons and it should save that rating to that content. If you check that content in the WordPress admin you should be able to see “Upvotes” and “Downvotes” columns in the Page / Post listing screen, look for the page / post you clicked the rating button on and you should see a numeric value in either of those columns. You should also be able to see a Dashboard widghet with a statistics table if you have enabled this in the plugin settings.

If you think you have this all set up but the buttons don’t seem to be working then it’s possible something else may be clashing with their functionality. The buttons when clicked submit the rating via WordPress’s REST API, if you have somehow disabled the REST API then this will prevent the ratings from working, if this isn’t something you have knowingly disabled then it’s possible that security plugins such as Wordfence that provide web application firewall type protection may also be blocking it from working. Please check any security software to see if it may be mistakenly blocking it, usually there will be some kind of method to whitelist certain actions within security plugins.

Reseñas

No hay reseñas para este plugin.

Colaboradores y desarrolladores

“RC Post Rating” es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

Traduce “RC Post Rating” a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN , o suscríbete al log de desarrollo por RSS .

Registro de cambios

1.0.6

  • Fixed an issue where only votes for Pages and Posts but not custom post type were being displayed in the Dashboard widget.

1.0.5

  • Various changes / improvements to code to meet requirements for submission to WordPress.org plugin directory. Updated function prefixes, increased escaping of output and change of text-domain to match plugin slug.

1.0.4

  • Initial plugin build.