Appboard/2.6/builder/system administration/login page: Difference between revisions

imported>Jason.nicholls
No edit summary
imported>Jason.nicholls
Line 10: Line 10:
== The System Login Page ==
== The System Login Page ==


The dialog, as shown above in the example screenshot, shows the current system login page setting and a text input field to set a new setting. Enter a new login page location and click the ''Save'' button.
The dialog, as shown above in the example screenshot, shows the current system login page setting, a text input field, a list of valid login pages installed on the system, and a preview window to the right.
 
To preview different log pages click within the ''Location'' column.
 
To change the current setting, make a selection in the ''Select'' column, and then make sure to also click the ''Save'' button at the top left.


Login pages must exist on the AppBoard server in the <tt>[INSTALL_HOME]/server/webapps/enportal/login_pages</tt> directory. Take a look in this directory to see the available options included with a default AppBoard install:
Login pages must exist on the AppBoard server in the <tt>[INSTALL_HOME]/server/webapps/enportal/login_pages</tt> directory. Take a look in this directory to see the available options included with a default AppBoard install:

Revision as of 05:02, 24 July 2015


The Login Page administration page allows for system login page to be modified. AppBoard ships with a number of different login page styles to choose from, but these can be modified or completely custom login pages can be created.

To access the Login Page administration page select the System Administration builder mode and select the Login Page icon.

Login Page administration page.

The System Login Page

The dialog, as shown above in the example screenshot, shows the current system login page setting, a text input field, a list of valid login pages installed on the system, and a preview window to the right.

To preview different log pages click within the Location column.

To change the current setting, make a selection in the Select column, and then make sure to also click the Save button at the top left.

Login pages must exist on the AppBoard server in the [INSTALL_HOME]/server/webapps/enportal/login_pages directory. Take a look in this directory to see the available options included with a default AppBoard install:

  • (no sub-directory): classic Edge Dark login page
  • edgeLight: classic Edge Light login page
  • edgeDark_css3: new Dark login page themed using CSS for easier customization
  • edgeLight_css3: new Light login page themed using CSS for easier customization
  • edgeFlat: new Flat login page themed using CSS for easier customization

Modifying Login Pages

Template-warning.png
Do not directly modify the login pages shipped with AppBoard as these files are not backed up and may be replaced on upgrade.

Modifying the login page may be as minimal as changing the logo, or adjusting some of the theming, or completely writing everything custom. In all cases the existing shipped pages and resources should serve as a starting template. The recommended approach is to:

  1. Choose one of the existing login pages to start with, it's best to use the CSS-based pages if the goal is to simply change the logo and look'n'feel.
  2. Make a copy of the login page sub-directory with all it's files and sub-directories into a new directory, for example: [INSTALL_HOME]/server/webapps/enportal/login_pages/customLoginPage
  3. Make changes only to this new copy as needed.
  4. Update the system to use the new login page (refer to The System Login Page section above)
  5. Except for the system shipped login pages, all other sub-directories under login_pages are automatically included in backup archives.

To test make sure to log out of AppBoard, clear your browser cache, and reload the login page.

Custom Login Page Examples

For more information and examples on modifying or creating completely custom login pages refer to the Custom Login Pages documentation.