How do I link to a specific tab, page, session (or list of sessions), exhibitor, speaker, or abstract in the Online Planner for my marketing?

Modified on Wed, 22 Apr at 11:15 AM

If you would like to add links to your website or marketing emails that open the Online Planner to a specific view rather than the Home tab, follow the instructions below. 




URL that opens a particular tab in your Itinerary Planner 

Imagine, we wanted a link the opens our Planner directly to the Program


  1. In the Conference App Builder > Design > Tab Layouts > Planner Tabs, you will see the tab layout editing option with the label, the tab action, if it is enabled or hidden, and also a copy icon.
  2. Click the copy icon to copy the URL to your clipboard
  3. Paste the link in a new browser window to test it - it should open to the correct planner tab


The tab must be enabled in order to link to it. 




Link to a Planner Tab from a button on the Itinerary Planner Home Screen


When building your home screen for the Planner, you can link a button directly to a tab: 


  1. In the Conference App Builder, navigate to Design > Home Screens
  2. Select the tab Planner Home 
  3. Click the Edit Planner Home Screen button
  4. Click the Pencil icon on the button object that you wish to link to a tab 
  5. Choose Planner Tab and then select which of your active tabs should open

    Note: The tab must be an enabled visible tab. If you disable the tab, the button will not be able to link to it.

  6. Publish to proof and test your new link that now jumps directly to the specified tab in the planner.


You can control the available planner tabs via Design > Tab Layouts > Planner Tabs


URL that loads a custom view page in the Itinerary Planner

You can construct a specific URL with just a few parameters. Imagine, you'd like to encourage your exhibitors to post any open positions in the job board before the conference starts. You'd want to send them a link that opens the Jobs Discussion Board directly within the itinerary planner. 


The URL structure would be: 

https://server.ativ.me/web/planner.php?id=CONFID&table=custom&tid=customviewid


How to construct this URL

  1. Find the server and CONFID
    1. In the App Builder, navigate to Distribution > Attendee Links and open the Desktop Planner Link
    2. The address bar will show you the server and your event ID (CONFID)

  2. Find the ID of your custom view
    1. In the App Builder, navigate to Design > Custom Views and find the view you'd like to link to
    2. On the right hand side, you will see the ID of the custom view
  3. Putting it all together
    1. Fill in the server, CONFID, and custom view id
      https://server.ativ.me/web/planner.php?id=CONFID&table=custom&tid=customviewid
      https://eppro01.ativ.me/web/planner.php?id=EPDEMO&table=custom&tid=chatjobs
  4. Try it out
    1. click the link https://eppro01.ativ.me/web/planner.php?id=EPDEMO&table=custom&tid=chatjobs 


URL to a specific session (or a set of sessions), speaker, exhibitor, or abstract in the Itinerary Planner

For marketing purposes, you may want to link directly to a specific session / speaker / exhibitor / abstract in the Online Planner. With a special link, the Online Planner can open the detail view for an item overlaid while giving easy access to the full planner (simply click outside the overlay to access the planner). 




You can modify your Online Planner URL to open to a particular item by following these steps: 



Look up the ID and Table


  1. In the Conference App Builder (CMS), open the tab that has the content you ultimately want to link to e.g. 
    1. Agenda sessions
    2. Speakers
    3. Exhibitors
  2. Search for the actual record to find the item's unique ID
    For example: you want to go to the session called Vascular Aging - Can We Slow It Down?  - go the Agenda Sessions tab and search for the title and find the item ID displayed on the right hand side below the edit symbol. In this case S38. Note: record IDs are case sensitive, so you must use S38 and not s38. 



Build Your URL


Single Record

  1. Open your Planner link and copy / paste the URL. For example:
    https://eppro01.ativ.me/web/planner.php?id=ABC27
    Ensure you copy your own planner link as the domain could be different from the example above. 
  2. Then add the following two parameters: 
    1. &table=
      possible tables are:
      agenda
      speakers
      exhibitors

      In our example, we were looking for a session, so we use agenda 
    2. &tid= where you add the item ID you looked up earlier which was S38 in our example
  3. Let's put it all together into one URL:
    https://eppro01.ativ.me/web/planner.php?id=ABC27&table=agenda&tid=S38


List of Sessions or Exhibitors

Multiple Sessions

For a list of multiple sessions, add the individual IDs using a pipe separator: 

https://eppro01.ativ.me/web/planner.php?id=ABC27&table=agenda&tid=S38|P2323|A1341|D101


Multiple Exhibitors

For a list of multiple exhibitors, add the individual IDs using a pipe separator: 

https://eppro01.ativ.me/web/planner.php?id=ABC27&table=exhibitors&tid=1001|5001|3498


Single Abstract in the Planner

If you need to link to an abstract, use table=IntHtml
e.g. https://eppro01.ativ.me/web/planner.php?id=ABC27&table=IntHtml&tid=101


Please Note: Linking to media items is only supported for items of type int/html. All other items, you must link to the session or exhibitor who have the media item in their detail view. 






FAQ

Can I disable a planner tab and still link to it? 

The links can only function to open active or visible tabs. So if you toggle the specific tab to OFF in the Planner Tabs page in the Conference App Builder, then your link will not open as you effectively removed the tab.