Removing pre-15.3 Kiosk Customizations (macOS/Windows)
Requires FileWave version 12.2.0 or greater.
Prior to FileWave 12.2,15.3 you had a method of customizing the Kiosk that is not used in 15.3 and beyond. Some of the customizations will be ignored with 15.3, but there wereare things you'll want to potentially remove and you may want to stop pushing out customizations that are no longer enforced. This article is a fewpaired thingsdown thatversion couldof bethe customizedold article and simply contains information on what customizations you might have had in the desktoppast Kiosk,so suchyou ascan look to potentially remove the windowfiles/edits. title and the logo. In FileWave 12.2, support for creating custom desktop kiosk styles was added, extending the previously existing customization possibilities.
The look of the FileWave desktop Kiosk can bewas customized using Qt Style Sheets. You would have had to create a file named fwGUI.qss and deploy it to clients in the right location. Several icons are nowwere also customizable by placing your custom icon in the right place with the right file name. All of this can be deployed via a fileset.Fileset.
Check youout already had pre-12.2 customizations, you can simply extend them by adding fwGUI.qss as well as your custom icons to your existing fileset. Pre-12.2 clients will simply ignoreSetting the stylePrimary sheetColor, Name and newLogo icons,in butKiosk/App willPortal continue(15.3+) to work, whereas newer clients will exhibit your custom look.
See also:and iOSApplications KioskPreventing stylingReboot (macOS/Windows)
Create
The syntax of Qt Style Sheets is similar to CSS, though there are some differences. If you want to learn more aboutfor the syntax, check "The Style Sheet Syntax". This page contains several examples that will help you better understand it.
In order to make it easier to customize the dialogs, every widget has a unique descriptive name. You can use style sheet selectors to refer to a particular widget. Besides, there are some additional propertiesthings that can be used to select several widgets that have somethingcustomized in commonFileWave with a single selector (e.g. "select all field names"). The list of all widget names15.3 and properties is defined below, in Styling rules.beyond.
Deploy
CreatefwGUI.qss -- You would have created a filesetFileset containing the fwGUI.qss and the icons, then associate it to the desired clients. The directory where these files should bewas placed depends on the operating system:system. In 15.3 and beyond you don't want to push the qss file or icons out as they will have no effect on the Kiosk.
macOS
/usr/local/sbin/FileWave.app/Contents/Resources/fwGUI.app/Contents/customWindows
C:\Program Files\FileWave\custom (might be "Program Files (x86)", depending on the platform)The changes will only be visible in the desktop Kiosk after the user logs out and logs in again.
Menu Bar/System Tray Settings
settings.ini -- containscontained generic kiosk ui settings:settings. Especially important is that if hide_system_tray = false that you will end up with 2 icons for the Kiosk where one is the old Kiosk if you are on FileWave 15.3.
Example
window_title = "Your New Window Title"
show_top_downloads = true
hide_system_tray = false-
The "window_title" attribute
will bewas displayed in the menu bar menu item - as well as in the kiosk window title area. -
The "show_top_downloads" attribute
can bewas used to hide the top downloads UI on a per client basis. -
"hide_system_tray"
determinesdetermined whether or not there will be an icon displayed in the system tray. Setting 'false' will force the Kiosk to show even with no current association.Example Filesets that you might have used to push out these settings:
Windows (64) - Kiosk_Customizer_for_Windows64.fileset.zip
Windows (32) - Kiosk_Customizer_for_Windows32.fileset.zip
macOS - Kiosk_Customizer_for_macOS.fileset.zip
macOS/Windows - Applications Preventing Reboot
Customizable icons
You might have included icon files that you used to replace them in Kiosk before 15.3. These icons will not appear in 15.3 or newer.
| File name |
48x48
action_forward.png
48x48
background_icon.png
40x40
rating_star_off.png
40x40
rating_star_on.png
40x40
tray_icon.png
64x64
Styling
Related rules
Client Info dialogContent
The
List of widgets
Special properties
Labels in this dialog have the following properties:
Example rules
Example
/* makes the background of the left pane white */
KioskClientInfo #leftPane {
background: white;
}
/* makes the paneSeparator look as a 1 pixel gray vertical line */
KioskClientInfo #paneSeparator {
border: none;
max-width: 1px;
background-color: #C9C9C9;
}
/* makes the "Boosters" label be displayed normal instead of bold */
KioskClientInfo #boostersLabel {
font-weight: normal;
}
/* makes all field labels blue */
KioskClientInfo QLabel[type="fieldName"] {
color: blue;
}
Software Installation dialog
The software installation dialog is called "Kiosk". Whenever styling widgets in this dialog, prefix all CSS rules with it.
This dialog contains the list of filesets that are available for installation via the Kiosk. It also displays details about a fileset when clicking it.
List of widgets
Fileset Items
Each row in the list of filesets is a widget. When creating rules for these rows, always prepend "Kiosk #filesetListView" to your selectors. Fileset rows are made up from the following widgets:
Top Ten Items
The "Top Downloads" pane contains a list of top ten items. When creating rules for these items, always prepend "Kiosk #topTenScrollASrea" to your selectors. Each top ten item consists of the following widgets:
Fileset Details
When clicking a fileset, the fileset details is revealed. This is a part of the software installation dialog, hence it shares parts of the dialog such as the toolbar and the statusbar. When creating rules for this widget, always prepend "Kiosk #detailView" to your selectors. The fileset details is made up of the following widgets:
Example rules
Example
/* add a top and bottom margin to the toolbar */ Kiosk QToolBar QToolButton { margin-top: 5px; margin-bottom: 5px; }
/* add a margin and a gray top border to the descriptionView */
Kiosk #detailView #descriptionView {
margin-left: 10px;
margin-right: 10px;
margin-bottom: 10px;
border-top: 1px solid #CFCFCF;
padding-top: 10px;
}
/* make all buttons in all dialogs blue */
QPushButton {
padding: 10px;
border: 1px solid #0000ff;
background-color: #0000ff;
color: white;
}
QPushButton:pressed {
border-color: #4040ff;
background-color: #4040ff;
padding-top: 11px;
padding-left: 11px;
padding-bottom: 9px;
padding-right: 9px;
}
On May 19, 2021 at the Alliance eMeeting a presentation on this topic was shared. Below is a copy of that presentation to help show the different levels of customization that are possible in the product:
eMeeting - Kiosk Customization.pdf