HowTo: Flattr in WordPress.com

How long have we wanted to add buttons to all the great wordpress.com blogs out there? A lot of good projects start on freely hosted blogs in order to be able to get some support and afford to buy hosting later on.

By Kevin Mcphail
Now WordPress has done one clever move. They added something under their settings called Sharing, (check out this post for some pictures), through it you get a few of the normal buttons, like Facebook, Twitter and StumbleUpon. They were also added the possibility to add something all on your own! Yes, you guessed right! This means you can add Flattr to it!

We want you to help us try this out. Together with our tool we’ve tossed together these nifty little instructions of how to do it:

Basic guide:
Go to your WordPress.com Dashboard for your blog
Go to Settings -> Sharing
Under Share Button there’s a box that says Available Services
Find the Link for “Add a new service”, and you’ll get to fill out these fields:
Service name: Flattr
Sharing URL: https://flattr.com/submit/auto?user_id=%username%&url=%post_url% <- Change your “%username%” to your username on Flattr. (ergo remove the % around it as well ;))
Icon Url: https://flattr.com/_img/icons/flattr_logo_16.png

Advanced:
This only involves the sharing url, follow the other instructions in basic. The above url is the most basic one, and at least those two parameters have to be there.
The full url can be built like follows (remove the line breakers):

https://flattr.com/submit/auto?user_id=%username%&url=%post_url%&title=%post_title%
&description=%post_excerpt%&language=%lang%&tags=%post_tags%
&hidden=%hidden%&category=%post_category%

Or use any pieces of it. Don’t forget the & inbetween:
user_id=%username% Replace %username% with your username on Flattr
url=%post_url% Fetches the URL of the given post.
titel=%post_title% Fetches the title of the post.
description=%post_excerpt% Fetches the excerpt/description from your post and sets it as Thing description
language=%lang% with your language just in the thing, a list of the alternatives can be found here
tags=%post_tags% Fetches the tags from your post
hidden=%hidden% replace %hidden% with a 1 if you want to show the thing to be listed or 0 of you want it hidden
category=%post_category% Replace %post_category% with one category from the list of categories can be found here.

Good luck! And please do show us the epic results in the comments!


Cheers to Kevin for making yet another post logo.

31 thoughts on “HowTo: Flattr in WordPress.com

  1. Note that by default it only puts the sharing buttons on the post page. If you also want it on your index page, you’ll need to change the “Show sharing buttons on” option to “Posts, pages and index pages”

  2. I’m trying this right now. I’d really like an icon-url though, as wp.com requests (in swedish: Ange webbadressen till en 16x16px ikon du vill använda för denna tjänst.). Could you update this blog post with such a URL? :O)

  3. Yes, it worked. I tried the Advanced guide first, and missed the ico-URL available in the Basic guide. Maybe add the image beside the URL for easier reading?

  4. However, I did have to remove the “category=%category%&” part of the advanced URL to get it working. Also, the flattr-button isn’t the “animated” version, but a link to the auto-Flattr-widget-page on Flattr.com for the page in question, but I guess you knew that already.

  5. I figured that, but when you tried it. Unless you replace the %post_category% with one of the categories you can choose from the url that I linked, it will not work.
    I need to know if it works as intended if done correctly, but you’re not verifying if you did it correct.

  6. I am telling you what I did (remove the category-part of the URL), and that it worked.

    I also tried category=text, and that worked too.

    Does that help?

  7. I keep getting this error:

    Bad request – Trying to store thing for an unregistered user.

    What am I doing wrong?
    thanks ;)

  8. You actually didn’t you exchanged “username” not “%username%” this makes all the difference.
    Just remove the % % around your username and you’ll be set. :) (will make a clearification in the post)

  9. I just implemented the Flattr button in posts in my WordPress.com blog using the script (above) to generate the info to use in adding a sharing service.

    Seems to have worked perfectly.

    Might I suggest that, if you haven’t already, you clean up this blog post and put the info on how to do this into the Flattr support – eg, into the section on how to integrate Flattr with your site.

  10. @orschiro: No advantage in this compared to the plugin really, but it’s necessary on WordPress.com since you can’t install any plugins there – plugins can only be installed on self-hosted WordPress blogs

  11. I followed every step here but ended up with the: “Bad request (400)
    Category is invalid.” I also went to the category link but it doesn’t load.

Comments are closed.