Note: A fault with Tumblr's implementation of a popup warning message about GDPR means that the RSS / XML feed MicroBlog uses may inadvertently get blocked. This will result in a 'fatal error' being displayed, instead of the normal blog articles. The popup message is geo-located to target users within the EU. Therefore if you are previewing or publishing MicroBlog to a server outside of the EU, it should continue to function fine for you. As of 1st June 2018, Tumblr have provided no information on when they intend to fix this issue.  

I reported the problem to Tumblr and pointed out that their RSS feeds had become invalid. Initially they denied there was any problem at their end. But as of February 2020, a senior level developer I spoke to at Tumblr has sought to fix the problem, and it now appears to be working okay.
 
The emphasis of MicroBlog is very much on simplicity. You start by giving MicroBlog your Tumblr® handle (username) in the settings. When your webpage is published, your most recent Tumblr® blog entries will be shown. Unlike competing Tumblr® stacks, MicoBlog is free to download and use; benefiting from many more customisable settings and the ability to display a sidebar of blog links. Ample HTML selectors provide scope to further customise the appearance of your embedded blog. MicroBlog supports regular, photograph, quote, link, conversation, audio and video post types.

Example

Please take a look at the blog page on the Stacks4Stacks website. This is built using the MicroBlog stack and provides an excellent example of what this stack can do.

Setup

To get MicroBlog setup in your website, follow these instructions
  1. Download and install the MicroBlog stack into RapidWeaver and Stacks. Once installed, drag and drop a copy of the stack into your page
  2. Open the RapidWeaver Page Inspector and make sure the page you are putting MicroBlog into has a .php page extension, not a .html one
  3. In the MicroBlog settings, enter your Tumblr® username (handle). If you are not sure what this is or where to get it, see the information below
  4. Customise any of the settings shown to you in the stack. For example, you can change what heading level is applied to headings, create a blog sidebar and customise the width of the content and sidebar containers
  5. Publish the webpage when ready

PHP (which this stack depends upon) is software that runs on your web server. For this reason, MicroBlog will not work in RapidWeaver preview or when you export your website to a local folder on your computer. Before this stack will work, you must publish it online to your web server or MAMP. We purposefully display dummy 'lorem ipsum' content in RapidWeaver; so that you can gauge a rough idea of how MicroBlog will look, before you publish it.

Your Tumblr username

To enable the MicroBlog stack to fetch your posts from Tumblr®, you must provide a username in the stack settings. Please refrain from using Tumblr® accounts you do not have permission to reproduce on your website. To get your Tumblr® username, go to tumblr.com and login to the website. In the toolbar at the top, click on the Account button. On the profile page shown, your username will be presented right at the top. This is the same username that you enter into the stack settings. Usernames are also sometimes referred to as handles. Both are the same thing.

Posting new blog articles

Unlike the RapidWeaver blog plugin, your blog articles need to be published via the Tumblr® website. We then fetch the articles from Tumblr® and display them within your webpage. There are many tools and apps available for posting or sharing content on Tumblr®; which is one of the reasons it has grown in popularity. You can post new blog articles by logging into your Tumblr® account, on the Tumblr® website. Alternatively you can create new blog posts using any of the Tumblr® smart phone apps, or by sending an email to a special email address. SMS is available in some regions of the world, whereby you can 'text' new blog entries or media to a particular phone number.

Note

MicroBlog makes use of the Tumblr® API for fetching and displaying blog content in your website. By making use of the MicroBlog stack and the API, you agree to the terms and conditions outlined on the Tumblr® website. Stacks4Stacks is in no way liable for changes to the Tumblr® API or service which may result in the MicroBlog stack being limited in function or failing to work. Additionally take note that Tumblr® is an open blogging service, and is therefore one of many websites purposefully blocked in politically censored / sensitive regions of the world. Tumblr® is a registered trademark of Yahoo.
 

Contribute

If you find this stack element useful in your personal or commercial web projects; please consider making a small contribution towards ongoing support and updates. There are many different ways you can contribute to the Stacks4Stacks project, and benefits for doing so.