HTML Render Login Link

Linked Help

 

 

Overview 

The Render Login Link is a means of providing a simple link to your account holders, to click and visit your website already logged in.  Usually they are included in emails, to take people directly to a private page that only logged in users can access.

You can set the page to take the User to, the amount of time the link is active, the text of the link, and any objects that you want to pass to the page. They do NOT expose the username / password but instead work with a system generated "security ticket", matched up to the User Account, lastng for as long as configured on the Render Login Link.

Guidance

To create a "render login link", you have to input the link described below, into the webpage using the function designer on the HTML editor's "Advanced" tab, as you would for any other function. You will see it in the content in the format below.  But when this is viewed by a logged in user, they will see a link, with a message that, when they click it, will log them into your website - onto the target web page.

YOU MUST EDIT USING THE FUNCTION EDITOR! Any editing done outside of the function editor may introduce styling that breaks the link!

The editor should look like this:

The format to create a rendered login link is

!!RENDERLOGINLINK([!User#ObjectId!], a, b, c, d)

XPOR will automatically merge in the User#ObjectId. For example, if the link is being used on an email that you are sending from XPOR to one of your Users, then, as XPOR creates the email, it sees the Render Login Link and merges in the ObjectId of the "Sent to" User Account.  It then goes one step further and generates a "Security ticket" - which links to the User Account. This security ticket is then built into the Render Login link, to replace the Users account details (Username / Password) - keeping them safe from inspection! 

The subsequent options are shown above as a, b, c and d;

  • a - The amount of time the link is active, in minutes (this is the "life" of the security ticket).
  • b - The object ID of the page that the link goes to.
  • c - What you want the link to say (for example "Click Here")
  • d - The object that gets passed to the page. (This can be left out if you do not want to use this.)

Here are two examples of a correctly formatted rendered login link:

!!RENDERLOGINLINK([!User#ObjectId!], 60, 123456, Info Page)

This link will stay active for 60 minutes, take the user to page object ID 123456, and will have the words "Info Page" in the link.

!!RENDERLOGINLINK([!User#ObjectId!], 120, 111111, View Document, 222222)

In this second example, the link has a life of two-hours, goes to the page with the object ID 111111, and has a link text "View Document". Additionally, this link willcarry a second objectto the page, ObjectId 222222. This second object may be used as the Root for a Content Repeater Data Source, to display associated objects Or as a filter applied to a grid / list to only show this object.

In an e-mail, or on a webpage, these links would appear fully rendered as something you can click on. An example of this working would be the Login button on this page of the XPOR website.

 

 

 XPOR Ltd. UK Co. Registered in England No. 10409669
 02392 738000
 02392 739000