Please enable JavaScript to view this site.

Navigation: Using ASPRunnerPro

PHPrunner32x32     ASPRunnerPro manual


Miscellaneous settings

Scroll Prev Next More

Miscellaneous settings screen

The Miscellaneous settings screen allows setting Project, Table specific, and Enterprise Edition settings.

miscellaneous_settings

Project settings

The Project settings block includes settings that affect the entire project.

Language

Use the Language dropdown box to set the project language. By clicking the Multiple languages button, you can select several project languages and give users the ability to select the language when logging in. The translation of standard buttons and elements is already included in the ASPRunnerPro, so you don't need to translate them yourself.

misc_settings_multiple_languages

 

This is how the dropdown list option looks like in the generated project.

misc_settings_multiple_languages_ex

Regional settings

Choose the country from the dropdown box to select its regional settings. These settings affect the year-month-day order, the first day of the week, etc.

Output code page

This dropdown allows selecting the character encoding for the project.

Label Editor

Label Editor allows you to:

 

edit table and field labels (Table labels tab);

edit custom labels (Custom labels tab);

add tooltips to the Edit forms (Edit form tooltips tab);

edit web page titles (Page titles tab);

edit the project logo (Project Logo tab);

setting the placeholders for the fields (Input placeholders tab);

editing the EU cookie consent banner text (EU cookie banner tab).

 

You can translate labels into several languages. Click Choose languages to add more languages to the project.

 

You can export multilanguage labels to a CSV file (use the Export to CSV button), then edit the labels in the external editor and import the file back (use Import from CSV button).

 

Note: if you use languages other than English in the project, we recommend editing the CSV files using Google Docs or OpenOffice.

Due to the problems with the character encoding, we do not recommend using Microsoft Excel for projects with multiple languages.

 

Table labels

 

Modify and translate the table and field labels to make them more user-friendly. Filter the labels by table or field to limit the data displayed. Use <br> to insert a line break in the field label.

misc_settings_label_editor_tables

 

Custom labels

 

Use the Custom labels to translate error messages in regular expressions and custom validation plugins. You can also create custom labels to display messages to a user. Filter the labels by the Label Id to limit the data displayed.

misc_settings_label_editor_custom

 

If you have created Custom labels and want to place the language-dependent text on a page, you can add a ASP code snippet to the page and use the following code in it:

 

Response.Write GetCustomLabel("CustomLabelID")

 

Replace "CustomLabelID" with the correct custom label identifier.

 

You can also use custom labels in a page template. Open Editor and switch to HTML mode. Then add the following code:

 

{$custom CustomLabelID}

 

And in JavaScript code:

 

Runner.getCustomLabel('CustomLabelID')

 

While editing the page title, you can use the field values, e.g. {%ID} and {%Make} for View and Edit pages. For example:

 

Cars, Edit record [ID:{%ID}]
Customers, {%FirstName} {%LastName}

 

You can also use the field values of the master table on the List page of the details table. Here is the example of a page title for the Order details table:

 

Orders, ID: {%master.OrderID}

 

Edit form tooltips

 

Add a tooltip to a field to display additional information about it on the Add/Edit page, or during inline editing on the List page. To create a multiline tooltip, use <br> as a line separator.

misc_settings_label_editor_tooltip

 

Here is how it looks in the browser:

misc_settings_label_editor_tooltip_ex

 

Page titles

 

To edit a web page title, deselect the Default checkbox next to it and make the changes. Filter the page titles by the table or page to limit the data displayed.

misc_settings_label_editor_page_titles

 

Project logo

 

Change the project logo with the Project logo tab. You can enter plain text or HTML code here.

misc_settings_label_editor_logo

 
Here is an example of the code that can be used to display a logo icon and text:

 

<DIV style="position: relative; height: 40px; top: -6px; white-space: nowrap;">
    <IMG height="80%" id="navbarlogo" alt="Project logo" src="http://mywebsite.com/images/logo.png">
     Cars Project
</DIV>

 

That's how it looks like on the generated page:

misc_settings_label_editor_logo_ex

 
You can do even more by using the Labels/Titles API function setProjectLogo. You may, for example, add the logo image and the current year to the project logo.

 
Put the logo.png into the images folder of your application, and add the following code to AfterAppInit event:

 

Labels_setProjectLogo "<DIV style='position: relative; height: 40px; top: -6px; white-space: nowrap;'><IMG height='80%' id='navbarlogo' alt='Project logo' src='http://mywebsite.com/images/logo.png'> Cars project - " & Year(Now) & "</DIV>","";

 

Input placeholders

 

The placeholder specifies a short hint that describes the expected value of an input field (e.g., a sample value or a short description of the expected format). Placeholders are displayed in the input field before the user enters a value.

misc_settings_label_editor_placeholders

 

Here is how it looks like in the browser:

misc_settings_label_editor_placeholders_ex

 

Check this Live Demo for more information.

 

EU cookie banner

 

This tab sets the text for the EU cookie consent banner option. You can use <br> as a line separator.

misc_settings_label_editor_eu_cookie_banner

Email settings

With Email settings, you can enter the email from which to send emails to the users, and define the settings of the custom mail server, if you do not use the built-in mail server. The Two-factor authentication must be turned off to send emails.

