[[PageOutline(2-5, Contents, pullout)]] = Reddit-style voting on Trac resources == Description This plugin adds a context-navigation entry, that lets users easily vote for a Trac resource, including Wiki pages, tickets, milestones, etc. If a user has a valid session (created through the [/prefs Preferences] panel) and the `VOTE_MODIFY` permission, he/she will be able to vote. Since `tracvote-0.2` there are some [wiki:VotePlugin/WikiMacros WikiMacros] available in addition to [source:voteplugin/trunk/SqlQueryForReport.txt example TracReports] on the `votes` db table. == Translation You've done a new translation? Superb! Contributing your translation is highly appreciated.[[BR]] You could send it to the plugin's maintainer or contribute to [TracPluginTranslation Trac plugin l10n project] via [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/voteplugin/ Transifex]: Top translations: Trac_Plugin-L10N ยป [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/voteplugin/ voteplugin][[BR]] [[Image(http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/voteplugin/chart/image_png, title=Go to Trac_Plugin-L10N project page on Transifex.net, link=http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/voteplugin/)]] Kindly provided by [[Image(https://ds0k0en9abmn1.cloudfront.net/static/charts/images/tx-logo-micro.png, link=http://www.transifex.net/, title=the open translation platform, valign=bottom)]] == Bugs/Feature Requests Existing bugs and feature requests for VotePlugin are [report:9?COMPONENT=VotePlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=VotePlugin&cc=hasienda new ticket]. [[TicketQuery(component=VotePlugin&group=type,format=progress)]] == Download Download the zipped source from [download:voteplugin here]. == Source You can check out VotePlugin from [http://trac-hacks.org/svn/voteplugin here] using Subversion, or [source:voteplugin browse the source] with Trac. == Installation '''Note:''' Documentation has been updated to already reflect features of current `trunk` development branch, that is in preparation for next stable release `tracvote-0.2`. To get the best first-time experience, you may wish to try the release candidate right now. Note that there is ''no down-grade'' support, while upgrading from previous plugin versions has been tested on different db back-ends and should work flawlessly. Install the plugin: {{{#!sh easy_install http://trac-hacks.org/svn/voteplugin/tags/0.1.5 }}} If you get "error: Unexpected HTML page found at http://trac-hacks.org/svn/voteplugin/tags/0.1.5", update setuptools: {{{#!sh sudo easy_install -U setuptools }}} Add the following to the `[components]` section of [wiki:TracIni trac.ini]: {{{#!ini [components] tracvote.* = enabled }}} == Configuration Configure the list of URL paths to allow voting on in `trac.ini`. Globs are supported. {{{#!ini [vote] paths = }}} This grants users the `VOTE_VIEW` and `VOTE_MODIFY` permission where appropriate. '''Notes:''' * `VOTE_MODIFY` inherits view permission since `tracvote-0.1.5`. * Since `tracvote-0.2` a default set of permissions is configured once after creating the Trac database table for this plugin. Probably you will need to run the following: {{{#!sh trac-admin /path/to/projenv upgrade }}} You will also need to restart your webserver for the plugin to be available, appear in the list of those installed, have the perms available, etc. Example SQL statements for creating useful reports for tickets and wiki pages are included in [source:voteplugin/trunk/SqlQueryForReport.txt SqlQueryForReport.txt] in the plugin source. == Screenshot [[Image(votes.png)]] == Recent Changes [[ChangeLog(voteplugin, 3)]] == Author/Contributors '''Author:''' [wiki:athomas] [[BR]] '''Maintainer:''' [[Maintainer]], hasienda [[BR]] '''Contributors:''' [wiki:k0s], PeterLawrence, cboos