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/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.

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	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

Related rules

Client Info dialogContent

The

• Setting clientthe infoPrimary dialogColor, isName calledand "KioskClientInfo". Whenever styling widgetsLogo in thisKiosk/App 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 valuePortal (see15.3+) 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

/* 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;
}

/* 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;
}

eMeeting - Kiosk Customization.pdf