WordPress Flickr Shortcode Importer Release 1.4.1

by Michael Cannon in WordPress · 1 comment

Release 1.4.1 of the WordPress Flickr Shortcode Importer plugin represents a more tested and minor-issues resolved production release. This is the version to readily and easily import [[flickr]] & [[flickrset]] shortcode and Flickr-sourced A/IMG tagged media into your Media Library.

A Warning, do read the rest below, this import takes time, especially if there’s other plugins like Broken Link Checker, WP Smush, Scissors-continued, WordSocial, etc. All of these do additional image processing and will slow down imports greatly. You might disable them and then use Regenerate Thumbnails afterwards to get all of the image resizing and Smush’ing done.

Get the Flickr Shortcode Importer from WordPress Plugins.


Flickr Shortcode Importer

Imports [[flickr]] & [[flickrset]] shortcode and Flickr-sourced A/IMG tagged media into the Media Library.

Contributors: comprock

Donate link: http://peimic.com/about-peimic/donate/

Tags: flickr, featured image, import, media library, photo

Requires at least: 3.0.0

Tested up to: 3.2.1

Stable tag: 1.4.1


Imports [[flickr]] & [[flickrset]] shortcode and Flickr-sourced A/IMG tagged media into the Media Library. Furthermore, it transforms the post content [[flickr]] shortcodes into links containing the Media Library based image of the proper size and alignment.

The first [[flickr]] image found in post content is set as the post’s Featured Image and removed from the post content. The remaining [[flickr]] shortcodes are then transfromed as image links to their attachment page.

[[flickrset]] shortcode is converted to [[ gallery]]

after the Flickr set images have been added to the Media Library. If ‘Set Featured Image’ is checked in Options, then the first image of the [[flickrset]] is used as such.

Flickr-sourced A/IMG tagged media is converted into [[flickr]] and then importehttps://aihr.us/files/wordpress/d as normal. great for finally bringing into your control all of those media items you’ve been using, but now flickr is giving you ‘Image is unavaiable’ for. A/IMG tag is processed before IMG to prevent unexpected results.

This plugin is handy for transitioning from plugin wordpress-flickr-manager to your own Media Library because you have CDN services or want to move off of third party software.

There is no restore functionality. Backup beforehand or be prepared to revert every transformed post by hand via the post revision tool.


  • Default A Tag Class
  • Default Image Alignment
  • Default Image Size
  • Import Flickr-based A/IMG tags
  • Set Captions
  • Set first [[flickr]] image as featured image or not
  • Force Set Featured Image
  • Remove first [[flickr]] from post content or not
  • Make Nice Image Title?
  • Set limit of posts to be processed

Handled shortcode & media samples

  • [[flickr id=”5348222727″ thumbnail=”small” overlay=”false” size=”large” group=”” align=”none”]]
  • [[flickrset id=”72157626986038277″ thumbnail=”small” photos=”” overlay=”true” size=”large”]]
  • Khan Sao Road, Bangkok, Thailand
  • Khan Sao Road, Bangkok, Thailand


  • Backup your database before importing. You can use revision to revert individual posts, but doing so in mass is a major PITA.
  • It’s strongly recommended to deactivate plugins like WordSocial, WP Smush.it and similar to prevent extended import times. You can always enable them and run them enmasse later.
  • Flickr-sourced IMG tags will now be linked to the attachment page.
  • During my own imports, a post with one [[flickr]] entry could take a minute. Then posts with many [[flickr]] entries, several Flickr-source’d A/IMG tags and [[flickset]] with 30 or so photos took over 10-minutes to import.
  • During that importing time, it’ll look like nothing is happening. The progress bar only moves after each import succeeds or fails.
  • I recommend setting the limit in options to 1 and then testing your installation. That sure makes for easier recovery in case something goes wrong. If something doesn’t work, report it, http://wordpress.org/extend/plugins/flickr-shortcode-importer/.
  • Make sure you have enough disk space. Figure on about 1 GB per 1,000 photos given your using Scissors-continued and have a maximum image size of 1280 x 1024. If your images can be larger, then you’ll probably need 1 GB per 250 photos imported.

Thank You

  • Initial code is modeled after Viper007Bond’s class based Regenerate Thumbnails plugin. The AJAX status and single auto-submission operations were a big help.
  • [[flickr]] shortcode handling code copied from Trent Gardner’s very fine Flickr Manager plugin.
  • Hat’s off to Alison Barret for her Settings API tutorials and class My_Theme_Options.


  1. Upload the flickr-shortcode-importer folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Go to the Tools submenu, click on Flickr Shortcode Importer

Frequently Asked Questions

Can I sponsor changes?

Yes. Any sponsoring would be greatly welcome. Please donate and let me know what’s wanted

