[[PageOutline(2-5,Contents,pullout)]]

= Include a Pledgie badge in your Trac instance, raise money for your project

== Description

This macro uses the [https://pledgie.com/ pledgie.com] badge to allow people to donate money to your project as well as show you and your users how much has been donated.

[[Image(source:pledgiemacro/pledgie.png)]]

'''Note''': The above is a screen capture only. The plugin is not installed on this Trac instance and this is just a sample.

{{{#!comment
Attach the file to the wiki page instead, and don't put it in the source.
}}}

Pledgie requires the campaign ''id'' as its first argument, like so:
{{{
[[Pledgie(4539)]]
}}}

That will display a badge like shown above.

'''Note''': The campaign ''id'' can be found in the pledgie url, eg !http://pledgie.com/campaigns/ '''''id'''''.

Please [http://www.pledgie.com/campaigns/4539 donate], if you find it useful.

I am in no way affiliated with pledgie. Thinking about reviving another project hosted on assembla, I thought it might be nice to see if someone would throw a dime at it. That is what motivated me.

== Bugs/Feature Requests

Existing bugs and feature requests for PledgieMacro are 
[report:9?COMPONENT=PledgieMacro here].

If you have any issues, create a 
[/newticket?component=PledgieMacro new ticket].

[[TicketQuery(component=PledgieMacro&group=type,format=progress)]]

== Download

Download the zipped source from [export:pledgiemacro here].

== Source

You can check out PledgieMacro from [/svn/pledgiemacro here] using Subversion, or [source:pledgiemacro browse the source] with Trac.

== Installation

Download or checkout the macro and put it in your Trac environment's `plugins` directory.

If you have setuptools installed you can just use:
{{{#!sh
sudo easy_install https://trac-hacks.org/svn/pledgiemacro/0.11
}}}

Or you can download the zipped source from [export:pledgiemacro/0.11 here] and extract the contents in the plugins directory of your Trac environment. Alternatively, use subversion export in the plugins directory.

If you have `TRAC_ADMIN` rights, you can also install it via the upload feature in the admin menu.

== Recent Changes

[[ChangeLog(pledgiemacro, 3)]]

== Author/Contributors

'''Author:''' [wiki:stephas] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''