Difference between revisions of "Redirecting from your Existing Website to SchemeServe"

From SchemeServe Help
Jump to: navigation, search
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
  
SchemeServe comes with all the tools necessary to customise the look and feel and create any webpages you might need (see [[Edit your Web Pages, Logo, Theme & CSS]] but sometimes it might be preferable to redirect customers from your existing website to your SchemeServe Get Quote or other internal back-end pages.  This article will show you exactly how to do this.
 
  
 +
SchemeServe allows you to simply customise the look and feel of your web pages, you can use your own logo, create a theme, or use CSS and JavaScript as you prefer. However, sometimes you might want to redirect customers from within your current website to the “Get Quote” process or one of the other SchemeServe pages. There are three means to do this the first is the way we recommend you use – redirection. This allows you to simply call the page from SchemeServe.
  
== Preferred Method: Redirection ==
 
  
'''Step 1: Redirect your website'''
+
The second method is to use an iFrame or XMLHTTPRequest. We don't recommend this method as we find that it can offer a substantially impaired user experience – in that some of the functionality may not work properly. We've given a little detail about this below too.
  
You will need to ask your web developers to redirect users wishing to get New Quotes to either:
 
  
https://YOURSITE.schemeserve.com/GetQuote/
+
The final method is to use a program to call SchemeServe's functionality. This is a particularly advanced feature and we'd ask that if you want to do this you ask your software developer to contact ADM Support to ask about our API (Application Programming Interface).
...for a list of schemes.
+
 
 +
 
 +
== Redirecting to the SchemeServe Website – Recommended Method ==
 +
 
 +
 
 +
 
 +
=== Step 1: Redirect your website ===
 +
 
 +
 
 +
Your web developers will know how to do this. You should ask them to direct to the address below if you want to redirect to the New Quotes area of the site:
 +
 
 +
 
 +
  https://YOURSITE.schemeserve.com/GetQuote/
 +
  ...for a list of schemes.
 +
 
 +
 
 +
Or you can use this process to bring up a specific Scheme's quote process.
  
or alternatively...
 
  
 
  https://YOURSITE.schemeserve.com/GetQuote/questions.aspx?SchemeId=
 
  https://YOURSITE.schemeserve.com/GetQuote/questions.aspx?SchemeId=
Note to developers: Append the ID of the Scheme you would like the user to see to the end of this URL.
+
 
You can retrieve this ID from the querystring when viewing a scheme either on the Get Quote or Admin > Schemes pages.
+
 
 +
'''Please Note:''' Your developer will need to add the specific ID of the Scheme you are trying to bring up to the end of the URL. You can retrieve the ID when viewing a Scheme in SchemeServe.
 +
 
  
 
''Note: if you are using a [[Using_Your_Existing_Domain_Name_with_SchemeServe|custom domain name]] with SchemeServe, you should replace "https://YOURSITE.schemeserve.com" in the above examples with the full domain name you are using with SchemeServe.''
 
''Note: if you are using a [[Using_Your_Existing_Domain_Name_with_SchemeServe|custom domain name]] with SchemeServe, you should replace "https://YOURSITE.schemeserve.com" in the above examples with the full domain name you are using with SchemeServe.''
  
  
'''Step 2 (Optional): Remove unnecessary tabs from your SchemeServe homepage'''
+
=== Step 2 (Optional): Remove unnecessary tabs from your SchemeServe homepage ===
  
Sometimes you may wish to disable all public pages (e.g. 'About Us', 'Contact Us') on your SchemeServe website (except Get Quote, leaving all information pages back on your existing website.  This is possible by using CSS to hide the unnecessary tabs.  (See [[Viewing/Editing_your_Homepage|Edit your Web Pages, Logo, Theme & CSS]] for more information on how to edit your website's CSS styling.)
 
  
 +
You might want to remove all the public pages from the SchemeServe instance when it's called in your website. (e.g. remove “About Us”, “Contact Us”, etc.) you can do this using CSS. (See [[Viewing/Editing_your_Homepage|Edit your Web Pages, Logo, Theme & CSS]] for more information on how to edit your website's styling.)
  
== Alternative Method: IFRAME or XmlHttpRequest (Not recommended) ==
 
  
You might be tempted to put SchemeServe pages within an IFRAME on your existing website.  '''We strictly recommend against this''', as the user experience offered when embedding IFRAMEs into your existing website is not comparable to that of a fully fledged website.  Users may experience frustration with multiple scollbars, navigation back and forward and security restrictions.  Different browsers and devices also interpret and secure IFRAMEs in different ways.
+
== IFRAME or XMLHTTPRequest – Not Recommended ==
  
Note: If you absolutely cannot use the first method above (see "Preferred Method: Redirection") rather than an IFRAME it might be possible to use a javascript XmlHttpRequest to load the content as this is more likely to help with any scrollbar and navigation issues.  This may present some difficulty however due to the requirement for SchemeServe pages to 'postback'.
 
  
If you must use either of these methods, appending "&bare=1" to the querystring of the URLs described in our first method above (see "Preferred Method: Redirection") will result in the complete removal of the normal SchemeServe header, tabs and footer.
+
If you do choose to call SchemeServe pages using an IFRAME on your website, you do so at your own risk. ADM Networks strictly recommend that you don't do this because of the potentially poor user experience. You should make sure you test this functionality on a range of different browsers before making the experience “live” on your website as IFRAME handles very differently in different browsers.
  
  
'''Watch a video about putting SchemeServe in an IFRAME:'''
+
'''Note:''' It might be possible to use JavaScript to call an XmlHttpRequest instead of using an IFRAME. However, this may cause problems as SchemeServe requires certain pages to “postback” to the database.
  
<html>
 
<object id="scPlayer"  width="400" height="200" type="application/x-shockwave-flash" data="http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/scplayer.swf" ><param name="movie" value="http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/scplayer.swf" /><param name="quality" value="high" /><param name="bgcolor" value="#FFFFFF" /><param name="flashVars" value="thumb=http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/FirstFrame.jpg&containerwidth=1280&containerheight=804&xmp=sc.xmp&content=http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/css-bare.mp4&blurover=false" /><param name="allowFullScreen" value="true" /><param name="scale" value="showall" /><param name="allowScriptAccess" value="always" /><param name="base" value="http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/" /><iframe type="text/html" frameborder="0" scrolling="no" style="overflow:hidden;" src="http://www.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-
 
d7b6-4575-bb08-b90c2f5d560c/embed" height="200" width="400" ></iframe></object>
 
</html>
 
  
 +
'''Note:''' To remove the headers, tabs and footers in SchemeServe for an IFrame you can add the phrase “'''&bare=1'''” to your URL in the IFrame.
  
== Using our API ==
 
  
Finally, you may prefer to send information to and from SchemeServe programmatically. To do this, ask [http://support.admnetwork.com ADM support] about our API.
+
'''e.g. http://schemeserve.com/GetQuote/ would become http://schemeserve.com/GetQuote/&bare=1'''
  
  
== See Also ==
+
=== Video Demonstration of the Process to Remove Headers, etc. ===
  
* [[Using Your Existing Domain Name with SchemeServe]]
+
<html>
* [[Edit your Web Pages, Logo, Theme & CSS]]
+
<object id="scPlayer"  width="400" height="200" type="application/x-shockwave-flash" data="http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/scplayer.swf" ><param name="movie" value="http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/scplayer.swf" /><param name="quality" value="high" /><param name="bgcolor" value="#FFFFFF" /><param name="flashVars" value="thumb=http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/FirstFrame.jpg&containerwidth=1280&containerheight=804&xmp=sc.xmp&content=http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/css-bare.mp4&blurover=false" /><param name="allowFullScreen" value="true" /><param name="scale" value="showall" /><param name="allowScriptAccess" value="always" /><param name="base" value="http://content.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-d7b6-4575-bb08-b90c2f5d560c/" /><iframe type="text/html" frameborder="0" scrolling="no" style="overflow:hidden;" src="http://www.screencast.com/users/ChrisADM/folders/SS%20-%20CSS%20Hiding%20Bare/media/3ed65a1f-
* [[How to Insert an Image into a Homepage Article]]
+
d7b6-4575-bb08-b90c2f5d560c/embed" height="200" width="400" ></iframe></object>
 +
</html>

Revision as of 06:22, 18 December 2012

Introduction

SchemeServe allows you to simply customise the look and feel of your web pages, you can use your own logo, create a theme, or use CSS and JavaScript as you prefer. However, sometimes you might want to redirect customers from within your current website to the “Get Quote” process or one of the other SchemeServe pages. There are three means to do this the first is the way we recommend you use – redirection. This allows you to simply call the page from SchemeServe.


The second method is to use an iFrame or XMLHTTPRequest. We don't recommend this method as we find that it can offer a substantially impaired user experience – in that some of the functionality may not work properly. We've given a little detail about this below too.


The final method is to use a program to call SchemeServe's functionality. This is a particularly advanced feature and we'd ask that if you want to do this you ask your software developer to contact ADM Support to ask about our API (Application Programming Interface).


Redirecting to the SchemeServe Website – Recommended Method

Step 1: Redirect your website

Your web developers will know how to do this. You should ask them to direct to the address below if you want to redirect to the New Quotes area of the site:


 https://YOURSITE.schemeserve.com/GetQuote/
 ...for a list of schemes.


Or you can use this process to bring up a specific Scheme's quote process.


https://YOURSITE.schemeserve.com/GetQuote/questions.aspx?SchemeId=


Please Note: Your developer will need to add the specific ID of the Scheme you are trying to bring up to the end of the URL. You can retrieve the ID when viewing a Scheme in SchemeServe.


Note: if you are using a custom domain name with SchemeServe, you should replace "https://YOURSITE.schemeserve.com" in the above examples with the full domain name you are using with SchemeServe.


Step 2 (Optional): Remove unnecessary tabs from your SchemeServe homepage

You might want to remove all the public pages from the SchemeServe instance when it's called in your website. (e.g. remove “About Us”, “Contact Us”, etc.) you can do this using CSS. (See Edit your Web Pages, Logo, Theme & CSS for more information on how to edit your website's styling.)


IFRAME or XMLHTTPRequest – Not Recommended

If you do choose to call SchemeServe pages using an IFRAME on your website, you do so at your own risk. ADM Networks strictly recommend that you don't do this because of the potentially poor user experience. You should make sure you test this functionality on a range of different browsers before making the experience “live” on your website as IFRAME handles very differently in different browsers.


Note: It might be possible to use JavaScript to call an XmlHttpRequest instead of using an IFRAME. However, this may cause problems as SchemeServe requires certain pages to “postback” to the database.


Note: To remove the headers, tabs and footers in SchemeServe for an IFrame you can add the phrase “&bare=1” to your URL in the IFrame.


e.g. http://schemeserve.com/GetQuote/ would become http://schemeserve.com/GetQuote/&bare=1


Video Demonstration of the Process to Remove Headers, etc.