Interactively helps you form links/x-callback-urls (and also Template Tags with runPlugin commands) to perform actions from within NotePlan or between other applications and NotePlan.
X-Callback-URLs are extremely useful. They can be used to create links which open notes and perform actions from inside of NotePlan. They also allow you to automate things inside of NotePlan from Shortcuts or other apps. How to use X-Callback-URLs is covered in the documentation, but creating the URLs can be a little challenging. Hence why this wizard was created. It helps take some of the guesswork out of creating URLs that you can use to open notes, run plugins, etc.
The simplest use case is to create a link to the currently-open document and the currently-selected heading level (e.g. a link to block).
You can run this command directly by running the commmand:
/Create Link to Current Note+Heading
As you can see from the documentation, there are lots of different types of callbacks.
Invoke the wizard by typing the /Get X-Callback-URL command. You will be walked through creating the X-Callback-URL. In the final step, you will be asked what type of output you want:
The result will be pasted in your Editor at the cursor location.
Sometimes you don't want to have to click a link, but rather, you want a certain plugin command to run when you insert/append/invoke a Template (using np.Templating). You can also use the wizard to create a template tag for running the plugin. Simply go through the same X-Callback flow, and at the very end, you will be given the choice to paste the link optionally as a Templating tag, like this:
<% await DataStore.invokePluginCommandByName("Remove All Previous Time Blocks in Calendar Notes Written by this Plugin","dwertheimer.EventAutomations",["no"]) -%>
By selecting the option "Run Template", you can use Templating2.0+'s feature of self-running templates. These special type of templates can be invoked via URL. The "Run a Template" command in this plugin will walk you through the creation of a self-running template and the link to call it (both of which you can edit later)
Field names can be sent in the URL to your template as key=value pairs, separated by semicolons.
Commands are:
/open todos containing links in browser - will open any URLs found in the current document's OPEN todos (or open checklist items)/open URL on this line - will open any url on the line the cursor is currently onIf you are interested in the other types (not implemented yet), please comment on This Plugin's Discord Thread to let us know which of the above you are most interested in. It will help us prioritize future releases.