Customer Panel - Installation and Administration Guide

Installation

The following instructions explain how to install the package using one of the provided methods.

Please make sure that the Intalio Router package is already installed in your system before proceeding further!

Remember to set the correct FQDN and HttpType in your SysConfig before you install this module!

1. Admin Interface

Log in to your system as user with admin privileges and go to menu Admin ⇨ Package Manager. Select module file (with .opm extension) in the "Actions" panel and click "Install Package" button.

2. Command line

Log in to the server (via SSH, putty etc.) as "otrs" user and use the following command:

/opt/otrs/bin/otrs.Console.pl Admin::Package::Install /path/to/package/Customer-Panel-1.0.0.opm

Administration

Administration

Application path

The Customer Panel is closely linked to the Intalio Router Package, which is responsible for routing many of the Intalio's applications that are based on OTRS. 

Base path for the application is always /opt/otrs/var/httpd/htdocs/

You can set a path to the application using the IntalioApplication::CustomerPanel. This way you specify the location of your application frontend files - /opt/otrs/var/httpd/htdocs/customer-panel

Example configuration:

image-1591257190123.png

The application will be available at <DOMAIN>/otrs/route.pl/customer-panel in this case and this is the default configuration. 

Administration

System Configuration

In the system configuration you will find plenty of fields that will allow you to customise your customer panel. 

To see all configuration options:

  1. Click on the Admin tab and pick System configuration
  2. Find Intalio Customer Panel in the Navigation bar
  3. From the dropdown menu choose CustomerFrontend

    image-1591269344578.png

AvailableLanguages

List of available languages
Currently supported languages:

CustomerOTRSFrontendModule::AvailableModules

Set modules availability (visibility).
Setting the value 1 for the module will allow you to go to its view and see it on the menu. 

Read more about modules here

CustomerOTRSFrontendModule::DefaultOverviewColumns

List of parameters that are available to choose as columns on the tickets list in the widget configuration. 

image-1591264212150.png

Read more about widgets here

CustomerOTRSFrontendModule::Permissons

Defines user groups that are allowed to see the given module. 

image-1591269480839.png

CustomerOTRSFrontendModule::ScreenAfterLogin

Defines the address that will be used to redirect after successful login

image-1591269745009.png

CustomerOTRSFrontendModule::Styles

Defines the styles and images that are used to personalise the panel

image-1591270045882.png

Read more about customising the panel here

CustomerOTRSFrontendModule::TicketPreviewTitleTemplate

Defines a ticket title template

image-1591277759950.png

This field uses the OTRS templating mechanism. Read more about it in OTRS documentation.

CustomerOTRSFrontendModule::TicketViewFieldOrder

Defines the priority (order) of properties on the ticket view's information column. 

image-1591277743121.png

image-1591281531357.png

EscalationSuspendedStates

If a SLA suspension module is used which uses ticket states for controlling the time counter, we can specify the suspend states here. image-1591283090361.png

LoginPanel

This configuration let you customise your login panel.

image-1591342807613.png


You can customise the following items

OTRSFrontendModule

Configurations starting with OTRSFrontendModule:: is the configuration for specific module such as CustomerDashboard, CustomerForm etc. They all have the similar configuration options to set and some of them have also a widgets section or mode. 

More information about Modules documentation can be found here

image-1591344906221.png

TicketListMaxRows

Defines the maximum number of rows on the tickets list. 

image-1591349524264.png

Administration

Modules

Modules are the main abstract elements of the customer panel. 

If you're looking for the information about adding new custom modules to the Intalio Customer Panel check out this link

Module types

There are two types of modules:

Each module, regardless of type can be located in the menu. 

image-1592214848323.png

Modules configuration

Each module consists of three OTRS configuration options

  1. Modules specific configuration

    image-1592215342106.png

  2. Module availability (set to 1 to make it available)

    image-1592215435177.png

  3. Correct module permission - users that are in specified OTRS's group will see given module in the menu and will be able to open the module view

    image-1592215497537.png

Module customisation

Menu icon

image-1592217480882.png

To customise menu icon of the given module find the module configuration in System Config. 

 

Read more about Customer Panel configuration here

To change default icon go to the icons library and pick the icon that you want to set.

image-1593761684674.png

Find the module configuration in System Configuration. 

image-1593762696935.png

Paste the new icon name in the icon option. 

Modules menu order

The higher the priority the higher the module is on the menu. 

image-1593762484939.png

Module name

You can change the module name in the menu by changing the text setting in the module configuration. 

image-1593762679097.png

Setting the module type (module/redirect)

You can change the behaviour of the menu option by setting it's type. 
You can choose between views and redirects. 

Module

If you set the module type to module, selecting the module in the menu will result in displaying its content directly in the customer panel.

User Settings is the example of this behaviour. 

image-1593765222167.png

Redirect

Redirect is simply a link in the menu of the customer panel. It can be used to redirect users to another systems. 

image-1593767300818.png

Redirects can be opened in new tab or new window. 
Use mode setting to set proper browser behaviour. 
Available options:
- newWindow
- tab

 

Administration

Widgets

Introduction

Widgets are the basic elements of the customer panel that users interacts with. 

Widgets can be simple...

image-1594216210446.png

... or complex. 

image-1594216444615.png

Widgets are part of the modules. 

image-1594217756351.png

Saving the widgets configuration

Widgets can be added to the customer's Dashboard. 
Dashboard is customisable by the user. Customers can add and remove widgets or arrange their order. 

