Skip to content

Commit 958ea83

Browse files
author
Beau Lebens
committed
Bump to 1.6
1 parent 00526a3 commit 958ea83

File tree

2 files changed

+91
-63
lines changed

2 files changed

+91
-63
lines changed

keyring-importers.php

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Plugin Name: Keyring Social Importers
44
Description: Take back your content from different social media websites like Twitter, Flickr, Instagram, Delicious and Foursquare. Store everything in your own WordPress so that you can use it however you like.
55
Plugin URL: http://dentedreality.com.au/projects/wp-keyring-importers/
6-
Version: 1.5
6+
Version: 1.6
77
Author: Beau Lebens
88
Author URI: http://dentedreality.com.au
99
*/

readme.txt

+90-62
Original file line numberDiff line numberDiff line change
@@ -1,106 +1,134 @@
11
=== Keyring Social Importers ===
2-
Tags: import, sync, social, keyring, delicious, flickr, foursquare, instagram, instapaper, tripit, twitter
2+
Tags: import, sync, social, keyring, indieweb, foursquare, instagram, instapaper, tripit, twitter, pinterest
33
Requires at least: 3.3
4-
Tested up to: 4.4
5-
Stable Tag: 1.5
4+
Tested up to: 4.7.1
5+
Stable Tag: 1.6
66

7-
Import your posts/images/etc from other web services into your WordPress install. Own your content.
7+
Import your posts/images/etc from Twitter, Instagram, Pinterest, and more into your WordPress install. Own your content.
88

99
== Description ==
1010

