Table Of Contents
Customizing the Application
User Interface Templates
Adding a User Interface Template
Editing a User Interface Template
Editing the Print Template
Editing the Email Template
Editing the SMS Template
Using Account Durations
Deleting a Template
Setting the Default Interface Mapping
Setting User Default Redirection
Customizing the Application
This chapter describes the following
•
User Interface Templates
•Adding a User Interface Template
•Editing a User Interface Template
•Deleting a Template
•Setting the Default Interface Mapping
•Setting User Default Redirection
User Interface Templates
Cisco NAC Guest Server allows you to customize the sponsor user interface text and guest notification text using User Interface Templates. You can change the labels for the sponsor interface, provide different instructions for guest users, or create a translated template to provide the sponsor interface and guest instructions in another language altogether.
Cisco NAC Guest Server provides a default template (in English) that can be used as is without any further modification. If you want to change the default presentation for sponsors and guests, you can add one or multiple templates that you can store separately on the Guest Server and modify as desired.
Once your user interface template is configured, you will need to set the default template mapping so that the Guest Server starts using the correct template. Once a sponsor has authenticated they can choose a different template to use and save it in the preferences. This enables each sponsor to have the application displayed in a different template or language.
If you are customizing the interface for another language, create a new template for the language and edit all pages with the translated text.
Typically, you create a customized template when you need to modify the account details and instructions that are provided to the guest, such as the Acceptable Use Policy. Cisco NAC Guest Server provides Print, Email, and SMS templates that allow you to customize the information that is printed, emailed, or text messaged to guests.
Note When customizing, it is a good idea to open the sponsor interface in a second browser for reference. This allows you to view how the configuration tabs map to the actual sponsor interface pages. You can bring up the sponsor interface by entering the Guest Server IP address without the "/admin" as the URL, for example, http://<guest_server_ip_address> or https://<guest_server_ip_address>.
Adding a User Interface Template
When you add a new template, it is automatically based on the default template to facilitate editing.
Step 1 From the administration interface select User Interface > Templates from the left hand menu.
Figure 10-1 User Interface Templates
Step 2 On the User Interface Templates page (Figure 10-1), click the Add Template button
Figure 10-2 Add Template Page
Step 3 In the Add New Template page (Figure 10-2), type a Template Name. This can be any descriptive text to identify the template later from the Current Templates list (Figure 10-1).
Step 4 Click the Add Template button.
The Edit User Interface Template page for the new template displays, initially with all details copied from the default template. If you only need to make small changes, this allows you not to have to retype all the entries.
Step 5 Modify these settings as desired, as described in Editing a User Interface Template next.
Editing a User Interface Template
Tip When customizing, it is a good idea to open the sponsor interface in a second browser for reference. This allows you to view how the configuration tabs map to the actual sponsor interface pages. You can bring up the sponsor interface by entering the Guest Server IP address without the "/admin" as the URL, for example, http://<guest_server_ip_address> or https://<guest_server_ip_address>.
Step 1 From the administration interface select User Interface > Templates from the left hand menu.
Figure 10-3 User Interface Templates
Step 2 From the Current Templates list (Figure 10-3), select the template that you want to edit.
Step 3 Click the Edit Template button. The Edit User Interface page for the template displays (Figure 10-4).
Figure 10-4 Edit Template
Step 4 Click the menu at the top of the page to select any of the sponsor pages that you want to edit.
Step 5 Make any changes to the fields and click the Save Template button. Some example edits are described in the following sections:
•Editing the Print Template
•Editing the Email Template
•Editing the SMS Template
Editing the Print Template
The Print Template page contains the guest account details that the sponsor can bring up in a browser to print out for handing to the guest after the account is created. The page is configured in HTML and can be fully customized.
Tip Navigating to Reporting > Active Accounts on the sponsor interface and clicking the Print button next to the guest account entry brings up the output of the Print Template for printing.
Step 1 Go to User Interface > Templates and click the Edit Template button for the template you want to edit in the Current Templates list.
Step 2 In the Edit User Interface page, click the Print Template tab at the top of the page to bring up the Print Template configuration page (Figure 10-5).
Figure 10-5 Print Template Page
Step 3 Change the Page Title as desired (default is "Guest User Details").
Step 4 In the Page Body text field, edit the default HTML code for the web page. The Page Body contains all the HTML that sits between the BODY tags on a HTML page. All HTML outside these tags is used by the application.
Step 5 In the HTML code you can use the following special variables to replace them with the details from the created guest account.
•%USERNAME% = The Username created for the guest
•%PASSWORD% = The Password created for the guest
•%STARTTIME% = The time from which the guest account will be valid
•%ENDTIME% = The time the guest account will expire
•%FIRSTNAME% = The first name of the guest
•%LASTNAME% = The last name of the guest
Step 6 Click the Save Template button to save your changes.
Editing the Email Template
The Email Template page contains the guest account details that the sponsor can email to the guest after creating the account. The page is configured in HTML and can be fully customized.
Tip Navigating to Reporting > Active Accounts on the sponsor interface and clicking the Email button next to the guest account entry brings up the output of the Email Template and also emails the guest.
Note E-mail/SMS messages are limited to the ISO 8859-1/Latin-1 character set.
Step 1 Go to User Interface > Templates and click the Edit Template button for the template you want to edit in the Current Templates list.
Step 2 In the Edit User Interface page, click the Email Template tab at the top of the page to bring up the Email Template configuration page (Figure 10-6).
Figure 10-6 Email Template Page
Step 3 Change the Page Title as desired (default is "Guest User Account Details").
Step 4 Change the Email Subject as desired.
Step 5 In the Email Body text field, edit the default email text to be sent to the guest page.
Step 6 In the Email Body you can use the following special variables to replace them with the details from the created guest account.
•%USERNAME% = The Username created for the guest
•%PASSWORD% = The Password created for the guest
•%STARTTIME% = The time from which the guest account will be valid
•%ENDTIME% = The time the guest account will expire
•%FIRSTNAME% = The first name of the guest
•%LASTNAME% = The last name of the guest
Step 7 Click the Save Template button to save your changes.
Editing the SMS Template
The SMS Template page contains the guest account details that the sponsor can text message to the guest after creating the account. The contents of the text message can be fully customized.
Tip Navigating to Reporting > Active Accounts on the sponsor interface and clicking the SMS button next to the guest account entry brings up the output of the SMS Template and also text messages the guest.
Note E-mail/SMS messages are limited to the ISO 8859-1/Latin-1 character set.
Step 1 Go to User Interface > Templates and click the Edit Template button for the template you want to edit in the Current Templates list.
Step 2 In the Edit User Interface page, click the SMS Template tab at the top of the page to bring up the SMS Template configuration page (Figure 10-7).
Figure 10-7 SMS Template Page
Step 3 Change the SMS Subject as desired.
Step 4 Change the SMS Destination to be the email address of the SMS gateway that you use.
To send the text message to mobile phone number of the guest, use the variable %MOBILENUMBER%. The %MOBILENUMBER% variable is replaced by the mobile phone number, including country code of the guest as entered by the sponsor. For example, if the country code selected is the UK (+44) and the guest's phone number is 055 555-5555, then %MOBILENUMBER% will contain 44555555555.
Note The initial plus symbol ("+") is not inserted and the initial 0, any spaces, or hyphens ("-") are removed from the phone number. If you need "+" to be inserted, then enter +%MOBILENUMBER%.
Step 5 The SMS Body contains be the SMS text to be sent to the guest. In the SMS Body you can use the following special variables to replace them with the details from the created guest account.
•%USERNAME% = The Username created for the guest
•%PASSWORD% = The Password created for the guest
•%STARTTIME% = The time from which the guest account will be valid
•%ENDTIME% = The time the guest account will expire
•%FIRSTNAME% = The first name of the guest
•%LASTNAME% = The last name of the guest
•%MOBILENUMBER% = The mobile number of the guest
Step 6 Click the Save Template button to save your changes.
Using Account Durations
Account durations are another way the sponsor can specify how long they want the guest account to remain valid. By default, the sponsor must specify start and end dates and times from a dropdown menu and popup calendar. By defining preset account durations you provide the sponsor with the ability to simply select the length of time starting from when they click the button to create the account.
Step 1 Select User Interface > Templates and click the Edit Template button for the template you want to edit in the Current Templates list.
Step 2 From the menu at the top of the page select Accounts > Account Duration. The Account Durations screen appears (Figure 10-8).
Figure 10-8 Account Duration
Step 3 Click the Add Duration button to add a new account duration (Figure 10-9).
Figure 10-9 Add Account Duration
Step 4 Enter a description that you want to appear in the sponsor interface, such as "1 Hour."
Step 5 Select the desired duration from the dropdown menu.
Step 6 Click the Add Duration Option button. You are taken back to the account durations list (Figure 10-8).
Step 7 If you want to edit or delete an account option, select the entry from the list and click the appropriate button.
Note The Account Durations options only appear on the sponsor's screen if the user group for the sponsor is set to Create Account By: Template Options. See Adding User Groups, page 5-1 for more details. The only account duration options that appear are the durations within the maximum duration set on the sponsors user group.
Deleting a Template
Step 1 From the administration interface select User Interface > Templates from the left hand menu.
Step 2 Select the template you want to delete from the Current Templates list and click the Delete Template button.
Step 3 Confirm deletion of the template.
Setting the Default Interface Mapping
Once you have created your template you need to make the template active. This is a global operation for the Cisco NAC Guest Server.
Step 1 From the administration interface select User Interface > Mapping from the left hand menu.
Figure 10-10 Default User Interface Mapping
Step 2 Select the Template from the dropdown list. This will become the template used for the sponsor and guest user interface.
Step 3 Click the Set Template button.
Setting User Default Redirection
There are a number of options that each sponsor may want to customize for their environment so that they don't need to make changes every time they log in to the sponsor interface. The items you can change are the template (for another language), the time zone, and the telephone country code.
Sponsors can change these settings from their Preferences page once they are logged in. However, to ease the situation for first time users of the application you can choose to direct sponsors to their preference page on their first login to the system.
Step 1 From the administration interface select User Interface > User Defaults from the left hand menu.
Figure 10-11 User Defaults
Step 2 Check the check box if you want the sponsors to be redirected to the preferences pages upon their first login to the system. If you don't then make sure it is unchecked.
Step 3 Click the Save Settings button.
