Application Settings - Scripting

The page contains scripting tools to extend the normal behavior of your applications with user scripts written in HEScript.

User Scripts: the Script Manager

Use HEScript scripting to customize your applications. ExeOutput for PHP uses a scripting language called HEScript. Scripts are compiled during the compilation into p-code for faster execution at runtime (contrary to JavaScript). That's why scripts are separated from HTML pages and stored in a script manager. You can manage scripts using this tab.

You may use HEScript in addition to PHP and JavaScript. In fact, JavaScript, PHP and HEScript can be easily combined.

Introduction to scripting with HEScript

img

Each script that will be compiled into the script collection of the application is listed. You have the name of the script and an optional description. Each script must have a unique name (similar to a namespace).

Quickly add HEScript code

To add a new script, press Add and the following window will appear:

img

You first give a name to the script. Space and special characters are not allowed (only alphanumeric ones). The maximum length for a script name is 255 characters.

More information about pre-defined script UserMain

You can give an optional description to your script. However, it is not used by ExeOutput for PHP at all.

Press OK to start your new script; the script editor will then be displayed to edit your new script:

img

You are not forced to edit your script right now. Just click Save to finish the script editing: you can see that the new script then appears in the script list.

More information about the script editor.

Notes

  1. By default ExeOutput for PHP automatically adds a "UserMain" script when a project is created. This script is designed for your own use and contains some pre-defined global events related to the application.
  2. You can also call HEScript functions from your PHP, HTML code (links) and even from JavaScript.
  3. Scripts are stored inside the project file. No external file is required.

To edit a given script, select it in the list and press Edit. You can also double-click it. The script editor will be displayed.

To remove a script, select it in the list and press Remove. Note that you can't remove the UserMain script.

To import/export a script, select it in the list and press XML. Then select Import/Export and you will be prompted to enter the filename for the XML file. Scripts are stored in the XML format so you can edit them with any XML editor (or even Notepad if you wish). When you import a script back, the script editor is displayed: press Save to import the script. Note that an imported script is automatically syntax-checked (this prevents possible script errors during the compilation of the application).