What we do: We provide a rating widget for use on your blog posts, stories, or whatever. As people rate your stories on your site we track your ratings and index your stories making them searchable here. The end result is you get feedback on your stories while the rest of us are able to find overall better stories!
About | F.A.Q. | Get your stories ranked »

Getting your stories ranked

You can use the following code to get any of your stories ranked and added to our index:


<script type="text/javascript">
var plink = "YOUR_PERMALINK_DETAILS_HERE";
var description = "A BRIEF DESCRIPTION OR TITLE OF YOUR STORY (160 CHARACTERS OR LESS)";
</script>
<script src="http://www.storyrank.com/rank.php"></script>


Be sure to replace the YOUR_PERMALINK_DETAILS_HERE with your blog post permalink (the permanent URL to your unique story or blog post). This value will be used to both calculate your unique stories ranking as well as the link to direct users to your site from storyrank.com.

The 'description' value is optional and is what will be displayed along with the link to your story on the storyrank.com web site. We recommend that you use the title of your blog post or web page for this value.


A real-world, manual example

As an example, here is the real code we use to have this very page itself ranked:


<script type="text/javascript">
var plink = "http://www.storyrank.com/code.php";
var description = "Explains how to use the StoryRank.com widget with code examples.";
</script>
<script src="http://www.storyrank.com/rank.php"></script>


which is what drives the following 'widget' :



Now once the first person rated or 'ranked' our page using the widget above, the page would be scheduled for inclusion into the storyrank.com index (as well as display the running total of the ranking).

Finally, after the page is indexed, the page would also start to show up in storyrank.com search results.

StoryRank.com Widget Requirements

The storyrank.com widget uses heavy doses of Javascript, DHTML, and Ajax. All of this means that your readers (ie. people who will actually rate your stories) must be using a 'web 2.0' compatible web browser.

The good news is that the list of compatible 'web 2.0' browsers is rather large. So large in fact, that we believe most browsers to be compatible already.

However, if you find a specific browser that a large percentage of your readers are using does not work with the storyrank.com widget, please let us know. We'll then get to work on supporting it right away!


Integrating with Wordpress

Adding the StoryRank widget to your WordPress blog is simple. Just add the following code to your template directly after any <?php the_content() ?> call.

<script type="text/javascript">
var plink = "<?php echo the_permalink(); ?>";
var description = "<?php echo the_title(); ?>";
</script>
<script src="http://www.storyrank.com/rank.php"></script>

Note: As an example, if you are using the default WordPress theme you should use your theme editor to include this snippet in the index.php and page.php files.


Integrating with TypePad

This information will be available soon!


Got More Questions?

If you're interested in learning more about the actual ranking calculations, our indexing process, or other general details about StoryRank please check out our frequently asked questions.