microbians's Avatar


25 Mar, 2012 11:05 PM

Here is the plugin to get a custom blog that reads posts from one or more tubmlr sites.


The template addon example.

When you install the plugin will add a custom settings on the "General Settings" page you will need to check.

How to use:

Make use of it by adding func=readTumblr to the options of a page.

The plugin reads parameters from the query line in this way (as an example):
&start=5 > Will read the tumblr mix of post from the page number 5 &site=mysite1 > Will render only the tumblr site that fits mysite1 name (like mysite1.tumblr.com or mysite1.com) &force=true > Will force to read all tumblr post (this is only needed when you delete or edit a post in tumblr)

HTML you can use in /templates of your theme, anyway this are optional
as the plugin make use of it on case the file exist, if not will render all in a regular html or will render the default:

tumblr_post_open.html > This is use every post is open
tumblr_post_close.html > This is use every post is open
tumblr_post_default.html > This is used when there is no especific post html template like the next ones:
tumblr_post_photo.html > To use with photo post...
tumblr_post_link.html > To use with link post...
... (and so on)

Variables to use on tumblr_post_* templates:

$post['tumblr.site'] - Tumblr site domain (ej. mysite1.tumblr.com) $post['tumblr.tumblrid'] - ID of the post that tumblr uses $post['tumblr.date'] - Unix date of the post $post['tumblr.type'] - Type of post... photo, quote, text, link,... $post['tumblr.url'] - Url link to the post in tumblr $post['tumblr.slug'] - Slug name for the post tumblr uses

$post['tumblr.data1'], $post['tumblr.data2'], $post['tumblr.data3'] tumblr.data1, tumblr.data2, tumblr.data3 of $post, it depends on type of post can be title or link or...:

case 'photo':
$post['tumblr.data1'] = $post['photo-url-500'] $post['tumblr.data2'] = $post['photo-caption'] $post['tumblr.data3'] = $post['photo-link-url'] case 'link':
$post['tumblr.data1'] = $post['link-text'] $post['tumblr.data2'] = $post['link-url'] $post['tumblr.data3'] = $post['link-description'] case 'regular':
$post['tumblr.data1'] = $post['regular-title'] $post['tumblr.data2'] = $post['regular-body'] case 'quote':
$post['tumblr.data1'] = $post['quote-text'] $post['tumblr.data2'] = $post['quote-source'] case 'conversation':
$post['tumblr.data1'] = $post['conversation-title'] $post['tumblr.data2'] = $post['conversation-text'] case 'video':
$post['tumblr.data1'] = $post['video-caption'] $post['tumblr.data2'] = $post['video-source'] $post['tumblr.data3'] = $post['video-player'] case 'audio':
$post['tumblr.data1'] = $post['audio-caption'] $post['tumblr.data2'] = $post['conversation-text'] case 'answer':
$post['tumblr.data1'] = $post['question'] $post['tumblr.data2'] = $post['answer']

After install you can do it also this way. Add a Blog Page (as the regular way The Secretary works) and in your theme add this...