Help, it doesn’t work

Please leave a forum entry detailing exactly what error message you received, whether or not you attempted and succeeded with a 1 item import, a copy of post content and any other steps needed to replicate your troubles. Don’t forget the WP and PHP versions.

With this information, I should be able to have an idea on how to help resolve your issues.

Importing was working, but suddenly stopped

Is your disk quota large enough? See Warnings in Description for help.


  1. Flickr Shortcode Importer in Plugins
  2. Flickr Shortcode Importer in Tools
  3. Flickr Shortcode Importer progress
  4. Before Flickr Shortcode Importer for [[flickr]]
  5. After Flickr Shortcode Importer for [[flickr]]
  6. Flickr Shortcode Importer Options
  7. Before Flickr Shortcode Importer for [[flickrset]]
  8. After Flickr Shortcode Importer for [[flickrset]]





  • Production worthy


  • Rename ChangeLog to changelog.txt
  • Convert Flickr sourced IMG to [[flickr]]


  • Check for camera given photo title
  • html_entity_decode photo description
  • Update Options screenshot
  • Put progress for a/img to shortcode conversion - moved convert_flickr_sourced_tags() into ajax_process_shortcode()
  • Update readme verbiage


  • Add option Default A Tag Class


  • Properly call cbMkReadableStr


  • Update plugin description


  • Fix over zealous replacement of content for A/IMG tag to [[flickr]] conversion
  • Use cbMkReadableStr to pretty print media filenames as a title as needed
  • Update Options screenshot
  • Replace preg_match_all with explode and preg_match to handle single line of many A/IMG tags
  • Line break after shortcodes to ensure proper reading by WordPress
  • Add option Default Image Alignment
  • Add option Default Image Size
  • Add warnings to readme
  • Import Flickr-based A/IMG tags
  • Set get_shortcode_size default to medium
  • Add Estimated time required to import notice


  • Add option Set Captions
  • Add option Force Set Featured Image
  • Add option Make Nice Image Title?
  • Allow 2 minutes per photo import before timing out
  • Add Flickr Shortcode Importer before & after screenshots for [[flickrset]]
  • Import [[flickrset]] shortcode content


  • Add Flickr Shortcode Importer Options screenshot
  • Add option Remove First Flickr Shortcode
  • Add option to setting Featured Image or not
  • Add import page link to options page
  • Add conversion limit option
  • Polish up About Flickr Shortcode Importer section
  • Add text domain
  • Rename class.settings.php to class.options.php
  • Add [[flickr]] Options link to [[flickr]] Import page
  • Add icon to [[flickr]] Import page
  • Flickr Shortcode Importer Options page added
  • [[flickr]] Options linked from Plugins
  • Update pot file
  • Remove old settings file
  • Use Alison Barret’s class My_Theme_Options
  • Add ob_settings.php options page helper for using Settings API
  • TODO video import
  • Backup or reversion reminders


  • Replace duplicate lookup by guid with _flickr_src in postmeta
  • RenderVideo via FlickrManager code
  • Remove [[flickr]] lookup Lhttps://aihr.us/files/wordpress/imit


  • Initial release for production use


  • Initial release for production testing
  • Prep for further production testing;
  • Remove import Lhttps://aihr.us/files/wordpress/imit;
  • Turn off duplicate handling due to being unable to process guid setting or recall;
  • Remove unused helper files;
  • Add screenshots;
  • Set version 0.1.0;
  • Correct featured image setting and first_image removal handling;
  • Prevent duplicate [[flickr]] imports;
  • Revise readme content;
  • Handle featured image setting;
  • Remove first [[flickr]] from post_content;
  • Correct [[flickr]] replacement for attachment links
  • Load phpFlickr;
  • In test mode;
  • Verbiage updates;
  • Process shortcode via do_shortcode;
  • Readme thank you
  • Update method names for FSI;
  • Remove unused methods;
  • Begin post pulling with [[flickr]];
  • Set 5-minute time limit per post;
  • Update verbiage for FSI usage
  • UL shortcode samples
  • Update for coding standard;
  • Disallow production use
  • Set version 0.0.0
  • Domain text;
  • Add language
  • Don’t Use Text
  • Add PHPFlickr library;
  • Add FlickManager reference
  • Update verbiage to Flickr Shortcode Importer;
  • Ignore options for now

Upgrade Notice



  • Make the Settings page link to the link list, and vice versa
  • Add estimated time remaining notice
  • Import Flickr video - currently rendering as video/object/embed tag using Flickr src

Be Sociable, Share!

Related Entries

About Michael Cannon

Hello, I'm Michael Cannon, Peichi's smiling man, an adventurous water-ratchief technology officer, cyclist, poet, WWOOF'er and world traveler.

Previous post:

Next post: