Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

This page teaches you have to create links to content within the portal. This technique may also be referred to as external linking or deep linking.

Dumb links

You can link to a portlet or channel using the functional name like so:

Panel

https://myportaldev.calpoly.edu/tag.idempotent.render.userLayoutRootNode.uP?uP_fname=single-click

However, this only works as long as the user has a session or the channel is available in the Guest layout.

Authenticated links

To create a link that forces the user to authenticate through CAS and works whether the user has a session or not, do this:

Panel

https://YOUR_CAS_SERVER/cas/login?service=https://YOUR_PORTAL_SERVER/Login?uP_fname=YOUR_CHANNEL_FNAME

The Login servlet looks for the uP_fname parameter and passes your user to that channel after authenticating.

Adding parameters

As of uPortal 3.0.4 and 3.1.0 (See UP-2308) the Login servlet passes any other parameters on to your channel.

Panel

https://YOUR_CAS_SERVER/cas/login?service=https://YOUR_PORTAL_SERVER/Login?uP_fname=YOUR_CHANNEL_FNAME%26param1=value1%26param2=value2

Note

Make sure to encode ampersands with %26, otherwise /cas/login will eat up your additional parameters without passing them to your service url; it doesn't hurt to url encode your entire service parameter either

Old Information

Tip
iconfalse

For more information, see ~awp9's blog post on addressing channels by functional name.
Some of the links in this post are dead.