Up and running in less than 10 minutes

Step 1:

If your website is not already utilising the jQuery library, add a reference to it first.

<script type="text/javascript" src="http://code.google.com/p/jqueryjs/downloads/detail?name=jquery-1.3.2.min.js"></script>

Step 2:

Copy the following script into your page.

<script type="text/javascript" src="http://ddrater-vs.datadial.net/app/ddRater.js"></script>
<script type="text/javascript">
	var rater = $.ddRater({
		accountID: [your account id]
	});
</script>

Step 3:

Tag the elements on your page that you would like your visitors to rate

<img ddRater="Main Logo" src="logo.gif" />
... or maybe something like ...
<div ddRater="Page Footer">© 2026 Datadial limited<div>

.. and that's it! Once the elements you want to track have been tagged you can view visitor ratings and comments in your Results page.

Options

Datadial accepts the following options that can be set upon instantiation, along with your Account ID.

• showDelay integer [default 200] : milliseconds delay before the Rater appears
• hideDelay integer [default 300] : milliseconds delay before the Rater disappears
• enabled boolean [default true] : control whether the Rater is immediately enabled
• onError function(string error) : when specified this function will override the inbuilt error message display
• onSuccess function(string popularOpinion, string message) : when specified this function will override the inbuilt success message display.
  popularOpinion - values are 'like', 'dislike' or 'undecided'. message - message to be given to the user. Either the default message or the customised message settable in the Settings page, once logged in.

Example

var rater = $.ddRater({
	accountID: [your account id],
	showDelay: 350,
	enabled: false,
	onError: function(error){
		alert('Whoops, the following error occured:'+error);
	}
});

Functions

• enable() : enables the Rater
• disable() : disabled the Rater

Example

var rater = $.ddRater({
	accountID: [your account id]
});
rater.disable();