1111
**Please [read about each importer](http://wordpress.org/extend/plugins/keyring-social-importers/other_notes/) before running this plugin**
1212

13-
**NOTE: This is "pre-release" software! It's likely to miss importing some content, import it in a format you don't like, or something else. You should run it on a test WordPress install to see how it works before running it anywhere near a live site!**
13+
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](http://dentedreality.com.au/2012/10/07/where-is-your-digital-hub-home/).
1414

15-
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?
16-
17-
After an initial import, all of these importers will 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](http://codex.wordpress.org/Post_Formats).
15+
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](http://codex.wordpress.org/Post_Formats), depending on the content type.
1816

1917
Importers included currently:
2018

21-
* [Delicious](http://delicious.com/)
22-
* [Fitbit](http://fitbit.com/)
23-
* [Flickr](http://flickr.com/)
24-
* [Foursquare](http://foursquare.com/)
25-
* [Instagram](http://instagram.com/)
26-
* [Instapaper](http://instapaper.com/)
27-
* [Moves](http://moves-app.com/)
28-
* [TripIt](http://tripit.com/)
29-
* [Twitter](http://twitter.com/)
19+
* [Delicious](https://delicious.com/)
20+
* [Fitbit](https://fitbit.com/)
21+
* [Flickr](https://flickr.com/)
22+
* [Foursquare/Swarm](https://foursquare.com/)
23+
* [Instagram](https://instagram.com/)
24+
* [Instapaper](https://instapaper.com/)
25+
* [Moves](https://moves-app.com/)
26+
* [Nest Cameras](https://nest.com/camera/meet-nest-cam/)
27+
* [Pinterest](https://pinterest.com/)
28+
* [TripIt](https://tripit.com/)
29+
* [Twitter](https://twitter.com/)
3030

31-
You can potentially write your own importers as well, using the base class included.
31+
You can potentially [write your own importers](https://github.com/cfinke/Keyring-Facebook-Importer) as well, using the base class included.
3232

3333
== Installation ==
3434

3535
0. Install and activate the [Keyring plugin](http://wordpress.org/extend/plugins/keyring/), which is required for authentication.
36-
1. Install Keyring Social Importers either via the WordPress.org plugin directory, or by uploading the files to your server
37-
2. Activate Keyring in Plugins > Installed Plugins
38-
3. Go to Tools > Import > (service) and follow the prompts
36+
1. Install Keyring Social Importers either via the WordPress.org plugin directory, or by uploading the files to your server.
37+
2. Activate both plugins via Plugins > Installed Plugins.
38+
3. Go to Tools > Import > (service) and follow the prompts.
3939

4040
== Importers ==
4141

4242
= Common Features =
43-
* If you select to 'auto-import new content', all importers will check once per hour for new content
44-
* A custom field called 'keyring_service' will be stored against each imported item, containing the name of the service used to import the content (e.g. 'twitter', 'instagram')
45-
* Every attempt is made to download/store as much data as possible, and use it intelligently (e.g. tags)
46-
* Raw import data is stored in a custom field ('raw_import_data') as a json_encode()ed string
43+
* If you select to 'auto-import new content', all importers will check once per hour for new content.
44+
* All posts created by the importers are associated with a taxonomy called `keyring_service`, which allows you to filter/select them. Appears in wp-admin as "Imported From" under the Posts menu.
45+
* Every attempt is made to download/store as much data as possible, and use it intelligently (e.g. tags).
46+
* Raw import data is stored in a custom field (`raw_import_data`) as a json_encode()ed string.
4747

4848
= Delicious =
49-
* Every bookmark from your [Delicious](http://delicious.com/) account is imported as a post
50-
* All imported posts are marked with the 'link' Post Format
51-
* delicious_id and the href/link itself are saved as custom fields
52-
* Tags used on Delicious are used in WordPress
49+
* Every bookmark from your [Delicious](https://delicious.com/) account is imported as a post.
50+
* All imported posts are marked with the 'link' Post Format.
51+
* delicious_id and the href/link itself are saved as custom fields.
52+
* Tags used on Delicious are used in WordPress.
5353

5454
= Fitbit =
55-
* Very basic for now, just imports your data and creates a simple summary post
56-
* Summary post only contains a statement about how many steps you took that day
55+
* Very basic for now, just imports your data and creates a simple summary post.
56+
* Summary post only contains a statement about how many steps you took that day.
5757

5858
= Flickr =
59-
* Every photo in your [Flickr](http://flickr.com/) account is downloaded (the actual, original image) and imported into your Media Library
60-
* For every photo, a Post is created and published, containing that one image (and it is attached within WordPress)
61-
* Posts are marked with the 'image' Post Format
62-
* Posts are created with the publish date matching the 'Taken' date of the photo. The modified date (of the Post) is set to the 'Upload' date from Flickr
63-
* There is no support/handling of Galleries, Sets or anything else in Flickr, just one Post per photo
64-
* Tags used on Flickr are used on WordPress
65-
* If available, geo data is downloaded and stored per the [WordPress Geodata guidelines](http://codex.wordpress.org/Geodata)
66-
* flickr_id and the full URL to the photo page are stored as custom fields
59+
* Every photo in your [Flickr](https://flickr.com/) account is downloaded (the actual, original image) and imported into your Media Library.
60+
* For every photo, a Post is created and published, containing that one image (and it is attached within WordPress).
61+
* Posts are marked with the 'image' Post Format.
62+
* Posts are created with the publish date matching the 'Taken' date of the photo. The modified date (of the Post) is set to the 'Upload' date from Flickr.
63+
* There is no support/handling of Galleries, Sets or anything else in Flickr, just one Post per photo.
64+
* Tags used on Flickr are used on WordPress.
65+
* If available, geo data is downloaded and stored per the [WordPress Geodata guidelines](http://codex.wordpress.org/Geodata).
66+
* flickr_id and the full URL to the photo page are stored as custom fields.
6767

6868
= Foursquare =
69-
* Imports each check-in on [Foursquare](http://foursquare.com/) as a separate Post
70-
* Marks those Posts with the 'status' Post Format
71-
* foursquare_id plus geo lat/long are stored as separate custom fields, per the [WordPress Geodata guidelines](http://codex.wordpress.org/Geodata)
69+
* Imports each check-in on [Foursquare](https://foursquare.com/) as a separate Post.
70+
* Marks those Posts with the 'status' Post Format.
71+
* foursquare_id plus geo lat/long are stored as separate custom fields, per the [WordPress Geodata guidelines](http://codex.wordpress.org/Geodata).
7272

7373
= Instagram =
74-
* Each photo on your [Instagram](http://instagram.com/) account is downloaded and imported into your Media Library
75-
* For every photo, a Post is created and published, containing that one image (and it is attached within WordPress)
76-
* Posts are marked with the 'image' Post Format
77-
* The name of the filter used is stored as instagram_filter, the URL to the photo page is stored as instagram_url
74+
* Each photo on your [Instagram](https://instagram.com/) account is downloaded and imported into your Media Library.
75+
* For every photo, a Post is created and published, containing that one image (and it is attached within WordPress).
76+
* Posts are marked with the 'image' Post Format.
77+
* The name of the filter used is stored as instagram_filter, the URL to the photo page is stored as instagram_url.
7878

7979
= Instapaper =
80-
* Requires a [paid account](http://www.instapaper.com/subscription) (to access their API)
81-
* Imports your *Archived* links and creates a post for each of them (with post format of Link)
82-
* Uses the title from the document in Instapaper, if there is a description associated then it uses that as well
80+
* Imports your *Archived* links and creates a post for each of them (with post format of Link).
81+
* Uses the title from the document in Instapaper, if there is a description associated then it uses that as well.
82+
* NEW: Downloads the full content of the article using Instapaper's API, and stores that *in the post content*, so that you can search it later. Disable it by creating a stub plugin, or dropping this in your theme's functions.php; add_filter( 'keyring_instapaper_download_article_texts', '__return_false' );
8383

8484
= Moves =
85-
* Imports your data daily
86-
* Creates a summary post, which is a bulleted list detailing each category of activity for the day
87-
* Stores raw and summary data for further processing
85+
* Imports your data daily.
86+
* Creates a summary post, which is a bulleted list detailing each category of activity for the day.
87+
* Stores raw and summary data for further processing.
88+
89+
= Nest (Camera) =
90+
* Allows you to pick hours of the day to take snapshots from your cameras.
91+
* You can pick anything between no snapshots, or one every hour, per camera.
92+
* Each snapshot will be downloaded directly into your Media Library.
93+
* Each snapshot will also be published as a Post (with post type of "image") using the Author/Category/Tag options you select.
94+
* If you click the "Check For New Content Now" button, when configured for auto-import, then all cameras with at least one scheduled snapshot will take one right now, regardless of what time they're scheduled (good for verifying that things work, or taking a specific snapshot for whatever reason).
95+
* Does not require a Nest Aware subscription, since the relatively infrequent snapshots are under request limits.
96+
97+
= Pinterest =
98+
* NEW: This is a new addition, and is pretty rough still. Not recommended for production sites.
99+
* Imports every individual pin as a post (can be a LOT), with a Post Format of "image".
100+
* Stores the image for each pin in your Media Library.
88101

89102
= TripIt =
90-
* Trips are imported, with flights mapped and posted as Status-format posts
91-
* Geo data is stored using something resembling the [WordPress Geodata guidelines](http://codex.wordpress.org/Geodata)
92-
* Posts are tagged using airport codes and city names
93-
* Now supports paging through the API to avoid timeouts on accounts with lots of trip data
103+
* Trips are imported, with flights mapped and posted as Status-format posts.
104+
* Geo data is stored using something resembling the [WordPress Geodata guidelines](http://codex.wordpress.org/Geodata).
105+
* Posts are tagged using airport codes and city names.
106+
* Now supports paging through the API to avoid timeouts on accounts with lots of trip data.
94107

95108
= Twitter =
96-
* Every [tweet](http://twitter.com/) will be downloaded as an individual Post
97-
* Posts are marked with the 'aside' Post Format
98-
* If available, geo data is downloaded and stored per the [WordPress Geodata guidelines](http://codex.wordpress.org/Geodata)
99-
* Twitter_id and twitter_permalink are stored
100-
* If your tweet contains #hashtags, they are applied as tags within WordPress
101-
* "Entities" are expanded (URLs are not t.co, they are the real/final URLs)
109+
* Every [tweet](https://twitter.com/) will be downloaded as an individual Post.
110+
* Posts are marked with the 'aside' Post Format.
111+
* If available, geo data is downloaded and stored per the [WordPress Geodata guidelines](http://codex.wordpress.org/Geodata).
112+
* Twitter_id and twitter_permalink are stored.
113+
* If your tweet contains #hashtags, they are applied as tags within WordPress.
114+
* "Entities" are expanded (URLs are not t.co, they are the real/final URLs).
102115

103116
== Changelog ==
117+
118+
= 1.6 =
119+
* NOTE: Update to Keyring 1.7 for full compatibility.
120+
* Enhancement: Nest Camera importer.
121+
* Enhancement: Pinterest importer.
122+
* 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' );
123+
* Enhancement: Compatible with [People & Places](https://github.com/beaulebens/people-places) (must be installed manually currently) to associate people and places across all services under a single taxonomy.
124+
* Enhancement: 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.
125+
* Enhancement: Bundle Reprocessors to fix an old encoding bug, plus to process Twitter, Instagram and Foursquare imports for People & Places.
126+
* Enhancement: Default the UI to save imported content against the current user/author.
127+
* Enhancement: Link back to the importer on the success screen.
128+
* 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.
129+
* Bugfix: Remove a bunch of unused global variables.
130+
131+
104132
= 1.5 =
105133
* NOTE: Update Keyring to 1.6.2 for best results
106134
* 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.

0 commit comments

Comments
 (0)