White Label an Install of RADIUSdesk

  • We realized there are by now quite a few deployments of RADIUSdesk out there.
  • Some of these deployments require White Labeling.
  • If you want to White Label your install then this page is for you.

Change the location from where the pages are served

  • Traditionally the optimized pages are served from the /usr/share/nginx/html/rd/build/production/Rd directory.
  • Do the following to serve it from the Webroot.
 sudo cp -R /usr/share/nginx/html/rd/build/production/Rd/* /usr/share/nginx/html/

Change the login screen

  • The login screen does not know who is about to log in so you can not give user related feedback.
  • Remember by changing the license message does not free you from the obligations imposed by the GPL license under which this software is released.
sudo vi  /usr/share/nginx/html/resources/js/config.js
  • Look for the following lines and change according to what you require
headerName      : 'RADIUSdesk',
footerName      : 'RADIUSdesk',
footerLicense   : '2012-2017 GPL license',
  • Reload the page.
  • It should now reflect the changes.
  • We assume you copied the optimized files to be in served out of the Webroot as specified in the first step of this page.
  • If you want to change it in its default location.
    • For the optimized JavaScript code:
sudo vi  /usr/share/nginx/html/rd/build/production/Rd/resources/js/config.js
  • For the original JavaScript code:
sudo vi  /usr/share/nginx/html/rd/resources/js/config.js

Change the Page Title

  • The default page title is Rd.
  • To change that to something else do the following:
sudo vi  /usr/share/nginx/html/index.html
  • Look for the following and change to your liking.
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">

After you logged in

  • After you logged in you can specify site wide defaults for the banner and footer.
  • Edit the following file
sudo vi /usr/share/nginx/html/cake3/rd_cake/config/RadiusDesk.php
  • Look for the following and edit to your liking.
//=== White Label ====
#NOTE: To enable the White Label site wide; change this to true
$config['whitelabel']['active']     = false ;
#After it is enabled you can tweak these values
$config['whitelabel']['hName']      = 'RADIUSdesk';
$config['whitelabel']['hBg']        = '#FFFFFF';
$config['whitelabel']['hFg']        = '#4b4c4c';
$config['whitelabel']['imgActive']  = true;
$config['whitelabel']['imgFile']    = 'logo.png';
$config['whitelabel']['fName']      = 'RADIUSdesk';
  • The logo.png file resides in the /usr/share/nginx/html/cake3/rd_cake/webroot/img/access_providers/ folder.
  • If you want to specify a site wide default logo, please replace that one manually.
  • The logo should not be more than 50 px high for it to display nicely in the top banner.

Per Access Provider

  • We also added functionality per Access Provider to override the default White Label settings.
  • Simply open the Access Providers applet.
  • Select an Access Provider and Edit it.
  • The Detail will have a White Label sub-tab where you can specify the overrides.

Remember that the per Access Provider override require that the site's white label be enabled in order to be activated.

If you only want the Logo without any text, simply leave the header text blank.