misc_settings_email_settings_asp

 

To send emails via Gmail, use the following settings:

 

SMTP server: smtp.gmail.com

SMTP server port: 465

Secure connection: SSL

SMTP username: <your gmail address>

SMTP password: <Gmail password>

 

Note: SMTP server, SMTP server port, as well as Secure connection (SSL) settings, may differ from the ones stated in the example. Contact your Mail Service Provider to get the necessary information.

SMS settings

The SMS Settings option lets you use your Twilio account to send the SMS to users. SMS are required to set up the Two-factor authentication.

misc_settings_sms_settings

 
You can open a Twilio account here: https://www.twilio.com/try-twilio.
 

Note: Twilio is not free. Their rates depend on the number of messages you send among many other things.

 

Multiple SMS providers

 

ASPRunnerPro supports several SMS providers, you can choose the most suitable one.

 

List of the providers:

 

1s2u.com

easysendsms.com

gatewayapi.com

messagebird.com

twilio.com

 

Here is a step-by-step instruction on how to use these providers:

 

1) Proceed to the "smsapi" folder. You can find it in your installation folder (\source\include\smsapi).

 

2) Copy an SMS provider file, e.g., "messagebird.asp", from that folder and replace the existing sms.asp file with it. The path to the SMS file is source\include\sms.asp.

 

3) Create an account on the website of the chosen provider.

 

4) Insert your credentials into the new SMS provider file.

 

After you do these steps, the messages will go through the selected SMS provider. It is used in the Two-factor authentication mechanism, and also, each time the Runner_sms function function is invoked.

Landing page

Select the application page to open after the Login page, or when the user enters the site, if the login is disabled or a guest user login is enabled. Alternatively, you can enter a custom URL, for example, a URL with search options carscars_list.asp?qs=audi.

misc_settings_landingpage_asp

Map settings

Select the map provider and enter the API Key (if required). You can get Bing maps API key for development purposes for free at bingmapsportal.com.

misc_settings_map_settings

 
To learn more about inserting maps and working with them, see Insert Map.

Error reporting

You can select Show detailed error messages to display detailed error messages or deselect it and type in the custom error message. You can also translate the custom error message into all of the languages of the project.

misc_settings_error_reporting

Add Chinese, Japanese, and Korean language support to PDF

Select this checkbox if you have selected any of the languages above as project languages and you use PDF-related options in your project.

EU cookie consent banner

Select the EU cookie consent banner checkbox to enable the customizable banner which appears at the bottom of the page. To edit the text, click the Message button, and enter the text into the EU cookie banner tab of the Label Editor.

 

Here is how the banner looks like in the browser:

misc_settings_label_editor_eu_cookie_banner_ex

Section 508 compatibility

Select this checkbox to make the project accessible to a wide range of people with disabilities. For more information, visit http://www.section508.gov/.

 

Additionally, there are keyboard hotkeys available as described below:

 

ALT+E - inline edit current record;

ALT+S - save current record;

ALT+C - cancel inline edit;

ALT+F - go to the advanced search;

ALT+M - jump to the menu;

CTRL+left arrow - previous page;

CTRL+right arrow - next page.

 

You can also use the keyboard to navigate through the table links on the List page. Press Arrow Up, Arrow Down, Tab, Shift+Tab to switch between the elements.

 

When using special internet browser readers, the hotkeys reference link becomes available.

Table specific settings

The Table specific settings are miscellaneous settings that can vary from table to table. Use the Tables list on the left-side panel to switch between tables.

miscellaneous_settings

Warn about leaving Add/Edit pages

This checkbox allows displaying a warning message upon leaving the Add/Edit pages with unsaved changes.

Display "Loading..." box on the list page

This checkbox allows displaying a loading icon until the page loads completely. Use this option if you have large size images or other elements on the page.

Next/Prev buttons on Edit/View pages

This checkbox allows displaying the Next/Prev buttons on the Edit/View pages. These buttons allow switching between records without going back to the List page.

Rollover row highlighting

Select this checkbox to turn on the row highlighting feature. This feature makes the mouse pointer highlight the table row on the list page.

Search and Filter settings

This button adjusting the search and filter settings. For more information, see Choose fields: Search and Filter settings.

Hide data until search

This option hides all of the records on the page and displays a message: "Nothing to see. Run some search". The user needs to run a search to display the results.

Records per page

This option sets the initial number of records to be displayed when the users load the page for the first time.

 

Note: to make this option work correctly, you must choose the key field for the selected table on the Choose pages screen.

Records per page selection

This field defines what options to show in pagination control. Type in all to enable the option to show all records.

Apply to all tables

This button applies the current Hide data until search, Records per page, and Records per page selection settings to every table in the project.

Enterprise Edition settings

These settings are available only in the Enterprise Edition of ASPRunnerPro.

miscellaneous_settings

Web reports

Select the Web reports checkbox to enable the online report/chart builder. Click the Administrator button to specify the password to access the Web Reports and Charts admin area.

See also:

Choose pages screen

Choose fields screen

Security screen

Page Designer

Two-factor authentication

Insert map