Location: PHPKode > scripts > Flattr - WordPress plugin > flattr/readme.txt
=== Flattr ===
Contributors: aphex3k
Donate link: https://flattr.com/donation/give/to/der_michael
Tags: flattr, donate, micropayments
Requires at least: 3.0
Tested up to: 3.1.4
Stable tag: trunk

This plugin allows you to easily add a Flattr button to your wordpress blog.

== Description ==

Flattr was founded to help people share money, not only content. Before Flattr, the only reasonable way to donate has been to use Paypal or other systems to send money to people. The threshold for this is quite high. People would just ignore sending donations if it wasn't for a really important cause. Sending just a small sum has always been a pain in the ass. Who would ever even login to a payment system just to donate €0.01? And €10 was just too high for just one blog entry we liked...

Flattr solves this issue. When you're registered to flattr, you pay a small monthly fee. You set the amount yourself. In the end of the month, that fee is divided between all the things you flattered. You're always logged in to the account. That means that giving someone some flattr-love is just a button away. And you should! Clicking one more button doesn't add to your fee. It just divides the fee between more people! Flattr tries to encourage people to share. Not only pieces of content, but also some money to support the people who created them. With love! 

**Flattr requires an account at flattr.com!**

== Installation ==

Note that we only support PHP 5 and WordPress 2.9 or above.
To use advanced features like auto-submission or feed-buttons, your web server needs cURL extension installed.

1. Upload the folder 'flattr' to your server in the folder '/wp-content/plugins/'
2. Go to the WordPress control panel and find the 'Plugins' section
3. Activate the plugin 'Flattr'
4. Go to the 'Options' section and authrize your blog against flattr.com
5. Select your default category (which usually would be 'text' if you have a normal blog), select your default language and type in your Flattr user ID (your user ID can be found on your dashboard on http://flattr.com/ )
6. If you want the Flattr button to be automagically included at the end of your posts, leave the checkbox checked
7. If you want to add the Flattr button manually in your theme, uncheck the checkbox and use the following code snippet:
8. When writing or editing a blog post you have the ability to select category and language for this specific blog post.

`<?php the_flattr_permalink(); ?>`

8. Live long and prosper. :)


== Changelog ==

= 0.9.25.3 =
* Fix: typo in check time of post before autopublishing

= 0.9.25.2 =
* Fix: fixed a typo in the code, thanks to F. Holzhauer

= 0.9.25.1 =
* New Feature: Changelog Preview
* New Feature: Explicit warning messages about missing functionality
* Fix: Check time of post before autopublishing

= 0.9.25 =
* Requires at least Wordpress 3.0, tested against Wordpress 3.1.4
* New Feature: personalized Flattr buttons for every blog author
* New Feature: choose whether Flattr plugin handles excerpts or Wordpress
* New Feature: advanced feedback form
* New Feature: select JavaScript, static image or static text button
* Fix: buttons disabled for the post don't show up in the feed anymore
* Fix: Wordpress admin dashboard external resources fix
* Fix: trying to suggest the callback domain more reliably

= 0.9.24 =
* Fix: replaced the connect link for basic connect with Flattr with a text box where you enter your username yourself

= 0.9.23.1 =
* New Feature: reenabling auto-submit feature as soon as advanced account setup is complete.
* Fix: raising compatibility alongside other oauth plugins (Twitter Tools, etc.)

= 0.9.23 =
* New Feature: the Feed button can now be disabled
* Fix: fixed a bug that accidentally deletes authorization keys while "Save Changes"

= 0.9.22.2 =
* Plugin basic functionality will work even though cURL is not available

= 0.9.22.1 =
* Bugfix release
* fixed empty admin dashboard

= 0.9.22 =
* Wordpress 3 MS (ex-MU) support
* Using latest Flattr REST API 0.5

= 0.9.21.1 =
* Bugfix release
* Reauthorizing and Reconnection working.

If you rely on full flattr functionality for your blog you might want to consider skipping this version.
= 0.9.21 =
* The Javascript button now validates against w3c html validator. Best regards to Tim Dellas.
* HTTP/HTTPS callback fix(?)
* Integrate FlattRSS plugin
* Integrate Flattr Widegt plugin
* New Admin Dashboard with tabbed navigation

= 0.9.20 =
* plugin programmer changed `;)`
* adressing the borked excerpt behaviour
* Flattr plugins dashboard pages are moved to a seperate submenu

= 0.9.19 =
Dont show Flattr button on password protected posts until the password has been accepted.

= 0.9.18 =
Will now use version 0.6 of the JS API.
Will load the JS API using https only if the blog itself is using https. This should make the button load a bit faster for most of you.

= 0.9.17 =
Fixed PHP5 detection, will now show a message rather than throwing error on PHP4.

= 0.9.16 =
New release due to changes lost in the last release.

= 0.9.15 =
Now applies the 'flattr_button'-filter to the Flattr button to let other plugins modify it.
Used the 'flattr_button'-filter as a quick fix to work better with the ShareThis plugin.

= 0.9.14 =
Made it easier to connect with a Flattr account.
Now possible to put the Flattr button before the content in posts.
User ID is now the username.

= 0.9.13 =
Escaping of quotation marks in tags and title. Tags are now stripped from titles.

= 0.9.12 =
The plugin now uses the ver 0.5 of the JS API.

= 0.9.11 =
Excerpt length fixed
When auto inject into posts or pages are not selected, don't add the filter

= 0.9.10 =
Yet another excerpt fix
Added ability to exclude button from a single post/page
Added flattr settings to pages

= 0.9.9 =
Fixed empty excerpts

= 0.9.8 =
Fixed tags

= 0.9.7 =
* RSS excerpt fix

= 0.9.6 =
* Button didn't show up when using manual calls from templates.

= 0.9.5 =
* Flattr button is no longer added to rss feeds.

= 0.9.4 =
* fixed option to disable button for pages.

= 0.9.3 =
* fixed language bug. Sorry about the frequent updates :)

= 0.9.2 =
* fixed the url to load.js.

= 0.9 =
* Fixed a bug where including files would sometimes break other plugins.
* Will now give error if the plugin isn't compatible with the installed version of WordPress or PHP.
* Added support for hidding things from listings on flattr.com.
* Will warn users that enter their user name instead of their user id.
* Added support for the compact button.

= 0.8 =
* Cleaned up the code
* Added option for disabling the button on a per post basis

= 0.71 =
* Modified plugin to not use short php open tags

= 0.7 =
* Changed category setting to select box instead of input field.
* Added setting for default language.
* Added ability to edit category and language settings per post.

= 0.6 =
* httpvh (Smart YouTube) urls are now stripped when creating excerpt from post content.

= 0.5 =
* Fixed a bug that caused blog posts to display incorrectly when no excerpt was entered. 

= 0.4 =
* First public version

== Frequently Asked Questions ==

Q: I recieve an error message when trying to (re-)authorize my blog with flattr, what's wrong?
A: Please clear session/cookie/browser cache and try again please.

== Support ==

For support requests regarding the wordpress plugin, please visit the plugin support forum: http://wordpress.org/tags/flattr?forum_id=10

For every other Flattr support request head over to the Flattr forum: http://forum.flattr.com/
Return current item: Flattr - WordPress plugin