Setting and using multi ratings system is much different than standard ratings used for posts, pages or comments. And since this feature is new, here is the step by step tutorial on how to start using it.
There are still some things missing from current multi rating implementation that will help you in using it.
1. Enable Multi Ratings
First thing you need to do is to make sure that multi ratings feature is active. Go to the plugin settings panel, and on the general tab find plugin features section. There you need to check Multi Ratings checkbox, and click save settings button. This will enable the multi ratings, and all the panels and settings tab for them will be visible.
Also, on the general page there are adnimistation settings at the top with 3 display checkbox that you need to enable if you want to set custom CSS classes for multi rating block.
2. Multi Ratings Settings
Since we are on settings panel, we might wanna check out the settings multi ratings use. You can choose rating stars and their size for rating blocks for starters. After that you have rating text that will be rendered above rating block with stars. You can use HTML formating for the rating text. Don’t be fulled by the size of the field, there is no limit on the content you can insert here. Bu don’t go to far either.
After that you can add 4 CSS classes that will be applied to different rating block elements. Main class is the one added to whole rating block. Inside that block there is a HTML table with all rating elements, and one CSS class is applied there. Rating text can also have custom CSS and the rating submit button another class. You can add more than one class per field, you just sepparate them with empty space.
Vote message is pretty much self explanatory, and also displays the preview of what you have choosen.
3. Creating Multi Ratings Set
Now go to the Multi Sets panel, it’s time to create your first set. Click on the Add New Multi Rating Set button, and an empty form will appear. Give your set a name, write a shor description and than set the number of stars you want for the ratings. Now you need to add elements to the set. You can see that each element has a name and weight. Weight is used to calculate average rating for the set as a whole and different weights mean that element will have different impact on that calculated rating.
Most important thing about this step is that once the set is created you can’t change number of stars or number of elements one set has. It will be way to complicated to change saved info once the ratings are logged in the database. So think about what you need in the set before creating it.
After the set is saved, if everything is ok, it should appear on the multi sets lists with all the valid elements listed. Each set will get unique ID that you can use later if you want to insert the shortcode manually or to call function for insertion.
4. Inserting multi ratings block into the post
Finally, you can add rating to a post or page. Right now there is no means for autoinsertion, so you need to add it yourself. There are two methods for this, one using shortcode and the other by php function call.
This is easier to do, and you can even use rich tinyMCE3 editor on the post edit page to do it. Editor plugin has a black/yellow star icon. When you click on it you will get popup dialog like one on the right. Select multi shortcode from the list, and a Multi Rating tab will appear. There you can select your rating set, and click insert. Popup will close, and a shortcode will be inserted in the post. Shortcode has only one parameter right now and that parameter is set ID. Inserted code will look like this (without spaces after [ and before ] signs):
[ starratingmulti id="1" ]
You can add shortcode anywhere in the post. Further more you can add 2 or more different sets in the same post.
If you want to integrate multi rating block call directly into the theme. Important thing is that this must be done within the WordPress post loop so that plugin can identify the post. This function is very simple, and requiers multi set id as a parameter:
By default this function will echo the rating block into the HTML. But this function has a second parameter that can change this and return rendered block as a string instead of echoing it. Just add second parameter as false if you want to get rendered string.
If everything is set right, and you didn;t missed something, you should be able to see working rating block in the post.
a WordPress rating system