====== 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**.
<code bash>
 sudo cp -R /usr/share/nginx/html/rd/build/production/Rd/* /usr/share/nginx/html/
</code>

===== 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** <wrap em>does not free you</wrap> from the obligations imposed by the GPL license under which this software is released.
<code bash>
sudo vi  /usr/share/nginx/html/resources/js/config.js
</code>
  * Look for the following lines and change according to what you require
<code javascript>
headerName      : 'RADIUSdesk',
footerName      : 'RADIUSdesk',
footerLicense   : '2012-2017 GPL license',
</code>
  * Reload the page. 
  * It should now reflect the changes.

<WRAP center round important 100%>
  * 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:
<code bash>
sudo vi  /usr/share/nginx/html/rd/build/production/Rd/resources/js/config.js
</code>
    * For the original JavaScript code:
<code bash>
sudo vi  /usr/share/nginx/html/rd/resources/js/config.js
</code>
</WRAP>


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

===== After you logged in =====
  * After you logged in you can specify site wide defaults for the banner and footer.
  * Edit the following file
<code bash>
sudo vi /usr/share/nginx/html/cake3/rd_cake/config/RadiusDesk.php
</code>
  * Look for the following and edit to your liking.
<code php>
//=== 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';
</code>
  * 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.

<WRAP center round tip 100%>
Remember that the **per Access Provider** override require that the site's white label be enabled in order to be activated.
</WRAP>


{{:user_guide:white_label:white_label.png?nolink|}}

{{:user_guide:white_label:white_label_result.png?nolink|}}


<WRAP center round tip 100%>
If you only want the Logo without any text, simply leave the header text blank.
</WRAP>