Pomelo Productions Tumblr Feed
The Pomelo Productions Tumblr Feed is capable of retrieving photos from a particular Tumblr user or custom Tumblr URL. The photos can be linked to the your Tumblr page, a specific URL, or to a Fancybox slideshow. Also, the Shortcode Generator makes it easy to insert the widget into posts without learning any of the code. This lightweight but powerful widget takes advantage of WordPress's built in JQuery scripts to create a sleek presentation that I hope you will like.
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/pomeloproductions/tumblr-feed/archive/refs/heads/master.zipStylish and compact plugin for displaying Tumblr images in a sidebar, post, or page.
Description
This is a clone of the Alpine PhotoTile plugin updated to support modern versions of PHP and WordPress.
Retrieve photos from a Tumblr user, custom Tumblr URL, or tag with the Alpine PhotoTile for Tumblr. The photos can be linked to the your Tumblr page, a specific URL, or to a Lightbox slideshow. Also, the Shortcode Generator makes it easy to insert the widget into posts without learning any of the code. This lightweight but powerful widget takes advantage of WordPress's built in JQuery scripts to create a sleek presentation that I hope you will like. A full description and demonstration is available at the Alpine Press.
Features:
- Display Tumblr images in a sidebar, post, or page
- Multiple styles to allow for customization
- Lighbox feature for interactive slideshow (Fancybox, or ColorBox)
- Simple instructions
- Widget & shortcode options
- Feed caching/storage for improved page loading
Quick Start Guide
- After installing the plugin on your WordPress site, make sure it is activated by logging into your admin area and going to Plugins in the left menu.
- To add the plugin to a sidebar, go to Appearance->Widgets in the left menu.
- Find the rectangle labeled Alpine PhotoTile for Tumblr. Click and drag the rectangle to one of the sidebar containers on the right.
- Once you drop the rectangle in a sidebar area, it should open to reveal a menu of options. The only required information for the plugin to work is Tumblr ID. Enter this ID and click save in the right bottom corner of the menu.
- Open another page/window in your web browser and navigate to your WordPress site to see how the sidebar looks with the Alpine PhotoTile for Tumblr included.
- Play around with the various styles and options to find what works best for your site.
Installation
- Upload
alpine-photo-tile-for-tumblrfolder to the/wp-content/plugins/directory - Activate the plugin through the 'Plugins' menu in WordPress
- Use the widget like any other widget.
- Customize based on your preference.
Frequently Asked Questions
I'm getting the message "Tumblr feed was successfully retrieved, but no photos found". What does that mean?
This message simply means that while no distinguishable errors occurred, the plugin found your feed to be empty.
I'm getting the message "Tumblr feed not found. Please recheck your ID". What does that mean?
This message can mean two things. First, it can indicate that the username or custom url were input incorrectly, causing the feed to fail. In this case, you should try to correct and re-save your IDs.
Second, this message can also mean that the server your WordPress site is being hosted on has prevented the feed from being retrieved. While it is rare, we have encountered web-hosts that disable the feed fetching functions used in the PhotoTile plugin. If this is the case, there is nothing we can do to override or work around the settings on your host server.
Is there a shortcode function?
Yes, rather than explaining how to setup the shortcode, I've created a method of generating the shortcode. Check out the Shortcode Generator on the plugin's settings page ( Settings->AlpineTile: Tumblr->Shortcode Generator).
Why doesn't the widget show my most recent photos?
The plugin caches or stores the Tumblr feed for three hours. If the new photos have still not appeared after this time, it is possible that Tumblr is responsible for the delay. While Tumblr is fairly prompt about updating photo feeds, periods of high traffic (especially on weekdays between 10am and 4pm) can cause a delay in feed updates.
Can I show more than 20 photos?
Yes, as of version 1.2.0, up to 100 photos can be retrieved and displayed.
If you have any more questions, please leave a message at the Alpine Press.
I am a one-man development team and I distribute these plugins for free, so please be patient with me.
Changelog
1.0.0
- First Release
TODO
- Rebuild the entire plugin Rebuild the displays to use templates Remove jQuery dependency Make displays dynamic Add Test Coverage