x-callback-url Support

Story Planner for iOS now supports x-callback-urls, with actions such as opening an existing project or creating a new project from another apps.

URL Format

The format for Story Planner's URL scheme is:

storyplanner://x-callback-url/[action]?[x-callback parameters]

Remember that in [x-callback parameters] any whitespace must be replaced with the parameter %20 or the URL won't work.

Actions

Remember that you don't need an action to open the app. You just need to use the URL:

storyplanner://x-callback-url/

add

Add a new project

storyplanner://x-callback-url/add?title=[title]

Example:

storyplanner://x-callback-url/add?title=The%20Master%20Cat

project

Open an existing project.

You can open it by using the parameters below:

- by title:

storyplanner://x-callback-url/project?title=[title]

- by identifier

storyplanner://x-callback-url/project?id=[id]

You can get the identifier within the project by opening export options and choosing 'Copy identifier'


You can also add to the previous urls the tab you want to open within the project by using the tab parameter (replacing [tab] for characters, locations, scenes or plots):

storyplanner://x-callback-url/project?title=[title]&tab=[tab]

Example:

storyplanner://x-callback-url/project?title=The%20Master%20Cat%tab=characters