[[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 [/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 [/svn/voteplugin here] using Subversion, or [source:voteplugin browse the source] with Trac. == Installation Install the plugin: {{{#!sh easy_install https://trac-hacks.org/svn/voteplugin/tags/0.3.0 }}} If you get "error: Unexpected HTML page found at https://trac-hacks.org/svn/voteplugin/tags/0.3.0", 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, jun66j5