image-1594218055981.gif

This configuration is saved in the customer specific configuration. When the user logs in to the Customer Panel again he will see the same widgets configuration not only in the Dashboard module but also in the widgets in other modules (for example, filters set in the Tickets widget). 

Different display style

Widgets can be displayed differently in the module and in the customer's dashboard. 

Module

image-1594219480797.png

Dashboard

image-1594219604235.png

Developing new widgets

Developers have the ability to create new widgets without Intalio's assistance. 
Widgets consists of a single JavaScript file. If you know the basics of the Vue Framework you're good to go. 

Read more about developing new functionalities in the Intalio Customer Panel here

Administration

Customising styles

The appearance of Intalio Customer Panel can be fully customised. 

List of customisable elements

  1. Favicon (browser card icon)
  2. Page Title
  3. Menu Logo
  4. Menu title
  5. Active elements color (accent color)
  6. Shades color
  7. Widgets color
  8. Menu background
  9. Login page logo

image-1594643723101.png

image-1594643702412.png

Progressive Web Apps

Customer panel is made to work as Progressive Web App. PWA is a technology that seamlessly transforms a web application into mobile application. Users can install Intalio Customer Panel on their mobile devices and computers. 

  1. PWA app color accents
  2. PWA app title
  3. PWA icon and title on the apps list (desktop)
  4. PWA icon and title on the main screen (mobile)

image-1594645317588.png

image-1594645401420.png

image-1594645765220.png

 

 

Release Notes

Release Notes

Customer-Panel-Frontend

[06.07.2023] - 1.2.30

Poprawki

image-1689596358359.png


[28.06.2023] - 1.2.29

Nowości

image-1689596409911.png

image-1689596451459.png

 


[19.04.2023] - 1.2.28

Nowości

image-1689596509952.png

image-1689596540346.png


[03.03.2023] - 1.2.27

Nowości

image-1689596595498.png


[09.02.2023] - 1.2.26

Nowości

...
  "ServiceCatalog": {
    "Images": {
      ...
      "HideLabels": true <--
  },
...

[07.02.2023] - 1.2.25

Nowości

  "ServiceCatalog": { 
    "UseImg": true,
    "Toolbar": {
      "Show": true,
      "LogoSRC": "/serviceCatalog/logo_bik.png"
    }
  },

[25.01.2023] - 1.2.24

Nowości

[Service Catalog] Dodano nową wartość konfiguracyjną globalConfig - "ServiceCatalog": { "UseImg": true }


[20.12.2022] - 1.2.23

Nowości


[08.12.2022] - 1.2.22

Nowości

"HideFrom": false

image-1689596682642.png

 

"HideFrom": true

image-1689596741804.png


[27.10.2022] - 1.2.21

Poprawki

Nowości


[28.09.2022] - 1.2.20

Poprawki

Nowości


[28.09.2022] - 1.2.19

Nowości


[28.09.2022] - 1.2.18

Nowości


[19.09.2022] - 1.2.17

Nowości


[30.08.2022] - 1.2.16

Poprawki

Nowości


[23.06.2022] - 1.2.15

Nowości


[31.05.2022] - 1.2.14

Nowości


[27.05.2022] - 1.2.13

Nowości


[10.05.2022] - 1.2.12

Poprawki


[28.04.2022] - 1.2.11

Nowości

Poprawki


[28.03.2022] - 1.2.10

Poprawki

Nowości


[28.03.2022] - 1.2.9

Nowości


[04.02.2022] - 1.2.8

Nowości


[07.11.2021] - 1.2.7

Poprawki


[29.09.2021] - 1.2.6

Nowości


[15.06.2021] - 1.2.5

Nowości


[15.06.2021] - 1.2.4

Nowości


[14.06.2021] - 1.2.3

Nowości


[14.06.2021] - 1.2.2

Nowości


[10.06.2021] - 1.2.1

Nowości


[27.05.2021] - 1.2.0

Nowości

Poprawki


[24.03.2021] - 1.1.46

Nowości

} ]

Dodatkowo moduł możemy podłączać do dowolnego widoku jako compiled: true


[08.02.2021] - 1.1.45

Nowości


[08.02.2021] - 1.1.44

Poprawki

Nowości


[26.01.2021] - 1.1.43

Nowości


[05.08.2020] - 1.1.42

Nowości


[29.07.2020] - 1.1.41

Nowości

Poprawki


[29.06.2020] - 1.1.40

Nowości

Poprawki


[24.06.2020] - 1.1.39

Nowości

​​Poprawki ​​​


[09.06.2020] - 1.1.38

Poprawki


[03.06.2020, 05.06.2020] - 1.1.37

Poprawki

Nowości


[21.05.2020] - 1.1.36

Nowości


[15.04.2020] - 1.1.35

 

Poprawki


[17.04.2020] - 1.1.34

 

Nowości


[06.04.2020] - 1.1.32

 

Nowości


[25.02.2020] - 1.1.31

 

Nowości


[12.12.2019] - 1.1.29

 

Poprawki

 

Nowości


[10.12.2019] - 1.1.28

 

Nowości


[04.12.2019] - 1.1.26

 

Nowości


[04.10.2019] - 1.1.18

 

Nowości


[30.10.2019] - 1.1.17

 

Poprawki


[30.10.2019] - 1.1.16

 

Poprawki


[28.10.2019] - 1.1.15

 

Nowości

 

Poprawki


[31.09.2019]

 

Nowości


[24.09.2019]

 

Nowości

 

Poprawki