How to :: navigate with stories

LinkTo overview

A story can be linked to one or two stories or the home page with the linkTo option. You can even use external links! 🔥

link To

link To

Warning

This feature is powerful, but it can make the navigation inside of your application confusing. As a result, we’ve limited the number of links to two.

Configuration

Warning

This option is only available from the code mode

You can use html syntax for the legend (this allow to add pictograms for example): <i class="fa fa-list" aria-hidden="true"></i> Go to list view

The link buttons and the story narrative are at the same position. Do not use both on the story. Also, make sure to test it on mobile as well 📱

Link to a story

If you’d like to link a story to another story, there are only three parameters you need to setup:

  • type: has to be slide
  • legend : the text that will be displayed in a button
  • id: type in the story’s id. It can be found in the url of your story
linkTo:[
  type: 'slide'
  legend: "Go to list view"
  id: 30002
,
  type: 'slide'
  legend: "Go to shop ranking"
  id: 40002
]

Link to a story with filters or requesters configuration

Let say your story redirects to another story, but this story contains filters or requesters and you want your users to arrive on a specific filter/requester selection.

You can add a filters or requesters parameter.

linkTo:[
  type: 'slide'
  legend: "Go to shop list"
  id: 30002
  filters:
    filter_column: 'filter_selection'
  requesters:
    requester_id: 'requester_selection'
]

Just make sure to replace filter_column or requester_id with the name of the filter column or requester id you wish to filter your linked story with. And replace filter_selection or requester_selection with the wanted value taken by the filter or requester.

Note

If you are using the “make all columns available” option with your requester, make sure to use to also declare the column of the requester’s dataset you want to use like this : requester_id: {   "requester_column": "requester_selection"   }

For example, I want my users to be redirected to a story where the filter is on France. As this information is contained in my country column (also used as the filter), this is how my config should look like:

linkTo:[
  type: 'slide'
  legend: "Go to shop list"
  id: 30002
  filters:
    country: 'France'

]

Link to a story while resetting app requesters to their default value

Let’s say you have setup app requesters (date, report) on your small app. You might want to redirect to a story while resetting to the default value for the app. This default value may vary from user to user, so we’ve added a key word to tell the application to go back to the default value for the user.

Simply use the resetToDefault keyword in your configuration:

linkTo: [
  type: 'slide'
  legend: "Go to shop list"
  id: 30002
  requesters:
    report: 'resetToDefault'
    date: 'resetToDefault'
]

You can even use that as a shortcut to the current story, to reset the app requesters quickly:

id: 123123
linkTo: [
  type: 'slide'
  legend: "Reset the date"
  id: 123123 # <- Use the same id as the current slide
  requesters:
    date: 'resetToDefault'
,
  type: 'slide'
  legend: "Reset the report"
  id: 123123 # <- Use the same id as the current slide
  requesters:
    report: 'resetToDefault'
]