An Entanglement is a reusable combination of an Entangler Action and zero or more arguments. The Entanglements menu can be accessed by tapping the Entanglement icon at the bottom left corner of Entangler on your iOS device:
Currently, there are three types of Entanglements:
|X-Callback-URL||An Entanglement intended to be used with apps which support X-Callback-URL. Once an X-Callback-URL Entanglement is created, you can copy the URL and paste it into the other app.|
|Action||Action Entanglements are made available in other apps through iOS's Action Extensions.|
|Watch||Allows you to trigger Entangler Actions from your Watch.|
NOTE: X-Callback-URL support is disabled in Entangler 2.0, but it is fixed in Entangler 2.0.1, which is now available from the App Store.
To create a new X-Callback-URL Entanglement, tap the Entanglements button, select X-Callback-URL Entanglements, then tap the + button at the top right of the screen. A list of all of your available actions will appear. Once you’ve selected the action you wish to trigger with this Entanglement, the Entanglement Editor will appear:
The Success URL and Error URL entries will be used to populate X-Callback-URL’s x-success-url and x-error-url, respectively. Any additional arguments you wish passed in to Entangler can optionally be added by tapping the Add argument button.
While adding arguments, a row of buttons appears above the keyboard. These buttons represent various shortcuts which can be included in the URL. Some of these are built in to Entangler and will be replaced by Entangler when the URL is used. More information about the built in shortcuts can be found in Getting Started. In addition, there are several app-specific shortcuts which will insert tokens for some popular X-Callback-URL apps (currently only Launch Center Pro, but others will be added). The meaning of these shortcuts depends on the respective app.
Once you are happy with the arguments for your Entanglement, tap Save and you will be returned to the list of X-Callback-URL Entanglements. Below the icon for the Entanglement is a button, Copy URL. Tapping this button will copy the URL to your pasteboard so that you can paste it in to the app you wish to use the Entanglement with.
Note that the X-Callback-URL Entanglements are saved as a convenience so that you can edit and copy them as needed. However, the X-Callback-URLs will continue to function even if the Entanglement is removed. This also means you can edit the URL to your liking in the app of your choosing, though please note that Entangler has no way of knowing if you have done so.
Action Entanglements allow you to trigger your actions from any app which supports exporting textual data via iOS’s Action Extension mechanism. With an Action Entanglement, the data exported from the app can be passed to your action as an argument. You can also hard code any additional arguments which your action needs to function.
To create a new Action Entanglement, tap the Entanglements button, select Action Entanglements, then tap the + button at the top right of the screen. A list of all of your available actions will appear. Once you’ve selected the action you wish to trigger with this Entanglement, the Entanglement Editor will appear:
When you tap Add argument, the keyboard will appear, along with a row of shortcut buttons. Most of the buttons are documented in Getting Started, but there is one specific to Action Entanglements: Selected Data. This shortcut will be replaced with whatever textual data the app you trigger the Entanglement from supplies. For example, Mobile Safari will provide the URL for the page you are currently viewing. Please consult the documentation for any app you wish to use the Action Entanglement with to determine what information is passed to the Action Extension.
In most cases, the Selected Data shortcut should appear in exactly one argument. For example, using the Open in Browser action from the Action Gallery, a completed Action Entanglement to open the page you are viewing in Mobile Safari would look like this:
Once you are done, tap Save and the Entanglement will become available in the Entangler Action Extension.
For more information about using the Entangler Action Extension, see Action Extension.
Watch Entanglements put the power of Entangler on your wrist. In order to create a Watch Entanglement, you must have an Watch paired with your iOS device and must have launched the Entangler Watch app at least once. To create a new Watch Entanglement, tap the Entanglements button, select Watch Entanglements, then tap the + button at the top right of the screen. A list of all of your available actions will appear. Once you’ve selected the action you wish to trigger with this Entanglement, the Entanglement Editor will appear:
As with the other types of Entanglements, you can supply arguments to be passed to your action. There are a number of shortcuts, most of which are described in Getting Started. In addition, there is a shortcut called Prompt, which will cause a prompt to appear on your Watch when triggering the Entanglement. The prompt includes choices for the current date or time, as well as a voice dictation option.
You can add as many Prompt shortcuts to your Entanglement as you want, however it is strongly recommended that you only use one. When there are multiple Prompt shortcuts, your Watch will present them each in turn. There is currently no indication of which Prompt shortcut you are filling in at any given moment, so it may be confusing. If you must use multiple Prompt shortcuts, remember that they will be filled in in the order in which they appear in the arguments, from first to last.