Tumblr Crosspostr

Tumblr Crosspostr posts to Tumblr whenever you hit the "Publish" (or "Save Draft") button. It can import your reblogs on Tumblr as native WordPress posts. It even downloads the images in your Photo posts and saves them in the WordPress Media Library.

• Transform your WordPress website into a back-end for Tumblr.
• Create original posts using WordPress, but publish them to Tumblr.
• Import your Tumblr reblogs automatically.
• Always have a portable copy (a running backup) of your entire Tumblr blog.

Donations for this plugin make up a chunk of my income. If you continue to enjoy this plugin, please consider making a donation. :) Thank you for your support! Tumblr Crosspostr uses Tumblr's simple API to keep posts in sync; when you edit your WordPress post, it updates your Tumblr post. Private WordPress posts become private Tumblr posts, deleting a post from WordPress that you've previously cross-posted to Tumblr deletes it from Tumblr, too, and so on. The plugin supports both scheduled posts (scheduling a WordPress post schedules it to publish at the same time on Tumblr) as well as the Tumblr Queue feature. Tumblr Crosspostr is very lightweight. It just requires you to connect to your Tumblr account from the plugin options screen. After that, you're ready to cross-post! See the Screenshots for a walk through of this process. Tumblr Crosspostr uses post formats to set the appropriate Tumblr post type. The first image, video embed, etcetera that Tumblr Crosspostr detects will be used as the primary media for the Tumblr post type. To take full advantage of Tumblr Crosspostr, I suggest you choose a WordPress theme that supports all the post formats that your Tumblr theme supports, but Tumblr Crosspostr will still work even if your theme does not natively support this feature. :) The WordPress post format to Tumblr post type mapping looks like this:

• WordPress's Standard, Aside, and Status post formats become Tumblr's Text post type
• WordPress's Image post format becomes Tumblr's Photo post type
• WordPress's Video post format becomes Tumblr's Video post type
• WordPress's Audio post format becomes Tumblr's Audio post type
• WordPress's Quote post format becomes Tumblr's Quote post type
• WordPress's Link post format becomes Tumblr's Link post type
• WordPress's Chat post format becomes Tumblr's Chat post type
• WordPress's Gallery post format becomes Tumblr's Photoset post type (sadly this is not yet implemented, but maybe one day soon!!)

Other options enable tweaking additional metadata from your WordPress entry (notably tags and "Content source" attributions) to Tumblr, sending all your post archives to Tumblr in one click, and more.

Servers no longer serve, they possess. We should call them possessors.

--Ward Cunningham Learn more about how you can use this plugin to own your own data in conjunction with the "Bring Your Own Content" self-hosted Web publishing virtual appliance.

1. Download the plugin file.
2. Unzip the file into your 'wp-content/plugins/' directory.
3. Go to your WordPress administration panel and activate the plugin.
4. Go to Tumblr Crosspostr Settings (from the Settings menu) and either create or enter your Tumblr OAuth consumer key and consumer secret. Then click "Save Changes."
5. Once you've entered your consumer key and consumer secret, a "Connect to Tumblr" button will appear. Click that to be redirected to Tumblr's authorization page.
6. Click "Allow" to grant access to your blog from Tumblr Crosspostr.
7. Start posting!!!

See also the Screenshots section for a visual walk through of this process. Installation notes and troubleshooting Tumblr Crosspostr makes use of Manuel Lemos's oauth_client_class for some core functions. Most systems have the required packages installed already, but if you notice any errors upon plugin activation, first check to ensure your system's PHP include path is set correctly. The lib directory and its required files look like this: lib ├── OAuthWP.php ├── OAuthWP_Tumblr.php ├── TumblrCrosspostrAPIClient.php ├── httpclient │   ├── LICENSE.txt │   └── http.php └── oauth_api ├── LICENSE ├── oauth_client.php └── oauth_configuration.json It's also possible that your system administrator will apply updates to one or more of the core system packages this plugin uses without your knowledge. If this happens, and the updated packages contain backward-incompatible changes, the plugin may begin to issue errors. Should this occur, please file a bug report on the Tumblr Crosspostr project's issue tracker. If images are not posting correctly please check that your WordPress blog is not using HTTPS. The Tumblr API does not support HTTPS image sources via the API.

Maintaining this plugin is a labor of love. However, if you like it, please consider making a donation for your use of the plugin, purchasing one of Meitar's web development books or, better yet, contributing directly to Meitar's Cyberbusking fund. (Publishing royalties ain't exactly the lucrative income it used to be, y'know?) Your support is appreciated! Developer reference Tumblr Crosspostr provides the following hooks for plugin and theme authors: Filters

• tumblr_crosspostr_save_post_types - Filter an array of custom post type names to process when Tumblr Crosspostr is invoked in the save_post WordPress action.
• tumblr_crosspostr_meta_box_post_types - Filter an array of custom post type names for which to show the Tumblr Crosspostr post editing meta box.
• tumblr_crosspostr_prepared_post - Filter the $prepared_post object immediately before it gets crossposted to Tumblr

Actions

• tumblr_crosspostr_reblog_key - Prints the Tumblr Reblog Key for a given post.

0.9

• Feature: Scheduled posting support.
• Feature: Option to "leave no trace" when uninstalling the plugin. This is dangerous and off by default. It will permanently erase all associations between your WordPress posts and your Tumblr posts, deleting all Tumblr-relatd metadata for your WordPress content.

0.8.8 Bugfix: Quiet duplicated network requests to Tumblr's /user/info API endpoint. 0.8.7

• Feature: Use Tumblr's native_inline_images to avoid the "External image" display on the Tumblr Dash. (Props @jeraimee.)

0.8.6

• Bugfix: Correctly translate WordPress <!-- more --> link to Tumblr's equivalent.

0.8.5

• Bugfix: Recognize audio generated from WordPress shortcodes.
• Usability: Nicer styles for the plugin's settings screen.
• Developer: Update libraries (this fixes several outstanding bugs that were present in the packaged library versions).

0.8.4

• Bugfix: Fix "invalid argument" error for some people when they first install the plugin.
• Bugfix: Strip HTML tags from titles on Tumblr posts.
• Bugfix: Fix "undefined index" error for installations in strict environments when the tweet option is enabled but the tweet text is left blank.
• Bugfix: Fix several other "undefined index" errors at various locations on the plugin's settings screen.
• Tested for compatibility with WordPress 4.3.

0.8.3

• Feature: When importing a Photo post from Tumblr, the photo in the Tumblr post becomes the Featured Image of the WordPress post. This only happens when a Tumblr post contains a single photo.
• Compatibility with WordPress 4.2.x's new PressThis bookmarklet.

0.8.2

• Bugfix: Typo caused "View post on Tumblr" buttons to break. My bad. ^_^;

0.8.1

• Feature: Support rel-syndication IndieWeb pattern as implemented by the recommended Syndication Links plugin.
• rel-syndication is an IndieWeb best practice recommendation that provides a way to automatically link to crossposted copies (called "POSSE'd copies" in the jargon) of your posts to improve the discoverability and usability of your posts. For Tumblr Crosspostr's rel-syndication to work, you must also install a compatible WordPress syndication links plugin, such as the Syndication Links plugin, but the absence of such a plugin will not cause any problems, either.

0.8

• Feature: Option to cross-post any post type. Not all post types can be crossposted safely, but many can, especially if they use default WordPress features like "title" and "excerpt" and so on. On important websites, don't enable crossposting for post types whose compatibility with Tumblr you are not sure of, or at least make sure you have a backup you can restore from. :)
• Developer: Three new filter hooks allow you to create your own custom post types that will be sent to Tumblr:
• Use the new tumblr_crosspostr_save_post_types filter hook to programmatically add custom post types to be processed by Tumblr Crosspostr during WordPress's save_post action.
• Use the new tumblr_crosspostr_meta_box_post_types filter hook to programmatically add or remove the Tumblr Crosspostr post editing meta box from certain post types.
• Use the new tumblr_crosspostr_prepared_post filter hook to programmatically alter the $prepared_post object immediately before it is crossposted to Tumblr.
• Bugfix: First-time sync's now import all intended posts even when some posts are not public on Tumblr. Additionally, much-improved debug logging offers an easier way to trace sync problems.
• Bugfix: Repeated sync's no longer cause duplicated posts on PHP less than 5.4.

Version history has been truncated due to WordPress.org plugin repository readme.txt file length limitations. For historical change log information, please refer to the plugin source code repository.