|
General Configuration |
The Configuration settings for Webster+ are used to define the format and look of a Web site, as well as various internal settings required by the system, such as the Email and SMS servers used to contact users. Many of the settings defined in the Configuration utility are accessible through the %Webster system object.
The Configuration consists of the following eight sections:
|
Section |
Contents |
|
General site information, such as name, icon, contact email, etc. | |
|
Custom CSS and Java Script to be added to all the Web pages on the site. | |
|
Template File and colors to use within the system for various standard elements. | |
|
Option to enable system security (highly recommended) and Administrator user name, password and email address. | |
|
(Available when Webster+ Security is enabled) Access control setting used to select which specific group of users is allowed to create/delete files and directories, as well as edit programs and HTML files, through the Webster+ Inspector. (Access Control was added in PxPlus 2021 Update 1.) | |
|
System email settings used to send emails to users regarding notifications such as forgotten password or two-step authorization. | |
|
System SMS settings used to send SMS text messages to users. | |
|
Miscellaneous system settings, such as chart legend location, grid lines settings, query list colors, Wiki documentation, error dumps, etc. (The ability to set options for Wiki documentation was added in PxPlus 2022.) |
When this utility first comes up, it will display the Site Info. You can click on the desired section from the tab line on the System Configuration page. This will display the input screen for that section and allow you to edit and save the settings. The Save button will save the entries for all the sections.
Click on Site Info to bring up the Site Information page:
The following settings can be maintained on this page:
|
Input Label |
Description |
%Webster Property |
|
Site Name |
Name to appear across the top of the screen. It will be included in all site generated emails. |
SiteName$ |
|
Site Image |
Image to be displayed centered in the upper left of the standard site template. If desired, you can change this by clicking or dropping a new file in the region below the input. |
SiteImage$ |
|
Site Homepage |
URL of the site you want the users to be directed to when they click the Image in the top left corner of the page. This URL will be brought up in a separate tab. |
SiteHomePage$ |
|
Contact Email |
If provided, an email address that can be used to contact the site administrator. If present, a link to generate the email will be provided on the left side bar. |
SiteEmail$ |
|
Privacy Page |
If provided, a page that describes the site privacy rules. If not present, the system will check for the page _privacy in the application or use *webster/page/privacy.html. |
SitePrivacy$ |
|
Accept Cookies |
System will confirm that user will accept persistent cookies before creating any. |
CookieQuery |
|
Temporary File Directory |
Location for the system to store any temporary files it may need. |
TempDirectory$ |
|
Force JS/CSS Reload |
This option can be set during development to effectively disable the browser caching of JavaScript or CSS files used by the site. This helps assure and changes on the server are applied immediately. |
ForceLoad |
Click on Customizations to bring up the Customization options:
The following settings can be maintained on this page:
|
Input Label |
Description |
%Webster Property |
|
Create/update Local Library |
Webster+ uses a number of JavaScript and stylesheet files. These are maintained in a library directory, which should be downloaded to your docroot /lib sub-directory. Click the Download lib button to create the library or to refresh the data. |
N/A |
|
Download Editors |
Click this button to download the ED+ program editor and HTML editor to your docroot /lib sub-directory. This allows authorized users to edit programs and HTML files through the Webster+ Inspector. See Viewing Program Files and Viewing HTML Files. (The Download Editors button was added in PxPlus 2021 Update 1.) |
N/A |
|
External Library URL Prefix |
This should contain the prefix for any referenced CSS or JavaScript files used by the application. If not specified, the system will assume the default of the site name /lib. |
Library$ |
|
Custom CSS |
This can contain any CSS code you want included in your application pages. |
CustomCSS$ |
|
CSS File URL |
This can contain the URL of a CSS file you want included in your pages. Only the URL is included, not the contents of the URL, so that the page can generally load faster. If the contents are not a true URL (starts with HTTP or HTTPS), then the Library prefix above will be added to the value. |
ExtraCSSFile$ |
|
HTML |
This can contain any additional HTML code you want added at the end of all pages generated by the system. |
ExtraHTML$ |
|
JavaScript File URL |
This can contain the URL of a JavaScript file you want included in your pages. If the contents are not a true URL (starts with HTTP or HTTPS), then the Library prefix above will be added to the value. |
ExtraJSFile$ |
Click on Template to bring up the Template definition:
The following settings can be maintained on this page:
|
Input Label |
Description |
%Webster Property |
|
This field contains the name of the template file used to create the Webster+ pages. It can be blank, in which case no template will be applied, or it can contain the name of a page to use. If the first character is an asterisk (*), then the system will first check for a file of the same name in your application search rules, replacing the * with a semi-colon. If that is not found, the system will drop the asterisk and look for the file in *webster/pages. Default value is *template.html. |
Template$ | |
|
Header Height |
This field defines the height of the header found in the template file. Default is 50 pixels. |
HeaderHeight |
|
Left Edge Width |
This field defines the width of the left edge found in the template file. Default is 180 pixels. |
HeaderWidth |
|
This field defines the system default starting page to be used when a browser connects. Default value is *default, which will come from the *webster/pages/default.html file or _default.html in the application pages directory. (The Default Start page option was added in PxPlus 2023 Update 1.) |
DfltStartPage$ |
The Template Colors values define the various colors used by the standard template/CSS files. You can define the color of the background and, for some sections, the color of the text to appear in that area.
The Reset to Default colors button will reset the colors selected to the system default color set.
Click on Security to bring up the system security settings.
Webster+ has been modified to allow it to share the user registration files with NOMADS/iNomads. A check box has been added to the Setup Security tab that will enable this option. Once it is enabled, user information will be maintained in Webster+ on the same file as NOMADS uses. The use of User Groups in Webster+ will remain independent of the Security Classes in NOMADS. Two-factor authentication also remains independently controlled; however, the authentication for Webster+ will be shared with iNomads and vice-versa.
The following settings can be maintained on this page:
|
Input Label |
Description |
%Webster Property | ||||||
|
Security Enabled |
Check box that controls whether the system will enable security. |
HasSecurity | ||||||
|
Set this option to allow Webster+ to share the user registration files with NOMADS/iNomads. Once it is enabled, user information will be maintained in Webster+ on the same file as NOMADS uses. If NOMADS security is not set up, the NOMADS user registration files will be created with the ADMIN user. (The Use Nomads Security file option was added in PxPlus 2023.) |
UseNomadsSecurity | |||||||
|
Self-registration Group |
Name of the user group that will be assigned to any user that self-registers. If left blank, self-registration is not possible. |
SelfRegister$ | ||||||
|
Password Regular Expression |
Regular expression to be used to validate that the password entered matches the Site security requirements. Default is 8 characters with at least one uppercase letter, one lowercase letter, and a digit. |
PswdRegExp$ | ||||||
|
Password Tip |
Tip that will be assigned to the system password fields. |
PswdTip$ | ||||||
|
Web Password Duration |
This is the number of days that the system will allow the user's password to be preserved on a workstation before forcing the user to reset the password. Default is 30 days. (The Password Duration option was changed to Web Password Duration in PxPlus 2022 Update 1.) |
PswdDuration | ||||||
|
This is the number of hours that the password will remain active when running a Webster+ application using the *Webster/Desktop utility. Default is 4 hours. (The Desktop Password Duration option was added in PxPlus 2022 Update 1.) |
DesktopPswdHrs | |||||||
|
Two-step Verification |
This controls whether the system will force two-step verification. Three options are available (internal value shown in parenthesis): • Don't use (N) |
TwoStepVerify$ | ||||||
|
Workstation Duration |
When using two-step verification, this is the number of days before a workstation will have to be re-validated. |
WsDuration | ||||||
|
Group if not signed on |
If present, this is the Security group that will be assigned for public access. Group specified can be used to define what that user can access beyond the logon prompt. |
| ||||||
|
Administrative User |
|
AdminUser$ |
(Available when Webster+ Security is enabled)
Click on Access Control to bring up the Inspector Edit Access group setting:
The following setting can be maintained on this page:
|
Input Label |
Description |
%Webster Property |
|
Inspector Edit Access |
This controls which specific group of users is allowed to create/delete files and directories, as well as make changes using the Edit button when viewing a file's contents through the Webster+ Inspector. Default is the System Administrators group. User groups are defined in Group Maintenance. |
EditAccess$ |
(Access Control was added in PxPlus 2021 Update 1.)
Click on Email to bring up the system email settings:
The following settings can be maintained on this page:
|
Input Label |
Description |
%Webster Property |
|
Email Address |
Email address used for all emails sent by the system, such as password reset requests and two-step verifications. |
EmailFrom$ |
|
SMTP Server |
Name of the SMTP server used to send emails. |
EmailSmtp$ |
|
SMTP Port |
Port number that the email server monitors. Some commonly used ports are 25, 465 or 587. |
EmailPort |
|
SMTP Account |
Account name to use when connecting to the email server, if required. |
EmailAcct$ |
|
Account Password |
Account password for the SMTP account. |
EmailPswd$ |
To setup a test email using these settings, enter an email address and then click the Test button.
Click on SMS to bring up the text messaging settings:
The following settings can be maintained on this page:
|
Input Label |
Description |
%Webster Property |
|
SMS Provider |
SMS provider to be used to send any SMS by the system, such as requests for two-step verifications. Values allowed: • smsmatrix |
SMSService$ |
|
SMS Account |
Account name to use when connecting with the SMS provider. |
SMSAcct$ |
|
SMS Passcode |
Account password/passcode. |
SMSPasscode$ |
To setup a test SMS message using these settings, enter a cell phone number and then click the Test button.
Click on Misc to bring up additional system settings:
The following settings can be maintained on this page:
|
Input Label |
Description |
%Webster Property |
|
Chart legend location |
Defines where the legend should be placed when rendering a chart in Webster+. Possible values are: • Top |
ChartLegendLocation$ |
|
Grid lines on Queries and Smart lists |
Defines whether you want grid lines enabled by default for Queries and Smart Lists (which use the Query system). Possible values are (internal value shown in parenthesis): • None (n) |
GridLines$ |
|
Use alternating colors in queries |
Set this option if you want queries to use alternating colors by default. |
QueryAlternating |
|
Set this option if you want the system to check for Wiki documentation on the pages in the system. (The Wiki Subsystem Enabled option was added in PxPlus 2022.) |
WikiEnabled | |
|
Set this value to the HTML text you want displayed in the top right corner of the page when Wiki documentation is available or can be edited/added to the system. Default is <i>Info</i>. The text will appear blue if the Wiki is present or red if not present but could be added. (The Wiki link text option was added in PxPlus 2022.) |
WikiLinkText$ | |
|
Set this option if you want the system to dynamically create basic Wiki documentation on the fly for the pages displayed. (The Dynamic Wiki Creation option was added in PxPlus 2022.) |
WikiOnTheFly | |
|
If you are going to use the Webster+ Google Maps interface, you can supply your Google Maps API key to the system so that it does not have be supplied in the form [map] short codes. (The Google Maps APIKEY option was added in PxPlus 2022.) |
GoogleMapKey$ | |
|
This option, when enabled, will allow the application to issue MSGBOX directives for display on the server console. By default, this option is Off and should only be enabled during local development on the Webster+ server. (The Enable MSGBOX directive option was added in PxPlus 2022.) |
EnableMSGBOX | |
|
File Maint to use Message box |
When checked (default), all messages will display in message boxes. If unchecked, all messages will use option boxes. See Webster+ OptionBox method. (The File Maint to use Message box option was added in PxPlus 2023.) |
FM_MsgBox |
|
If you are going to use iNomads with Webster+, specify the URL that will be used to launch iNomads. If you will be using the same domain and protocol (http vs. https) but on a different port, you only need to specify the port number to be used. Webster will automatically determine the domain and protocol to use. See Using iNomads with Webster+. (The iNomads URL/port option was added in PxPlus 2023.) |
iNomadsURL$ | |
|
Set this option if you want error dumps to be saved in the data/dump directory. This information will be viewable via the Statistics page. (The Save error dumps option was added in PxPlus 2023.) |
SaveErrorDumps | |
|
(Available when Save error dumps check box is selected) Email address to send a notification to when an error dump occurs. Email server information must be set up on the Email tab. See Email Settings. (The Error dump email notification option was added in PxPlus 2023.) |
DumpNotificationEmail$ | |
|
Email address to send a notification to when a new user creates an account. Email server information must be set up on the Email tab. See Email Settings. (The New user email notification option was added in PxPlus 2023.) |
NewUserNotificationEmail$ |
