Web Page Integration

First please go to this topic for information on web page integration that applies to hosted service and server licence users: Web page integration

You will be pointed back to this chapter for the procedure that applies to server licence users.

If you have more than one website and you would like them all to point to your ISL Pronto supporters (similar to our websites for ISL Light, ISL AlwaysOn, ISL Pronto, ISL Groop - they all have "Chat live" buttons that point to the same live support, but they use different images), you will most likely need different images and chat window titles for different websites. Please refer to the Adding another website section below for more information. 

Adding new images

You now need to set ISL Conference Proxy so that it uses these images. Please follow these steps:

1. Open web administration, which is available at address http://localhost:7615/conf.
2. Login as user admin, password asd.
3. Go to User management - Domains, select the domain that you use for ISL Pronto (usually default).
4. Select ISL Pronto.
5. Uncheck the setting Link to template chat images and enter the image location in the provided space (e.g. http://example.com/images).
6. Click Save.

Important: If you have set a default customization for the domain or for the server, ISL Pronto settings will be taken from that customization. In that case, please open the default customization and check at least the following field:

• Link to template chat images

If that field is not set to the correct value, ISL Pronto images will not be shown on your web page.

Next step is to modify your web page to include the ISL Pronto button:

Important: Google sites users please refer to this topic for ISL Pronto gadget integration instructions.

1. Put this code to a location where you wish to have the ISL Pronto chat button:
   <a id="islpronto_link" href="mailto:YOUR_OFFLINE_EMAIL_ADDRESS@YOUR_DOMAIN.com"><img id="islpronto_image" alt="Live chat" src="http://example.com/images/islpronto-message.jpg" style="border:none"/></a>
2. Put this script code at the bottom of the page, just before </body>:
   <script type="text/javascript" src="http://pronto.isl.example.com/live/islpronto/public/chat.js?d=default"></script>

Important: The script code needs to be below the ISL Pronto chat button code, otherwise it will not work! This is why we suggest you put the script code at the bottom, just before </body>. Another reason for putting the ISL Pronto script code below all your script lines (i.e. directly above </body>) is that in case the ISL Pronto server is not accessible, it will not block the download of everything below it.

This concludes the basic web page integration. Please continue to the ISL Pronto client installation chapter to learn how to install ISL Pronto client on your supporters' computers.

For more information on customizing ISL Pronto, please refer to the following chapter: Customization.

Adding another website

You need to set the location of chat images for the second website. This example will add a second website and we will label it with a special bprefix website2_. Please follow these steps:

1. Open web administration, which is available at address http://localhost:7615/conf.
2. Login as user admin, password asd.
3. Go to User management - Domains, select the domain that you use for ISL Pronto (usually default).
4. Select Raw data.
5. Click Actions....
6. Enter the following in the name field: pronto::public::website2_prontolink
7. Enter the following in the value field: http://second-website/images (replace this sample link with the correct location)
8. Click Write.
9. Click Apply changes.

Next step is to modify your second web page to include the ISL Pronto button:

1. Put this script code at the bottom of the page, just before </body>:
   <script type="text/javascript" src="http://pronto.isl.example.com/live/islpronto/public/chat.js?d=default&bprefix=website2_"></script>
2. Put this code to a location where you wish to have the ISL Pronto chat button:
   <a id="islpronto_link" href="mailto:sales@example.com"><img alt="Live chat" src="http://second-website/images/islpronto-message.jpg" id="islpronto_image" style="border:none"/></a>
   Use the same procedure for adding any additional websites, just pick another bprefix. Please make sure that you modify the name field (pronto::public::<bprefix>prontolink), script code (value bprefix=website2_) and the ISL Pronto chat button code (img src= entry) appropriately.
   You can also change any other values by creating a new key pronto::public::<BPREFIX><KEY>, where <KEY> is the name of the setting key and <BPREFIX> represents the bprefix that refers to the target website. Here is an example that changes the chat window title for the second website in the example above:
   • Name: pronto::public::website2_chat_title
   • Value: Website2 chat

Restricting access to a certain website

To increase security you may only allow ISL Pronto chats, which arrive from a specific website. The security check is implemented using HTTP field Referer. Please follow these steps:

1. Open web administration, which is available at address http://localhost:7615/conf.
2. Login as user admin, password asd.
3. Go to User management - Domains, select the domain that you use for ISL Pronto (usually default).
4. Select ISL Pronto.
5. Enter the regular expression in the field Limit referer regex.
6. Click Save.

Examples

Allow ISL Pronto chats from a certain URL: http://www\.example\.com/a/page/index\.html

Allow ISL Pronto chats from a website with all subdomains and protocols, like http://www.example.com and https://secure.example.com: https?://([^/]+\\.)?example\\.com(/.*)?