Public Component

The "Service Desk" module is provided with a public component that allows integrating it with an external website. It allows the website visitors to communicate with the users of the TeamWox system by means of requests.

The integration with a website is performed using a css file of styles and a javascript. These files must be called from the special HTML page, the example of which is given below:

This page contains several constructions that must be obligatory used:

Links to CSS and JS Files

For working of the public component of the "Service Desk" module two files, "script.js" and "style.css", are necessary. You should download them by the links of the following type:

In them you should specify the address of your TeamWox system instead of "team.yourdomain.com". The downloaded files should be placed to the website the public component of the module will be integrated with. Further, the corresponding links to them should be specified in the HTML file, for example:

If you know CSS and Javascript well enough, you can modify the appearance of the public component of the "Service Desk" module.

Container Identifier

The public component is inserted to a defined container at the HTML page. This can be any container. In the example given above it is the <div> tag:

In this case the most important is to assign a unique identifier (id="service_desk" in the example) to a container, that further should be specified in one of the parameters below.

Parameters

The parameters are specified within the "var tw_servicedesk_params={...}" construction. Some of them are obligatory:

url:'address of TeamWox server'

The address of your TeamWox server is specified here within single quotes. For example, 'team.yourdomian.com'.

sid:'user identifier'

This field is one of the most important ones. It affects the access right of website users to the created requests. Using a special construction, a unique identifier must be substituted to its value for each website visitor.

• For the registered website users you can use MD5 from a keyword and user's ID at the website as the value of this field.
• For the anonymous visitor you can use MD5 from cookies.
• If the division into groups is implemented at your website, you can organize the cooperation of users with the same requests by substituting the identifier of the group in this field. If a fixed value is set for the "sid" field then any user will be able to view all the created requests.

container:'[container identifier]'

In this parameter you should specify the identifier of the container, that will be used for displaying the interface of the public component of the "Service Desk" module.

user_name:'[user name]'

This parameter should be collected by the website. As the value of it you should specify the constructions that substitute the corresponding information of the website visitors.

The following group of parameters is not obligatory:

user_email:'user e-mail address'

E-mail address of the user.

user_company:'name of user company'

Company name of the user.

incidents_per_page:number of requests per page

Here you should specify the number of requests that will be displayed at one page. If this parameter is not specified the default value is used (10).

comments_per_page:number of comments per page

In this parameter you should specify the number of comments to a request that will be displayed at one page. If this parameter is not specified the default value is used (10).

filter_groups:[list of identifiers of available groups]

Here in the square brackets you should specify the identifiers of groups separated by comma, that will be available to the users to choose when creating a request. Identifier of a group is displayed in the "Information" tab of the window of its parameters.

In order to make a group be publicly available you should enable the corresponding option for it in the settings.

filter_categories:[list of identifiers of available categories]

In this parameters in the square brackets you should specify the identifiers of categories created in group separated by comma, that will be available for users when creating requests. Identifier of a category is displayed in the "Categories" tab of the window of parameters of the group.

filter_products:[list of identifiers of available products]

In this parameter in the square brackets you should specify the identifiers of products created in group separated by comma that will be available for users when creating requests. Identifier of a product is displayed in the "Products" tab of the window of parameters of the group.

logo:'HTML code of window header'

Using this parameter you can change the standard header of the requests window to your own one. To do it you should specify your own HTML code of the header in this parameter. The simplest examples are:

Additional examples of implementation of the public part of the "Service Desk" module in "PHP" and ".NET" are given at the separate sections. The example of ready page of the public component of the module is given in the "Public requests" section.