Coral: start user configuration
|
User Configuration The Uniform Server Coral uses a configuration file which is split into two sections: user defined configuration and server tracking. The server tracking section is automatically updated by UniController and should not be changed by a user. It tracks items such as the installation path and the current Apache and MySQL running status. This page covers the user defined configuration section. You can disable or enable the start up splash page and optionally set a new page to display. During start up, a user is nagged to change server security items such as the MySQL password. Nagging is enabled or disabled in this section. Two user buttons, www and ssl, have been pre-configured to display the root folder index pages; these can be re-configured to display specific pages. In addition each button text is changeable by setting a language file constant. |
| ||||||||||||||||||||||||||
Splash Page
Background
At start-up, the server displays a splash page confirming that it is working. It is only a single page mini web-site with associated image and css folders. This mini-site is in its own folder (UniServer\home\us_splash) and mapped as an alias. The folder contains an .htaccess file limiting access only to localhost.
This mini web-site may be changed to fit your own requirements. Alternatively it can be disabled in the control configuration file as explained below. After that, it can be deleted, and the alias section removed from the configuration file.
Enable/Disable splash page
A single line in the control configuration file enables or disables the splash page at start-up. Edit file:
UniServer\coral_con\config_menu\config_tracker.ini
Locate this section and change line start=true as appropriate :
[REDIRECT] ;Redirect allows you to specify a page to display either ;at startup or when www or ssl buttons pressed. ;Folders can be an Alias eg us_splash. Root folder assumed ;If no path or file specified root is assumed first index ;page is displayed. No index page found the root folder ;content is displayed. ; Display page at start up. true display page false no page start=true
Change Splash Page
After enabling the start-up splash page, you can set the specific page to be displayed. Locate this section in the configuration file and change the line display_page=us_splash/index.php accordingly:
; Page to display from folder alias us_splash ; Default index.php display_page=us_splash/index.php
For example, if you want to display the index.php page in root folder www change line to: display_page=index.php
Note 1: The default page displayed uses redirection and is constructed with the following format: http://localhost:80/display_page (display_page is the variable containing path/file to display.)
Note 2: This part of the URL http://localhost:80/ is automatically adjusted to match the server port configuration.
User buttons www and ssl
|
Both server menus, initiated by start as program and start as service, contain two user configurable buttons:
These have been pre-configured to display the root folder index pages. Their corresponding button text is defined in the language file |
|
Change www page
A single line in the control configuration file sets the page to be displayed. Edit file:
UniServer\coral_con\config_menu\config_tracker.ini
Locate this section in the configuration file and change line "www=" accordingly:
; Page to display from folder www when www button clicked ; Default any index page. Note: http:// is used www=
For example, if you want to display the index.php page in root folder www change line to: www=index.php
Note 1: The page displayed uses redirection and is constructed with the following format: http://localhost:80/www (www is the variable containing path/file to display.)
Note 2: This part of the URL http://localhost:80/ is automatically adjusted to match server configuration.
Change ssl page
A single line in the control configuration file sets the page to be displayed. Edit file:
UniServer\coral_con\config_menu\config_tracker.ini
Locate this section in the configuration file and change line "ssl=index.php" accordingly:
; Page to display from folder ssl when ssl button clicked ; Default index.php Note: https:// is used ssl=index.php
For example, if you want to display the fred.html page in root folder ssl change line to: ssl=fred.html
Note 1: The page displayed uses redirection and is constructed with the following format: https://localhost:443/ssl (sll is the variable containing path/file to display.)
Note 2: This part of the URL https://localhost:443/ is automatically adjusted to match server configuration.
Change button names (www or ssl)
Button names are defined in the language configuration files. The actual file used is lang.vbs, but this is just a copy of the active language. When a language is selected with the Select Language button, that language file is copied to lang.vbs and replaces it.
Currently there are two language files; other languages will be added as translations are made available.
For English, edit:
UniServer\coral_con\lang\English.vbs
Locate this section in the configuration file and change lines accordingly:
'****************************************************************************** ' User Configuration '****************************************************************************** Const lang_view_www = "View www" 'User button text Const lang_view_ssl = "View ssl" 'User button text '-------------------------------------------------- End User Configuration ---
For example, if you want to change the displayed text "View www" to "My Index" and change "View ssl" to "Information", then the block becomes:
'****************************************************************************** ' User Configuration '****************************************************************************** Const lang_view_www = "My Index" 'User button text Const lang_view_ssl = "Information" 'User button text '-------------------------------------------------- End User Configuration ---
Note:
To activate your change, you can either duplicate the change to lang.vbs or use the Select Language button, which will do the copy for you.
Start-up - Nagging
I personally hate the concept of nagging users, hence the ability to turn it off when first encountered. That said, it is essential to set a new MySQL server root password, and nagging stresses the security issue.
Enable/Disable - Nagging
If you accidentally turn off nagging, it is easy to restore by editing the control configuration file.
UniServer\coral_con\config_menu\config_tracker.ini
Search for this section:
[NAG] ; Enables nagging to get user to change MYSQL password ; Default true - nag user nag_user=false
Change the section as shown to reenable nagging:
[NAG] ; Enables nagging to get user to change MYSQL password ; Default true - nag user nag_user=true
Where to next
MySQL Change Restore password - Set new MySQL root password