5tar FAQs

How do I install 5tar to my website?

Download 5tar from here: http://theborregos.org/projects/5tar/5tar.zip. Unzip the 5tar application. Then upload the files via FTP to your website. Then go to setup.php from where you put the files on your website. So if you put it in your root folder. Then you would go to: http://mirthwhile.com/5tar/docs/setup.php.

Enter in your database connection information and click "Install >>". This will set up the database information on your site.

The database information can be found on your 1and1 control panel in an area called MySQL Administration. This shows you all of your databases. If you have no databases then click on "New Database." The creation of a new database usually takes no more then 30 minutes. The information needed for the setup page is the Host Name, Database Name, User Name and Password.

Once setup is complete you can then go to the admin page and begin adding star raters to your site.

How do I put the rater on my website?

Go to the admin page and find the line that corresponds to the star rater that you want to put on your webpage. If this is a new star rater then click on the "New Rating" link. Then click on the Code link that corresponds to the star rater. A message will display showing you the code that needs to be copied and pasted into the webpage. It will look something similar to this:

<div id="star"><span id="rating-26" class="fivestar"></span></div>

In this example, the star rater unique ID is 26. The code that you get from the admin section can then be placed anywhere you want on your page. It is important to remember that any page where you want to display the star rater needs to import the javascript and stylesheets on the page in the head tag of the page. This only needs to be done once in the head section:

<head>
.
.
.
<!-- 5tar application link -->
<link href="../css/star_rating.css" rel="stylesheet" type="text/css" media="all"/>

<script type="text/javascript" src="../dependencies/jquery.js"></script>
<script type="text/javascript" src="../dependencies/jquery.corner.js"></script>
<script type="text/javascript" src="../core/5tar.js"></script>
<!-- /5tar application link -->.
.
.
</head>

To see an example of how to put a star rater on your page please refer to mockup.html or the test page.

How do I change my admin password?

FTP into your website and pull down the file called login.php in the 5tar admin folder. Open the file with a text editor . At the top of the file you will see:

/*
    TO CHANGE YOUR PASS WORD, MODIFY $mypassword
*/
$mypassword = "mypassword";

You may modify the text that is between the "" to set your new password. Remember that any password you make will be case sensitive. So if you have mYpasSwoRD as your password then entering mypassword would be incorrect.

How do I manage the raters?

The 5tar rating system is managed through the admin page. Each line represents a star rater that can be used on your website and gives some statistics about the rater. Each rater has the following information:

  • Rating ID - this is a unique id used in placing a star rater on your webpages.
  • Total - this is the raw star count (the number of times people have clicked on the rater)
  • Average - this is the average number of stars given by those who have clicked on the rater.
  • 1 Star - this is the number of times that the one star option has been clicked.
  • 2 Stars - this is the number of times that the two stars option has been clicked.
  • 3 Stars - this is the number of times that the three stars option has been clicked.
  • 4 Stars - this is the number of times that the four stars option has been clicked.
  • 5 Stars - this is the number of times that the five stars option has been clicked.

There are four total actions that can be done:

  • New Rating - Creates a new rater that you can use for your website.
  • Code - Generates the code you need to put on your webpage to display the star rater.
  • Remove - removes the star rater from the 5tar system (NOTE: this does not remove the code from your webpages. You will still have to go to the page where you placed the star rating code and delete it from the webpage for the rater to completely go away.)
  • Reset - resets the Total, Average, and all the star counts (1 Star - 5 Stars) back to 0.
How do I put the total count back to 0?

Go to the admin page and find the line that corresponds to the star rater that you want to reset. Then click on the reset link. This sets your Total, Average, and star counts (1 Star - 5 Stars) back to 0.

How do I change the rating ID?

On the admin page there is no way to change the rating id. The star rater code on your webpages you may change the star rater id to change which star rater shows up. For example,

<div id="star"><span id="rating-26" class="fivestar"></span></div>

This will show the star rater that is associated with RatingID 26. But if I wanted the star rater associated with say Rating ID 9 then replacing the 26 with 9 in the code will change that.

How do I create a new rater?

Go to the admin page and click on the link called "New Rating." This will create a new line at the end of all the ratings with the new Rating ID.

How do I delete a rater?

Go to the admin page and find the line that corresponds to the star rater that you want to delete. Then click on the delete link. This will delete the star rater from the 5tar system, however, this will not delete the star rater from your webpages. You then have to go into those pages that refer to the delete star rater and remove the code that displays the star rater.