Ok, I really need to get the documentation up to date before doing a release. If not the amount of support request is going to be insane.

Thing to document:
- Setting up a Fivestar widget for Author Rating
- Setting up a Fivestar widget for user Rating
- Setting up a widget on Comments.
- Show how a node can display aggregated Results from its comment rating.
- Set up fivestar widget for User Rating on Comments
- Set up fivestar widget for User/Author rating on User Accounts.
- Using Views, (sorting by most rated, displaying fivestar field)
- Setting up multiple voting Tags (Food Rating, Comfort Rating, etc..)
- Setting up Voting Targets
- How to create your own custom Target.
- How to create your own custom Widget.
- There's other cool stuff, but the list is already getting pretty long.

The above list is all possible with the latest version of fivestar for Drupal 7. The only thing missing is showing people how to do this.

I might just make a serious of short videos to explain each feature. Should be fun.

If you know how to accomplish any of these task and feel like helping feel free to chime in on this issue.

Thanks.

Comments

ericduran’s picture

Component: Code » Documentation
Energyblazar’s picture

I think " How to create your own custom Widget." already exist checkout and confirm it http://drupal.org/node/234391 (as i have not tried it out till date).

Also by "Setting up a Fivestar widget for Author Rating" do u mean setting up fivestar widget for rating contents created by the author, cause in the second one "Setting up a Fivestar widget for user Rating" you have mentioned clearly. If its the case its pretty simple and i will volunteer for writing the first one.Setting up a Fivestar widget for user Rating

Also i would like to add one piece of documentation that i feel is required "Setting up a Fivestar widget for allowing multiple voting by same user."

ericduran’s picture

@Energyblazar any help I can get with the documentation would be great. It should be noted you're more than welcome to change any documentation page.

Oh regarding the creating widgets. That process is for D6. I need more make seperate documentation for D7 as everything is different.

It'll be nice if we could have documentation that looks like this:

-Fivestar
- Drupal 6
- Creating custom widgets
- etc.
- Drupal 7
- Creating custom widgets
- etc..

Energyblazar’s picture

Ok now i get it.

Well to be frank i am still getting hang of things in drupal 7 and am very new to this(never worked on d6), so i cannot do this on my own and will require your help in understanding few things.

So what ill do i start preparing and documenting fivestar stuff i learn in google docs and share you the docs so that you can read and edit them, if its ok with you ?

ericduran’s picture

Any help sounds great. No worries I'm here to help too :)

Energyblazar’s picture

hey eric i have send u message with my email id, hope u got it ?

Energyblazar’s picture

Hello eric i have finished documentation for the following

xSetting up a Fivestar widget for content Rating
xSetting up a Fivestar widget for user Rating
xSetting up a widget to rate posted comments.
xSetting up Voting Tags
xSet up fivestar widget for User/Author rating with comment on any content type.
xChanging Star Display options, Value to display as Stars & Text to Display Under Stars.
xUsing Fivestar module with references module and entity reference module.

I think it would be better if you go through the documents and then ill post it.

Also i need your help in documenting the following

Understanding voting target
Using views with fivestar.
Create own custom widget.
Allowing authenticated users to vote multiple times.
Changing value of vote from percentage to point (simple integers).

Energyblazar’s picture

with regards to the voting target documentation that i am writing now i have a question

please take a look for comment #10 posted by me in here http://drupal.org/node/283031

Thanks

wmking’s picture

Eric, I just implemented a multi-axis voting system using custom content types and views (product/review) so could help with this if no one else is doing it but I have never written drupal documentation so would appreciate some pointers.

Energyblazar’s picture

wmking i have made a fivestar documentation on google docs as i have mentioned in comment #7

What i me and eric have decided to do is i make the doc's and share it with eric using google docs, and then after verifying the doc we post em officially.

Now if you want i can share the google doc with you too just private message me your email id ?

mariusm’s picture

Hello wmking,

Please add documentation for drupal 7 fivestar multi - axis

Thanks

whiteph’s picture

Priority: Critical » Major
Issue summary: View changes

Downgraded because I want to clear up all critical issues before issuing a beta release, and this keeps getting in the way when I pull up a list of critical issues.

@Energyblazar and @wmking - did you add your docs to D.O.? If not, I'd be willing to help review them so you can post the updates.

whiteph’s picture

Priority: Major » Normal

Lack of response by the community, so downgrading the priority.

jlea9378’s picture

Hi, is there any documentation for using views with fivestar? I'm a little confused on how to use it. Do I need to add a relationship for Vote Results or Votes?

jlea9378’s picture

Never mind, I just realized a critical problem in this module which makes it so it doesn't fit our use case: subsequent votes overwrite previous votes. My client wants to keep a history of votes and be able to use views to display the vote history. So I guess we will have to use the Rate module instead. Though it wasn't working as well as Fivestar when I tried it...

calefilm’s picture

jlea9378,

In SQL:

TRUNCATE votingapi_cache;
TRUNCATE votingapi_vote;

this will clear the votes. Then just republish all nodes. Now your vote totals are accurate.

To avoid the double voting in the first place, simply disallow a user from saving a node twice by making their first save "unpublished". If the admin just publishes all nodes once you won't have that problem.