$pageInfo = pageInfo(currentPage()); if ($pageInfo['content_type']=='blog') {

or add a Page and set Type / Module to BLOG or PROJECT and add func=readTumblr on the Options box... if you don't set the Type / Module will not work.

Version 1.6 : Added permalink + Some minor bugs
LInk permalink as:
?page=blog&tumblrid=<?php echo $post['tumblr.tumblrid'];?>&site=<?php echo $post['tumblr.site'];?>

If you get any error please tell me.

  1. 1 Posted by microbians on 13 Apr, 2012 11:18 PM

    microbians's Avatar
  2. 2 Posted by sldonmtns on 29 Apr, 2012 06:43 AM

    sldonmtns's Avatar

    Thanks for the plugin!

    Is there any way to show photos larger than 500px wide?

    I tried changing "PhotoURL-500" to "PhotoURL-HighRes" in the plugin and photo post template files

  3. 3 Posted by microbians. on 03 May, 2012 08:42 AM

    microbians.'s Avatar

    I need to change the way I'm storing data in the database. So by the way you can change the plugin and where you see photo-url-500 change it to photo-url-1280

  4. 4 Posted by sldonmtns on 09 May, 2012 11:55 PM

    sldonmtns's Avatar

    Thanks! I got the images to work at 1280. I had to upload a new post to see the image size change.

    Now to get a theme set up to work with my site!

  5. 5 Posted by sldonmtns on 10 May, 2012 07:15 PM

    sldonmtns's Avatar

    Got the themes set up, but I am having a problem adding the query line to force read all.

    In page type options I added: "func=readTumblr, &force=true". I also tried: "func=readTumblr, force=true".

  6. 6 Posted by microbians on 10 May, 2012 07:50 PM

    microbians's Avatar

    This is because is a Query not a option, used on the URL yoursite.co/blablabla?force=true

  7. 7 Posted by microbians on 10 May, 2012 07:52 PM

    microbians's Avatar

    Anyway I added to the last version (not uploaded yet) a different method with a button inside the cms.

  8. 8 Posted by sldonmtns on 10 May, 2012 09:53 PM

    sldonmtns's Avatar

    Thanks for the quick reply! I got it to work by turning off Clean URLs in CMS Settings.

    "dannyrolph.net/blog?force=true" did not work, but "dannyrolph.net/?page=blog&force=true" did work.

  9. 9 Posted by Audy on 20 Feb, 2013 03:53 PM

    Audy's Avatar

    Hi Microbian,

    I have installed the plugin but unable to get the feed from tumblr to display in my pages.
    Complete noob here trying to figure out how to put in the function and where to put it in(page template/text box.. )??? :(

    Pls help!!
    All i wish to do is get the posts on "abstruseeyes.tumblr.com" to reflect in my blog page "abstruseeyes.com/blog"

  10. 10 Posted by allvaro on 16 May, 2013 01:38 PM

    allvaro's Avatar

    Hi Microbians!

    Thanks for the plugin, it's really handy stuff!

    I've got one question, it might be pretty n00bish but I'l ask it anyway:

    Is there a way i can style (via CSS) the appearance of the posts in the Secretary? I know the "a" and "p" will change appearance, but also for the rest of the website.

    Maybe you can provide some tips on how to start with this task.

    Thank you very much for your time.

    PS. That's how your plugin looks now in my new website: http://www.alvaroramis.com/?page=blogs As you can see it looks pretty spartan.

  11. 11 Posted by tomscdl on 31 May, 2014 08:23 PM

    tomscdl's Avatar

    Cricket Selectors once again Mitchell Johnson, George Bailey to prevent relax plus continue Malcolm Knox Whenever people mention a real performer's assortment within the cricket workforce is good and even undesirable, this guy proceeds as well as constitutes a dill of the with getting any more points nought as well as 300, or becoming tossed out connected with a rod. Ashes The year 2013: Henry Bailey and even Mitchell Brown can keep sooth and even maintain Malcolm Knox As soon as speaking about two of the brand-new inclusions in this Hawaiian workforce, George Bailey together with Mitchell Brown, it is not just a few adoring and / or criticising any selectors' selection however , when attempting to figure out the software. Envision! Any avengers in the ashened urn Malcolm Knox IT'S a good issue which usually England's physiological super hero report will be mystery. As if Australia's cricketers were unable demoralised ample now, how could many people deep sleep during the night time once they was aware of which... Comments Just one Arthur's style bets loudly during Aussie results within 4 Association Malcolm Knox Typically the English tongue organization tend to be abandoning Nottingham having bloodied smell plus a harmful moral sense. Its notion on their mind-boggling favouritism for those series now has, similar to Stuart Broad's harmless facial area, a smaller amount... Comments 33 Milne fronts courtroom across rape premiums The committal experiencing located at Victoria Magistrates Court is definitely also told Mr Milne raped unique, who had previously been 20 the moment, even with him / her frequently declaring "no".

Reply to this discussion

Internal reply

Formatting help / Preview (switch to plain text) No formatting (switch to Markdown)

Attaching KB article:


Attached Files

You can attach files up to 10MB

If you don't have an account yet, we need to confirm you're human and not a machine trying to post spam.

Keyboard shortcuts


? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac