Ashes

Share Anywhere

Share Anywhere allows you to add inter-app communication to Ashes. If an app, take Tumblr, supports openURL, we can easily create a URL to send info from Ashes to Tumblr. tumblr://x-callback-url/link?title=[[[title]]]&url=[[[url]]]&description=[[[textselection]]]&x-success=[[[callback]]]&x-cancel=[[[callback]]]

See the list of variables below and learn how to add a Share Anywhere link to Ashes.

Variables

[[[title]]] — either the item title or browser title

[[[feedtitle]]] — title of item's feed; empty in browser

[[[url]]]

[[[textselection]]] — the current text selection from the article or browser; if no selection is available, an empty string is used

[[[post]]] — if text is selected: “[[[textselection]]]” via [[[feedtitle]]] [[[url]]]; and if no selection: [[[title]]] [[[url]]]

[[[callback]]] — use this for x-callback-url methods to be sent back to Ashes

Putting it Together

So here is the example from above. Let’s look through this again.

tumblr://x-callback-url/link?title=[[[title]]]&url=[[[url]]]&description=[[[textselection]]]&x-success=[[[callback]]]&x-cancel=[[[callback]]]

Tumblr's iOS app has x-callback-url support and the ability to create text, link, and quote posts via this URL. The above URL will send the current title [[[title]]] (either in the Browser or an Item view) and the url [[[url]]] along with the current text selection [[[textselection]]] for a description. Once you are done in Tumblr (by posting or canceling) you'll be sent back to Ashes [[[callback]]].

So how do I add this to Ashes?

Ashes too has a URL for communication. You can easily send a URL with a title— which used for the share button— to Ashes. To do so, you must encode the URL above, which looks like:

tumblr%3A%2F%2Fx-callback-url%2Flink%3Ftitle%3D%5B%5B%5Btitle%5D%5D%5D%26url%3D%5B%5B%5Burl%5D%5D%5D%26description%3D%5B%5B%5Btextselection%5D%5D%5D%26x-success%3D%5B%5B%5Bcallback%5D%5D%5D%26x-cancel%3D%5B%5B%5Bcallback%5D%5D%5D

That's ugly, I know. So we take that and create an Ashes Share Anywhere link:

ashes://addOpenURL?title=Share%20Link%20with%20Tumblr&url=tumblr%3A%2F%2Fx-callback-url%2Flink%3Ftitle%3D%5B%5B%5Btitle%5D%5D%5D%26url%3D%5B%5B%5Burl%5D%5D%5D%26description%3D%5B%5B%5Btextselection%5D%5D%5D%26x-success%3D%5B%5B%5Bcallback%5D%5D%5D%26x-cancel%3D%5B%5B%5Bcallback%5D%5D%5D

The highlighted parts are the title and URL for the Share Anywhere link. It is this easy.

I dunno… Do you have any examples?

Any of the following can be clicked on your iOS device and they'll add the Share Anywhere link to Ashes.

Share by Mail

ashes://addOpenURL?title=Share%20by%20Mail&url=mailto%3A%3Fsubject%3D%5B%5B%5Btitle%5D%5D%5D%26body%3D%5B%5B%5Bpost%5D%5D%5D

Share by Sparrow Mail

ashes://addOpenURL?title=Share%20by%20Sparrow%20Mail&url=sparrow%3A%2F%2F%3Fsubject%3D%5B%5B%5Btitle%5D%5D%5D%26body%3D%5B%5B%5Bpost%5D%5D%5D

Share with Pushpin

ashes://addOpenURL?title=Share%20with%20Pushpin&url=pushpin%3A%2F%2Fx-callback-url%2Fadd%3Furl%3D%5B%5B%5Burl%5D%5D%5D%26title%3D%5B%5B%5Btitle%5D%5D%5D

Share Link with Tumblr

ashes://addOpenURL?title=Share%20Link%20with%20Tumblr&url=tumblr%3A%2F%2Fx-callback-url%2Flink%3Ftitle%3D%5B%5B%5Btitle%5D%5D%5D%26url%3D%5B%5B%5Burl%5D%5D%5D%26description%3D%5B%5B%5Btextselection%5D%5D%5D%26x-success%3D%5B%5B%5Bcallback%5D%5D%5D%26x-cancel%3D%5B%5B%5Bcallback%5D%5D%5D

Share Quote with Tumblr

ashes://addOpenURL?title=Share%20Quote%20with%20Tumblr&url=tumblr%3A%2F%2Fx-callback-url%2Fquote%3Fquote%3D%5B%5B%5Btextselection%5D%5D%5D%26source%3D%5B%5B%5Btitle%5D%5D%5D%2520-%2520%5B%5B%5Burl%5D%5D%5D

I added one but don’t want it now!

It happens. Swipe to delete it from Settings / Sharing.