Removing pre-15.3 Kiosk Customizations (macOS/Windows)

Requires FileWave version 12.2.0 or greater.

Prior to FileWave 12.2, there were a few things that could be customized in the desktop Kiosk, such as the window 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 be customized using Qt Style Sheets. You have to create a file named fwGUI.qss and deploy it to clients in the right location. Several icons are now 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. If you 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 ignore the style sheet and new icons, but will continue to work, whereas newer clients will exhibit your custom look.

Create

The syntax of Qt Style Sheets is similar to CSS, though there are some differences. If you want to learn more about 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 properties that can be used to select several widgets that have something in common with a single selector (e.g. "select all field names"). The list of all widget names and properties is defined below, in Styling rules.

Deploy

Create a fileset containing the fwGUI.qss and the icons, then associate it to the desired clients. The directory where these files should be placed depends on the operating system:

macOS

/usr/local/sbin/FileWave.app/Contents/Resources/fwGUI.app/Contents/custom

Windows

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.

settings.ini -- contains generic kiosk ui settings:

Example

window_title = "Your New Window Title"
show_top_downloads = true
hide_system_tray = false

The "window_title" attribute will be displayed in the menu bar menu item - as well as in the kiosk window title area.

The "show_top_downloads" attribute can be used to hide the top downloads UI on a per client basis.

"hide_system_tray" determines 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
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

File name	FileWave Version	Description	Example	Pixel Size
action_back.png	12.2+	Icon for the "Back" action in the Software Installation dialog		48x48
action_forward.png	12.2+	Icon for the "Forward" action in the Software Installation dialog		48x48
background_icon.png	<12.2	Icon used for the watermark	(FileWave icon)	512x512
rating_star_half.png	12.2+	Icon for half a rating star		40x40
rating_star_off.png	12.2+	Icon for a rating star that is off		40x40
rating_star_on.png	12.2+	Icon for a rating star that is on		40x40
tray_icon.png	12.2+	System tray icon. If missing, the background_icon.png is used.	(FileWave icon)	16x16
warning.png	12.2+	Warning icon, displayed when a fileset has problems (e.g. missing VPP user)		64x64

Styling rules

Client Info dialog

The client info dialog is called "KioskClientInfo". Whenever styling widgets in this dialog, prefix all CSS rules with it.
The main contents of this dialog is a list of field names with their corresponding values. All labels displaying the name of the field are suffixed with "Label", whereas all labels displaying their corresponding values are suffixed with "Field".

List of widgets

Widget name	Description	Example value (see screenshot above)	Widget type
toolBar	Toolbar (currently empty)		QToolBar
centralWidget	Container widget for all contents of the dialog (except tool bar and status bar)		QWidget
leftPane	Left pane, which contains the "Verify" button and the watermark		QTreeView
verifyButton	The "Verify" button	Verify	QPushButton
installSplitter	Splitter between the left pane and the list of fields on the right side		QSplitter
nameLabel	"Name" label	Name	QLabel
nameField	Value of the "Name" field	Víctor's Workstation	QLabel
addressLabel	"Address" label	Address	QLabel
addressField	Value of the "Address" field	10.2.4.199	QLabel
versionLabel	"Version" label	Version	QLabel
versionField	Value of the "Version" field	12.2.0 (Rev. 4dcf548b)	QLabel
platformLabel	"Platform" label	Platform	QLabel
platformField	Value of the "Platform" field	macOS 10.12 Sierra (10.12.5)	QLabel
modelVersionLabel	"Model Version" label	Model Version	QLabel
modelVersionField	Value of the "Model Version" field	4	QLabel
tickleIntervalLabel	"Tickle Interval" label	Tickle Interval	QLabel
tickleIntervalField	Value of the "Tickle Interval" field	10 sec	QLabel
fileCheckIntervalLabel	"File Check Interval" label	File Check Interval	QLabel
fileCheckIntervalField	Value of the "File Check Interval" field	1440 min	QLabel
filewaveServerLabel	"FileWave Server" label	FileWave Server	QLabel
filewaveServerField	Value of the "FileWave Server" field	127.0.0.1:20015	QLabel
sslLabel	"SSL" label	SSL	QLabel
sslField	Value of the "SSL" field	False	QLabel
statusLabel	"Status" label	Status	QLabel
statusField	Value of the "Status" field	Running...	QLabel
serverConnectionLabel	"Server Connection" label	Server Connection	QLabel
serverConnectionField	Value of the "Server Connection" field	Connected (no updates)	QLabel
lastConnectionAttemptLabel	"Last Connection Attempt" label	Last Connection Attempt	QLabel
lastConnectionAttemptField	Value of the "Last Connection Attempt" field	20.06.17 10:26	QLabel
paneSeparator	Vertical line separating the kiosk status and the list of Boosters		QFrame
boostersLabel	"Boosters" label	Boosters	QLabel
booster1Label	"1." label referring to the first Booster	1.	QLabel
booster1Field	Address of the first configured Booster	None	QLabel
booster2Label	"2." label referring to the second Booster	2.	QLabel
booster2Field	Address of the second configured Booster	None	QLabel
booster3Label	"3." label referring to the third Booster	3.	QLabel
booster3Field	Address of the third configured Booster	None	QLabel
booster4Label	"4." label referring to the fourth Booster	4.	QLabel
booster4Field	Address of the fourth configured Booster	None	QLabel
booster5Label	"5." label referring to the fifth Booster	5.	QLabel
booster5Field	Address of the fifth configured Booster	None	QLabel
privacyPolicyLabel	A link that opens the FileWave privacy policy in an external browser. The link color cannot be customized using Qt Style Sheets. Use the key "link_color" in settings.ini instead (e.g.: link_color="#FF0000").	FileWave Privacy Policy	QLabel
bottomLine	A horizontal line displayed immediately above the status bar		QFrame
statusBar	Status bar		QStatusBar

