(no commit message)
[ikiwiki.git] / doc / plugins / contrib / flattr.mdwn
1 [[!template id=plugin name=flattr author="[[jaywalk]]"]]
2
3 [flattr.com](http://flattr.com/) is a flatrate micropayment service, which revolves around the idea of having flattr buttons everywhere that people visiting your site can use to "flattr" you.
4
5 This plugin makes it easier to put flattr buttons in ikiwiki. It supports both the static kind as well as the counting dynamic javascript version. The dynamic version does not work if [[htmlscrubber|/plugins/htmlscrubber]] is active on the page.
6
7 The dynamic button does not require creation of the page on flattr before being added to a page, the static one does.
8
9 I wrote some notes on [jonatan.walck.se](http://jonatan.walck.se/software/ikiwiki/plugins/flattr/) and put the source here: [flattr.pm](http://jonatan.walck.se/software/ikiwiki/flattr.pm)
10
11 This plugin is licensed under CC0.
12
13 # Usage #
14
15     # [[!flattr args]] where args are in the form of arg=value.
16     # Possible args:
17     # type - static or dynamic. Defaults to static.
18
19     # vars in static mode:
20     # --------------------
21     # Required:
22     # url - URL to flattr page,
23     # e.g. http://flattr.com/thing/1994/jaywalks-weblog
24     # Optional: 
25     # btn - Set to compact for compact button.
26
27     # vars in dynamic mode:
28     # ---------------------
29     # Required:
30     # None.
31     # Optional:
32     # uid - Set the default in the plugin, override if needed.
33     # tle - The title defaults to $wikiname/some/path (like on the top of
34     #   the wiki).
35     # dsc - A description of the content. Defaults to " ".
36     # cat - Category, this can be text, images, video, audio, software or
37     #   rest. Defaults to text.
38     # lng - Language, list of available choises is on
39     #   https://flattr.com/support/integrate/languages. Defaults to en_GB.
40     # tag - A list of comma separated tags. Empty per default.
41     # url - URL to thing to flattred,
42     #   e.g. http://jonatan.walck.se/weblog
43     # btn - Set it to compact to get the small button, big for any other
44     #   value including empty.
45