Tumblr hack: A real tag cloud

Tumblr may come up with "real" tag browsing soon, but meanwhile, here's a tag cloud that -- unlike third party services -- uses the actual tags that you assign to your posts.

Basically, the script calls the Tumblr JSON API and processes the posts, 50 at a time (the maximum allowable; configurable). It saves the tags, URLs, and a bit of the content. If there are any remaining posts, it keeps on doing this until it retrieves all of them, or reaches a preset maximum (150 by default, or thrice). It then renders the tags in varying font sizes depending on the total number of times each tag was used.

By default, links are created for each of the tags. Clicking on a tag will generate a list of posts with that particular tag. [ Hey Tumblr! A /tags/<tagname> path that only shows posts with that tag would be nice. :-) ]

I used Jason Levitt's Dynamic Script Tag class to call the Tumblr API as many times as required.

Here's*** the quick-and-dirty demo script showing the tags from my scifaiku site (again). If you do use it, please send me your URL via a comment. :-)

*** Update: The original one didn't use the titles (I had no titles in scifAI, originally) but instead parsed the content up to the first HTML tag. Here is a more generic one, using post titles.

more > | full >>

< less | full >>

Tumblr hack: Author's Notes via Google Docs

This is a very basic HOWTO on retrieving a particular item in a Google Docs spreadsheet from your blog (not necessarily Tumblr), something that I could have used a few days ago. I use this over at my scifaiku site to show author notes for particular posts. *

1. Create a new spreadsheet


2. Use the first row to label the fields


3. Enter some data


4. Publish the spreadsheet


5. Go to More publishing options


6. Select RSS from the File format dropdown


7. Click Generate URL and copy the resulting URL


8. Modify the URL from something like
   http://spreadsheets.google.com/feeds/list/
o<numbers>.<numbers>/od6/public/basic?alt=rss
   
   to something like (one line)
   
   http://spreadsheets.google.com/feeds/list/
o<numbers>.<numbers>/od6/public/basic?
alt=json-in-script&callback=notesLoaded&sq=postid%3D{PostID}
   
   where sq is a structured query (in this case, the postid field must be equal to the current Tumblr post id)
   


9. Create a JSON call using the above URL, and put this near </body> (one line):
   
<script src="http://spreadsheets.google.com/feeds/list/
o<numbers>.<numbers>/od6/public/basic?
alt=json-in-script&callback=notesLoaded&sq=postid%3D{PostID}" type="text/javascript"></script>



10. Specify an output location using a named div
    <div id="authnotes_load"></div>
    
    If you want a nice "loading" animation to put inside this div, get one from ajaxload.info
    


11. Write the callback handler:
    

    function notesLoaded(obj) {
      var notediv = document.getElementById('authnotes_load');
      if(typeof(obj['feed']['entry']) != 'undefined') {
         // 10 length of 'authnote: ', the first column
         var note = 
         obj['feed']['entry'][0]['content']['$t'].substring(10);
         notediv.innerHTML = "<p><span>author's notes :"
         +  "</span> " + note + "</p>";
      } else
        notediv.innerHTML = '';
    }

Adjust the above to taste. Enjoy!

You can see this in action here. A modified version is used at the main scifAI page ("42").

* Update: Deprecated in favor of just using Disqus comments.

more > | full >>

< less | full >>