How do I create a direct link to a page of the platform?
A direct link opens a specific module, list or item of the platform, for example a Learn category or a mission. Use it in newsletters, emails, news articles or buttons.
Build the link in three steps
Start with your platform's address and the module: https://yourplatform.gfoundry.com/app/learn
Add what to open, after a question mark: ?opencategorywithid=8328
End with #externalRouting. Without it, the link opens the module's main page instead.
Where do I find the ID or token?
Open the item in the Backoffice and look at the page's address:
Options ending in withid need an ID, a number. For example, a category at …/backend.php/learn/categories/8328 has the ID 8328.
Options ending in withtk need a token, a long code of letters and numbers. For example, a mission at …/backend.php/missions/28d7c069905c59ee6cbb1d92b5aac324 has the token 28d7c069905c59ee6cbb1d92b5aac324.
Options ending in =1 open a list or page and need no ID.
The most used links
A Learn category: /app/learn?opencategorywithid=ID#externalRouting
A Learn Content: /app/learn?openpreviewwithid=ID#externalRouting
A training program: /app/learn?opencoursepreviewwithid=ID#externalRouting
The list of training programs: /app/learn?opencourseslist=1#externalRouting
A mission: /app/home?willopenmissionwithtk=TOKEN#externalRouting. It opens the home page with the mission on top.
A news article: /app/users?opennewsdetailswithid=ID#externalRouting
A survey: /app/home?opensurveywithtk=TOKEN#externalRouting
All options by module
/app/learn
opencategorywithid=ID: a category
openpreviewwithid=ID: a Learn Content
opencoursepreviewwithid=ID: a training program
opencourseslist=1: the list of training programs
opencatalogue=1: the catalogue
openbattlelistoftype=0, 1 or 2: battles pending, to accept, or finished
openbattleresultswithid=ID: the results of a battle
/app/home
openhome=1: the home page
openprofile=1: the user's profile
willopenmissionwithtk=TOKEN: a mission
opensurveywithtk=TOKEN: a survey
/app/users
opennewslist=1 and opennewsdetailswithid=ID: the news list and a news article
openeventslist=1 and openeventdetailswithid=ID: the events list and an event
openmissionslist=1: the list of missions
openusersdirectory=1: the users directory
openusersdirectorywithname=First%20Last: the users directory searching a name (use %20 for spaces)
openusercertificates=1: the user's certificates
opennotificationslist=1: the notifications
openfaqslist=1: the FAQs
openredeemvoucher=1: redeem a voucher
/app/recognition
openmyrecognitions=1: my recognitions
openusersearch=1: search a person to recognise
/app/goals
opengoalwithid=ID: a goal
openmygoalslist=1: the user's goals
/app/evaluation
openevaluationcyclewithtk=TOKEN: an evaluation cycle
opentouchpointwithtk=TOKEN: a Touchpoint
/app/feedback
opengivefeedbacks=1: give feedback
openrequestfeedbacks=1: request feedback
requestedfeedbackwithid=ID and receivedfeedbackwithid=ID: a requested or received feedback
Other modules
/app/competitions: opencompetitionwithtk=TOKEN (a competition), showmorecompetitions=1 (the user's competitions)
/app/contribute: opencontributewithtk=TOKEN (a contribution), newcontributewithtypetk=TOKEN (a new contribution of a type)
/app/innovation: openideawithtk=TOKEN (an idea), newideawithtypetk=TOKEN (a new idea of a type), openuserideaslist=1 (the user's ideas)
/app/tasks: opentaskwithtk=TOKEN (a task), opentaskslistwithtk=TOKEN (a task list)
/app/okrs: openobjective=ID (an objective), opencheckin=overdue (overdue check-ins)
/app/thermometer: openinsightsurveys=1 (the insight surveys)
A button inside platform content
Inside platform content, such as an HTML block, a button can open a Learn category without leaving the page:
<a data-route='routing=learn&opencategorywithid=ID' href='javascript:void(0)' class='g-link g-route'>Button text</a>
Before you send it
Test the link with a user who should see the item.
The link only opens what the user can already see. Content segmented for other groups stays hidden.
The user has to be signed in to the platform.
If you need a page that is not listed here, contact Support.