PHP Installation Instructions (No IBM i)

You can install the WebSmart IDE (the PC design tool) on any number of PCs that connect to the same server. Follow the steps below to install the WebSmart IDE:

1. If you haven't yet done so, go to the Download Free Software page and fill out the form to download WebSmart.

2. Download and save the PC installation files to a new folder on your PC.

3. When the download finishes execute the downloaded file to unpack the install files and initiate the install. The PC install file is named websmart96-pc.exe [the version may vary].

4. Follow the instructions to install the WebSmart executables to your PC. You should be able to accept all the default install options.

5. When it's done, the install will prompt you to launch the software. You can also launch WebSmart from your Start menu.

If this is a new install WebSmart will automatically prompt you to complete your server configuration. Select 'No' and continue with the next step.

When you install the WebSmart IDE on your PC, in the root WebSmart directory (usually C:/ESDI/WebSmart) you'll find a folder named 'Server Files'. This contains our SmartCharts, images, CSS and some PHP includes for the various templates shipped with the software.

Copy the files and folders in the 'Server Files' directory to your PHP server root. So for example, the contents of this directory:

C:/ESDI/WebSmart/Server Files/*

Need to be copied to a directory such as:

/www/websmart/htdocs/*

Please call Technical Support if you aren't sure what directory to use.

Test Your Server Installation
The server files you installed include a sample PHP program you can run to verify that the critical components required to run PHP programs were successfully installed.

To run the sample program, type the following URL into your browser:

http://your_server_path/testcfg.php

Replace your_server_path with the location to which you saved the server files.

If the test program appears, continue with the sections below.

You must have at least one FTP connection. Your FTP connections allow you retrieve and work with files related to your application, as well as set defaults for the PHP programs you create.

1. In the WebSmart IDE open the Tools/Options window and click the FTP entry to present these options:

Click the Add button to create an FTP Site:

Configure your options as described here:

After entering the required values, click the Test Connection button to verify that you have entered your configuration details correctly. If the confirmation window tells you that the connection is working, press OK to create the site and continue with the next section.

Before working with WebSmart you need to create an ODBC connection to your target database so WebSmart can load the file layouts.

To create a new ODBC connection, launch the WebSmart IDE and go to the Tools/Options menu. Select the Servers/Databases section and click Add to present these options:

Click the Add button to create an ODBC Connection:

Configure your options as described here:

After entering the required values, click the Test Connection button to verify that you have entered your configuration details correctly. If the confirmation window tells you that the connection is working, press OK to create the connection and continue with the next section.

After installing WebSmart PHP you need to set a number of connection defaults so your programs can access your server and database. While there are a few ways to handle this requirement, the WebSmart PHP program templates are set up to retrieve the connection values from a file on your server. When you execute WebSmart PHP programs, the first thing they attempt to do is load a preferences file, xl_functions001.php, by executing this statement at the top of the code:

require('/esdi/websmart/v9.6/include/xl_functions001.php');

[Adjust this path to your own server files directory (instead of /esdi/websmart/v9.6/).]

This file includes a section where you can specify default user profiles and system names (among other things). However, because this file is overwritten when you upgrade, it in turn attempts to load some of the defaults from another file, xl_user_preferences.php, which you need to create. (see our online WebSmart PHP KB article 6998 for additional details).

2. Save the file as xl_user_preferences.php (or copy and rename xl_functions.php).

3. In the new, copied file delete everything from (and including) this line up to the end of the file:

@include('xl_user_preferences.php');

Note: Leave the ?> at the end of the file!

4. In the section that remains in xl_user_preferences.php enter default values for the connections you will be using, as described here:

When you create your own application you may want to load your User IDs another way (for example, by prompting the user to enter one), but this approach will get you started.

At this point you should be ready to try running the software and start learning how to use it.

Continue with Step 2 of the 5 Steps to Success for:

• WebSmart,
• Clover or
• WebSmart PHP.

If at any point in this process you would like to have an informal chat with someone to get some suggestions on how to address your particular needs, then by all means get in touch with our Sales or Technical Support teams.

We look forward to hearing from you soon.