|
System
Requirements
Server Operating System
- any
Client Browser - any graphic browser which support
Macromedia Flash
Shareware Restrictions
You can free use Jobdao Flash Stars Rating System for non
commercial purpose.
If you use this software in commercial purpose, you are
profiting from, requires registration (payment) of the
software. For information on registering, Purchase your
registration key hereThe copyright line that appears
to generated charts will remove after you get the license
key.
How it work
Jobdao Flash Stars Rating System based on the Macromedia Flash?
technology. To show a chart uses a Macromedia Flash Player.
There is no necessity to install the additional software on
a server. Macromedia Flash Player must be installed on the
client computers. The All popular browsers is support
Macromedia Flash?. Drawing of the chart is carried out in a
browser of the client, therefore the absorption of server is
minimal. From server to client transferred just two files:
- jstarsrate.swf - main module
- XML Data File - generated by script (PHP, ASP, JSP,
Perl, etc.)
- Vote Script - save voting information
XML
Data File specification
The XML Data File contains the data for Stars Rating System building. The
XML Data
File can dynamically builded by script (PHP,
ASP, JSP, Perl, etc.), located on web-server. The structure
of a file reminds the table.
XML
Data File structure:
<jrating>
<licensekey>1</licensekey>
<cstyle>1</cstyle>
<defaulttitle>How do you rate this sofware?</defaulttitle>
<voteurl>jstarsrate/vote.asp</voteurl>
<voteid>1</voteid>
<allowvote>1</allowvote>
<showvotes>percent</showvotes>
<showresults>percent</showresults>
<startitle1>do not user it</startitle1>
<starvotes1>1</starvotes1>
<startitle2>I've seen better software</startitle2>
<starvotes2>2</starvotes2>
<startitle3>it's good</startitle3>
<starvotes3>5</starvotes3>
<startitle4>highly recommended</startitle4>
<starvotes4>1</starvotes4>
<startitle5>Best choice</startitle5>
<starvotes5>6</starvotes5>
<totalstars>5</totalstars>
<totalvotes>15</totalvotes>
<currentstar>5</currentstar>
</jrating>
Where:
licensekey - License Key
cstyle - Color Style 1-5
|
value |
description |
|
1 |
Blue |
|
2 |
Golden Yellow |
|
3 |
Red |
|
4 |
Green |
|
5 |
Purple |
defaulttitle - Voting Title
voteurl - Vote Script
voteid - Vote ID
allowvote - 1 allow to vote, 0 not allow to vote
showvotes - votes/percent/off
|
value |
description |
|
votes |
number of votes |
|
percent |
percent of votes |
|
off |
only title |
showresults - percent/total/votes/votes_total/percent_total/thank_you
|
value |
description |
|
total |
total votes for all stars |
|
votes |
total votes for selected star |
|
percent |
percent for selected star |
|
votes_total |
total votes for selected star and total |
|
percent_total |
percent for selected star and total votes |
|
thank_you |
'Thank you' message |
totalstars - Total Voting Item
totalvotes - Total Votes
currentstar - Current Star Score
startitle1...startitleN - The Option Name
starvotes1...starvotesN - The Option Votes
See the sample and live
demos!
How to Publish Flash Star Rating System
Upload XML Data File Script, Vote Script and jstarsrate.swf to your server.
To publish Flash Star Rating System on HTML page, please use following
HTML-code:
<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=8,0,0,0"
width="280" height="40" align="middle">
<param name="allowScriptAccess" value="sameDomain"
/>
<param name="movie" value="jstarsrate.swf?datafile=jstarsrate/getdata.asp?id=1%26cstyle=4"
/>
<param name="quality" value="high" />
<param name="bgcolor" value="#ffffff" />
<param name="wmode" value="transparent" />
<embed src="jstarsrate.swf?datafile=jstarsrate/getdata.asp?id=1%26cstyle=4"
quality="high" bgcolor="#ffffff" width="280"
height="40" name="JFStarsRate" align="middle"
wmode="transparent" allowScriptAccess="sameDomain"
type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer"
/>
</object>
| http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=8,0,0,0 |
It is a url to Macromedia Flash installation file. If you
will use chart in the internal network (Intranet), You can
download swflash.cab file and locate it on your internal
server. Then change this url to your internal server.
Whereupon users will able install Macromedia Flash Player
from internal server.
It is a Stars Rating System size. You can change this
width size.
| jfchart.swf?datafile=data.xml |
It is a main parameters:
jstarsrate.swf - SWF file.
datafile - XML Data file. File or script name.
If you use script as data file, you can transfer it
parameters. For example:
| jfchart.swf?datafile=http://localhost/getdata.asp?id=1%26cstyle=4 |
URL to Data file:
datafile=http://localhost/getdata.asp?id=1%26cstyle=4
http://localhost/getdata.asp - it is url to data file.
id=1%26cstyle=4 - id and p parameter transferred to getdata.asp.
Note:
%26 - symbols to separate parameters. When you define a
parameters for script, you must use %26, don't use symbol &!
Step by Step
Step #1
Create a XML data file as described in XML Data file specification.
If you wish create dynamic data source, you must use
scripts. Script must return content as described in Data
file specification. (See also
Samples)
Step #2
Upload to your server jstarsrate.swf file and Data File.
Step #3
Insert to your page a HTML code. See How to Publish Stars
Rating System.
| 
