IdeaWiki:Tutorial
From IdeaWiki
Contents |
[edit] General editing
Until such time as we can improve upon it, please visit the Wikipedia's pages for common editing.
[edit] Special feature editing
[edit] Setting up a poll or to allow voting on an idea
A MediaWiki Ratings extension has been added to IdeaWiki's configuration. This means that:
- You can add a Rating box to each MediaWiki page. Ask readers a question and ask them to rank from 1 to any number.
- A comment form (with added spam protection using ReCaptcha for anonymous users) allows user to leave comments without editing the Idea.
- If the name field in the comment form matches the current logged in user, a link to the User page is provided.
- Page navigation facilities provided for more than 10 comments.
[edit] Usage
This extension adds a tag <Ranking> to the MediaWiki. The first new line inside the tag is the title of the poll, and the lines below are poll item descriptions that will be shown in the drop-down box of the Rating form.
<Rating> Poll Title Poll Item 1 (Weight = 1) Poll Item 2 (Weight = 2) ... Poll Item n (Weight = n) </Rating>
The vote is per user. With n items the weight increases from 1 to n. The overall vote is then based on the average (out of n) from votes received.
[edit] Parameters
- vote - default is true, setting vote to false removes the vote widget from the resulting ratings box, leaving only the comment box.
- Note: Setting vote to false makes Poll Title and Poll Items invisible to the user, however when having multiple comment boxes in the same page, it is important to fill in an identifier in the Poll Title field so the extension can separate one comment box from another.
- comment - default is true, setting comment to false removes the comment widget from the resulting ratings box, leaving only the vote widget.
- Setting both vote and comment to false is the same as having true in both parameters.
[edit] Example
Page with multiple comment boxes
<Rating vote=false> Question 1 </Rating> <Rating vote=false> Question 2 </Rating> <Rating vote=false> Question 3 </Rating>
Page with a single rating (1-5) but without the comment widget
<Rating comment=false> What do you think about IdeaWiki? 1 (Hate it) 2 3 4 5 (Love it) </Rating>
You can also have a page with a single rating (1-5) with the comment widget
<Rating> What do you think about IdeaWiki? 1 (Hate it) 2 3 4 5 (Love it) </Rating>
[edit] Including social sharing links
It is now possible to easily incorporate sharing links (Digg, delicious; facebook, reddit and stumble it) on your page. This will help those who like your ideas to give them wider recognition. Some of these links will be more relevant than others depending on what the page has contributed - nobody will Digg a page for example if the idea captured is not a decent article. To include the links simply use
<digg />
in your page. You can find out more about this extension here.
