Please read about each importer before running this plugin.

This package of social importers provide you with the ability to pull in your content that gets created on other sites, and re-publish it on your own WordPress site. Rather than leaving others in control of everything you've put time and effort into, why not host it yourself on your one true, home-on-the-web, WordPress? Read more about this technique/approach to data ownership.

After an initial import, all of these importers can also optionally check each hour and automatically download new content as well, keeping things in sync over time. They all currently import as Posts, with specific Post Formats, depending on the content type.

Importers included currently:

• Delicious
• Fitbit
• Flickr
• Foursquare/Swarm
• Instagram
• Instapaper
• Jetpack/WordPress.com
• Moves
• Nest Cameras
• Pinterest
• Pocket
• Strava
• TripIt
• Twitter

You can potentially write your own importers as well, using the base class included.

2.0

• NEW: Add a Pocket importer, props @roccotripaldi.
• Change: Updated readme.txt to include contributors.

1.9

• NEW: Added a Strava importer. Kudos @mdrovdahl. Props @marekhrabe for additional contributions.
• NEW: Introduce a new global option to set the status of posts created via import. Set to "Pending" or "Draft" to hold them for publication. Set to "Private" to keep for your own records, or "Publish" to publish automatically (previous and current default).
• Enhancement: Handle Swarm checkins created by someone else by associating that person (via People & Places). Includes a reprocessor to handle old posts.
• Enhancement: If a Swarm checkin is marked as "off the grid", then mark the geodata as non-public, and mark the created post as "private". Include a reprocessor to do the same to old posts.
• Enhancement: Now handles Featured Image and all post meta on Jetpack imports.
• Enhancement: Remove deprecated calls to screen_icon()
• Enhancement: Reprocessor for expanding old short URLs for Twitter included. Props @chrishardie.
• Enhancement: Added a filter keyring_importer_posts_pre_insert which allows you to filter all post content before posts are imported/created.
• Enhancement: Nest importer will now automatically attempt to re-download an image if the first attempt fails (significantly improves reliability).
• Change: sideload_media's last argument has changed to allow more flexibility.
• Bugfix: sideload_media previously didn't handle multiple URLs properly. Now it should.
• Bugfix: Shortened URLs are expanded correctly for Twitter now. Props @chrishardie.
• Bugfix: Updated Instagram to use max/min_id rather than timestamps for looping through media.

1.8

• NEW: Added a Jetpack/WordPress.com importer.
• Enhancement: Fix Twitter importer so that it correctly obeys the option to import retweets. Props @glueckpress for reporting.
• Enhancement: Lots of code cleanup/linting.

1.7

• Enhancement: Places support for Nest and TripIt importers.
• Enhancement: Instagram importer now supports Video posts, and People.
• Enhancement: REST API support.
• Enhancement: New filter for disabling Instapaper remote content download.
• Enhancement: New filter for injecting custom CSS into the header of an importer.

1.6

• NOTE: Update to Keyring 1.7 for full compatibility.
• NEW: Added "Reprocessor" concept (accessible via Tools > Import > Reprocess Keyring Data) to allow developers to re-use the raw import data for posts, and update/reprocess information.
• NEW: Nest Camera importer.
• NEW: Pinterest importer.
• Enhancement: Instapaper now downloads the full content of articles and stores it within the content of posts, so that you can search them later. It applies a noindex tag to those post pages to avoid duplicate content issues. Note that this is retroactive, so it'll go back and find all your old links and try to download their content over time. If you don't want that to happen, you'll need to set a postmeta/Custom Field against all of them called remote_content (set it to '1'), or you can filter keyring_instapaper_download_article_texts and __return_false to always turn it off; add_filter( 'keyring_instapaper_download_article_texts', '__return_false' );
• Enhancement: Compatible with People & Places (must be installed manually currently) to associate people and places across all services under a single taxonomy.
• Enhancement: Bundle Reprocessors to fix an old encoding bug, plus to process Twitter, Instagram and Foursquare imports for People & Places.
• Enhancement: Default the UI to save imported content against the current user/author.
• Enhancement: Link back to the importer on the success screen.
• Enhancement: Add a new filter to the default header (keyring_importer_header_css) so that you can easily inject some custom CSS, without completely recreating the header.
• Bugfix: Remove a bunch of unused global variables.

1.5

• NOTE: Update Keyring to 1.6.2 for best results
• Bugfix: Discovered a problem with the way "raw" import data was being encoded and stored (as JSON), which rendered it (sometimes) un-encodeable. Changed to use wp_slash() before storing it, which means all future data is "clean". Working on a script to recover as much as possible, or you can delete old posts and re-import them, and their import data will be stored using the new approach, and thus be more accessible.
• Enhancement: New Fitbit Importer (very basic currently)
• Enhancement: New Moves Importer (also pretty basic)
• Enhancement: Assigns imported media as the Featured Image on the post created to display it
• Enhancement: Sort photos attached to Foursquare check-ins the same as the original post
• Enhancement: Use pagination in TripIt API which makes results more reliable, and avoids timeout issues on accounts with lots of trip data
• Enhancement: Handle multiple images on Tweets
• Enhancement: Better handling of retweets (load full content, don't truncate), props @petermolnar
• Enhancement: Add a filter drop-down to the Posts page so that you can filter posts by the service from which they were imported
• Bugfix: Switch to HTTPS for Flickr (now required)
• Bugfix: Use user-id in URLs for Flickr (more reliable)
• Bugfix: Auto-import Instagram photos using timestamps instead of ids, which is more reliable

1.4

• BREAKING: Change from using a value in post meta (keyring_service) to using a custom taxonomy ('keyring_services') to reference the service a post was imported from. Entries are automatically created for all importers.
• There is a script called 'migrate-keyring-postmeta-to-taxonomy.php' included in the plugin. Put it in the root of your WP install and run it (as many times as necessary, even if it crashes/runs out of memory) until it produces no output. That will convert all existing posts and remove their keyring_service postmeta.
• Fix deprecated notice and use esc_sql()
• Fix a string that didn't havea a textdomain
• Tweak Instapaper importer to use last progress date to get links published closer to when you read them

1.3

• Update Twitter API URLs to use new 1.1 API
• Foursquare check-ins that contain photos now download and attach the photo to your local post, props Chris Finke
• Added an action which is fired after each post is created/imported: do_action( 'keyring_post_imported', $post_id, $service_name, $post );
• Add import_start/end actions which are called in core importers (for consistency)

1.2

• NOTE: Requires the latest version of Keyring (v1.4)
• NEW: Instapaper importer
• NEW: TripIt importer
• Only send the "must install Keyring" message once per page
• Better handling of options for each importer
• Check if a service is configured in Keyring before attempting to use it
• Allow default tags to be applied to all imported posts
• Clean up help text and instructions on a few importers

1.1

• Updated to work with Keyring 1.2
• Added TripIt importer (for air travel only, 1 post per "flight series")
• Added "Default tags" option for all importers

1.0

• Initial check-in without templating engine
• Auto-import working for all services except Flickr, and maybe Instagram

1. Install and activate the Keyring plugin, which is required for authentication.
2. Install Keyring Social Importers either via the WordPress.org plugin directory, or by uploading the files to your server.
3. Activate both plugins via Plugins > Installed Plugins.
4. Go to Tools > Import > (service) and follow the prompts.