HTML Logo by World Wide Web Consortium (www.w3.org). Click to learn more about our commitment to accessibility and standards.

Moving forward with Composr

ocPortal has been relaunched as Composr CMS, which is now in beta. ocPortal 9 will be superseded by Composr 10.

Head over to compo.sr for our new site, and to our migration roadmap. Existing ocPortal member accounts have been mirrored.


Flattr blocks

This adds 2 new blocks for integrating with the Flattr.com micropayment service; a kind of "Internet tip jar". One block allows visitors to "flatter" your site, the other allows users to be "flattered".

Additional information

Once you've installed this addon, you must run its setup script. This can be done by visiting the page "adminzone/index.php?page=set_up_flattr" on your site. This will add the configuration options and custom profile field necessary for making this work. You should then go to your admin zone's "configuration" screen and fill in the Flattr options under Features->Social-networking integration. The Flattr ID is required: it's who should be credited when the site is "flattered". The category/type is used for categorising your site on Flattr.com. The version field allows you to stay up-to-date with Flattr's rapidly evolving interface; keep it at 0.6 for the best compatiility (that's the newest version as I write this).

To use the blocks, include them as usual. The site block doesn't need any parameters, but you can use style=compact if you want a different look to the button. The user block takes a user ID number (or you can giive it a username instead, if you're using OCF), as well as the optional style=compact parameter. The username of the receiving user is shown next to the block like "Flattr bob:". This can be removed by editing the FLATTR_BUTTON template, but I recommend you keep it there as it should stop users trying to edit pages to point all of the Flattr blocks to themselves (it will be obvious if someone is doing this as their username would show up next to all of the Flattr buttons they've changed).

This was exported from an otherwise default ocPortal 5.0.3 installation and has been tested against a fresh ocPortal 5.0.3. Note that I've only tested this against a local installation (127.0.0.1); the buttons showed, so the communication with Flattr.com is working, but they had "error" shown due to 127.0.0.1 being unreachable by them. I'd appreciate some live testing, but don't have an ocPortal site to try it on other than a non-profit.

Images