View source for Citrix Web Interface 5.1 Dual Channel button

{{template:default}}

[[Category:VPN]]
[[Category:Integration]]
[[Category:citrix|W]]
[[Category:Web Interface|W]]

== Citrix Web Interface Dual Chanel Integration Notes ==

This outlines how to replace the Single Channel Image request button with a Dual Channel button. This is a supplement to the Citrix Web Interface 5.1 Integration guide.


== Log-in page Customisation ==

On the Swivel Administration console under Server/Dual Channel, ensure Allow message request by username: is set to Yes.

On the Citrix Web Interface Installation create a copy of auth/pinsafe_image.aspx, and call it pinsafe_message.aspx

You will also need to ensure that pinsafe_message.aspx is included in the list of unprotected pages.

<nowiki>In auth/clientscripts/login.js, make a copy of the function onTuringButtonClick(), calling it onMessageButtonClick (). Change image.src in this function to point to pinsafe_message.aspx.</nowiki>

<nowiki>Edit app_data/include/loginMainForm.inc. Locate the text '<div class="otcButtonPane"'. Copy from here up to the ending </div>, and paste it immediately after this div. Change "href=javascript:onTuringButtonClick" to "href=onMessageButtonClick".</nowiki> 

Change the title and id of this div, as well as the id of the enclosed img and span elements. The new div element should be something like this:

  <nowiki>    <div class="otcButtonPane"><a</nowiki>
  <nowiki>           href="javascript:onMessageButtonClick()" title="Click this button to retrieve a PinSafe message."</nowiki>
  <nowiki>           onmouseover="changeOtcBtnColor(true);" onmouseout="changeOtcBtnColor(false);"</nowiki>
  <nowiki>           onfocus="changeOtcBtnColor(true);" onblur="changeOtcBtnColor(false);"</nowiki>
  <nowiki>           tabIndex="<%=Constants.TAB_INDEX_FORM%>"</nowiki>
  <nowiki>           id="dcmessage"</nowiki>
  <nowiki>           name="dcmessage"</nowiki>
  <nowiki>        ><img id="msgButtonBg" src="../media/LoginButtonGlow.gif" alt="" /><span id="msgButtonWrapper">Get Message</span></a></div></nowiki>

<nowiki>To make sure the new button looks right, you will also need to edit app_data/include/loginStyle.inc. Look for occurrences of #otcButtonWrapper and add ", #msgButtonWrapper". Also, for the entry #<%=Constants.ID_OTC_BTN%>, add ", #dcmessage".</nowiki>


== Testing ==

Test the button from the login page. Check the Swivel logs for the dual channel requests.