Special properties

Labels in this dialog have the following properties:

Property	Description	Possible values
type	"fieldName" means that this label displays the name of a field. "fieldValue" means that this label displays the value of a field. "other" applies to all other labels.	* fieldName * fieldValue * other

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

Widget name	Description	Example value (see screenshot above)	Widget type
toolBar	Toolbar		QToolBar
actionBack	The "Back" action in the toolbar		QToolButton
actionForward	The "Forward" action in the toolbar		QToolButton
filesetStatusCombo	The fileset status combo box in the toolbar	All Items	QComboBox
searchField	The search box in the toolbar (currently not customizable)
categoriesView	List of categories	All (7)	QTreeView
categoriesOrganizationsSplitter	A splitter between the list of categories and the list of organizations		QSplitter
organizationsLabel	The "Organizations" label below the list of categories (might be hidden)	Organizations	QLabel
organizationsView	The list of VPP users, below the Organizations label (might be hidden)		QTreeView
installSplitter	A splitter between the left pane (categories/organizations) and the list of filesets		QSplitter
listView	Widget that contains the whole list of filesets		QWidget
filesetListView	The list of filesets		QTreeView
topTenScrollArea	The area that contains the list of top ten items. See below for details.		QScrollArea
topDownloadsLabel	The "Top Downloads" label that serves as title for the top ten area.	Top Downloads	QLabel
bottomLine	A horizontal line displayed immediately above the status bar		QFrame
statusBar	Status bar		QStatusBar

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:

Widget name	Description	Example value (see screenshot above)	Widget type
KioskInstallWidget	Represents a whole row displaying information about one fileset		KioskInstallWidget
iconLabel	The icon		QLabel
titleLabel	The fileset name	Atom	QLabel
categoryLabel	The category of the fileset	Applications	QLabel
descriptionBrowser	Displays the first line of the description	Let Evernote change the way you organize your personal and professional projects...	QTextBrowser
rating	Displays the rating of the fileset (if available). The icons can be customized. See "Customizable icons" above.
statusLabel	Displays the warning icon. This icon can be customized. See "Customizable icons" above.	(exclamation mark icon)	QLabel
installButton	The Install/Get license button.	Install	QPushButton
progressBar	The installation progress bar		QProgressBar
moreLessButton	The "More" link. Must be customized as a QPushButton.	More	QPushButton

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:

Widget name	Description	Example value (see screenshot above)	Widget type
detailView	Widget that contains the whole fileset details		QWidget
icon	Icon		QLabel
titleField	The fileset name	Evernote - stay organized	QLabel
categoryField	The category of the fileset	(empty in this screenshot)	QLabel
statusLabel	The "Status:" label	Status:	QLabel
statusField	Label that displays the current status	No VPP token associated	QLabel
rating	The rating	(4/5 stars)
installButton	The Install/Get license button	Get license	QPushButton
installProgressBar	Shows the progress of the installation. Visible only while the installation is in progress.		QProgressBar
descriptionView	Detailed description of the fileset.	Let Evernote change the way you organize your...	QTextBrowser

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

Removing pre-15.3 Kiosk Customizations (macOS/Windows)

Create

Deploy

macOS

Windows

Menu Bar/System Tray Settings

Example

Customizable icons

Styling rules

Client Info dialog

List of widgets

Special properties

Example rules

Example

Software Installation dialog

List of widgets

Fileset Items

Top Ten Items

Fileset Details

Example rules

Example