@Wayne-Workman said
@Joe-Schmitt Yes I can, #wiki worthy.
@Wayne-Workman Here is some info I’ve gathered for consideration as a potential starting point for a Wiki article on FOG Rebranding.
Rebranding was introduced to the FOG client in version 0.11.6 of the client. It has since been improved with additional features. So to clarify, the information in this posting refers to FOG client version 0.11.12, and FOG version 1.4.0-RC-5 (dev-branch).
The following was pulled from fogproject/packages/web/commons/schema.php found at
https://github.com/FOGProject/fogproject/blob/33586365cea09444b5f35c071e72d3357462b220/packages/web/commons/schema.php
sections 240 through 243 (currently lines 3499 through 3574).
The first quote for each setting is the popup text currently displayed in the web GUI, except for
the two settingDesc
quotes which are used as the GUI popup text for their respective settings.
FOG_CLIENT_BANNER_IMAGE ‘This setting defines an image for the banner on the fog client.’
settingDesc
=‘This setting defines an image for the banner on the fog client. The width must be 650 pixels, and the height must be 120 pixels.’
FOG_CLIENT_BANNER_SHA ‘This setting stores the sha value of the banner to be applied.’
FOG_COMPANY_NAME ‘This setting defines the name you would like presented on the client.’
FOG_COMPANY_COLOR ‘This setting is the hex color code you want progress bar colors to display as.’
FOG_COMPANY_TOS ‘This allows setting the company terms of service.’
FOG_COMPANY_SUBNAME ‘This allows setting the company sub unit.’
settingDesc
=‘This allows setting the sub unit, and is only used on the Equipment loan report for tracking.’
The following was pulled from the original announcement at https://news.fogproject.org/fog-client-v0-11-6-released/
Rebranding
This release includes the ability to rebrand the shutdown prompt. This means you can change the colors, text, and images of the prompt to match your company’s. While this feature is free, we ask that if plan on using the rebranding option please consider providing a donation https://sourceforge.net/donate/index.php?group_id=201099 .
To set these options, go to FOG Configuration -> FOG Settings -> Rebranding.
Notes:
FOG_COMPANY_COLOR: This option is a hex value of your company’s color
FOG_CLIENT_BANNER_IMAGE: This should be a PNG image with 650x120 dimensions, note that the background can be transparent. See the default banner for an example. https://github.com/FOGProject/fog-client/blob/master/resources/banner.png (fog-client/resources/banner.png).
Additional notes and info.
FOG_CLIENT_BANNER_IMAGE
This setting is used for more that just the FOG client shutdown/reboot prompt. For example, it is also used as a heading within the PDF exports of certain reports. It is NOT used to rebrand the background image during network/PXE booting (that screen continues to use the default FOG branding). As noted above, the background for the banner image can be transparent. This is an option, not a requirement. The PNG file can have any arbitrary name when uploaded into the web GUI. However, when automatically copied to the clients, the image gets renamed to “banner.png” and is saved to the clients’ program installation folder (depending upon a check-box selection during the initial client installation). On the server, uploaded files are saved in the directory /var/www/fog/management/other. One can disable the custom banner image (which returns to using the default FOG banner image) from within the web GUI via the browse button (up arrow). To do so, simply submit a blank path. The banner.png file remains on the clients even if the FOG_CLIENT_BANNER_IMAGE setting is cleared. But the remaining banner.png file will not be used by the clients unless it is enabled/resubmitted via the web GUI.
FOG_CLIENT_BANNER_SHA
This field uses the SHA512 algorithm to automatically generate and display a hash value when a banner image is uploaded via the web GUI. This field is used to detect differences between the source banner image file on the server and the copies on the clients. Upon each and every client check-in event with the server, the client recalculates the SHA512 value of its current banner.png file and compares it against the SHA512 value calculated on the server. If the hash values do not match (or if there is no banner.png file on the client), the client will download the banner image file from the server, rename it and overwrite any existing banner.png file on the client. This effectively identifies and self-corrects for cases of tampering with the banner.png file on the client, and it automatically keeps the banner image file on the clients up-to-date whenever the file gets changed on the server.
I don’t have immediate plans to use the remaining four rebranding settings. So I have not tested them, and therefore don’t have anything additional to add for them.
FOG_COMPANY_NAME
FOG_COMPANY_COLOR
FOG_COMPANY_TOS
FOG_COMPANY_SUBNAME
I hope this is useful as a potential starting point for a Wiki article on FOG Rebranding.