8/17/2019 PHPMaker_12

1/346

 

PHPMaker 12 Help

8/17/2019 PHPMaker_12

2/346

PHPMaker 12 Help

1

Table of Contents

1. PHPMaker 12 ............................................................................................................................ 3

1.1 What's New in PHPMaker 12 .............................................................................................. 3

1.2 System Requirements ....................................................................................................... 14

1.3 Installation and Uninstallation .......................................................................................... 15

1.4 License and Ordering Information .................................................................................... 16

1.5 Technical Support ............................................................................................................. 16

1.6 Disclaimer of Warranty ..................................................................................................... 17

1.7 Third-party Tools ............................................................................................................... 17

1.8 Introduction to PHP and MySQL ....................................................................................... 19

1.9 Quick Start......................................................................................................................... 28

1.10 Project Setup ................................................................................................................... 31

1.10.1 Database Setup ........................................................................................................ 31

1.10.2 PHP Settings ............................................................................................................. 38

1.10.3 HTML Settings .......................................................................................................... 48

1.10.4 Security Settings....................................................................................................... 52

1.10.5 Generate Settings .................................................................................................... 63

1.10.6 Table Setup .............................................................................................................. 66

1.10.7 Field Setup ............................................................................................................... 80

1.10.8 Lookup Table .......................................................................................................... 111

1.10.9 Server Events and Client Scripts ............................................................................ 120

1.10.10 Custom Templates ............................................................................................... 163

1.10.11 Using Custom View .............................................................................................. 171

1.10.12 Using Report ........................................................................................................ 176

1.10.13 Custom Files ......................................................................................................... 181

1.10.14 Custom Fields ....................................................................................................... 186

1.10.15 Linked Tables ....................................................................................................... 188

1.10.16 Multi-Language Project ........................................................................................ 193

1.11 Application Root ........................................................................................................... 198

1.12 Project File .................................................................................................................... 201

1.13 Tools .............................................................................................................................. 202

1.14 Customizing Template .................................................................................................. 223

1.14.1 Control File ............................................................................................................. 227

8/17/2019 PHPMaker_12

3/346

PHPMaker 12 Help

2

1.14.2 System Functions ................................................................................................... 231

1.14.3 Template Object Properties ................................................................................... 246

1.14.4 Using User Code ..................................................................................................... 268

1.14.5 Template Tags ........................................................................................................ 271

1.15 Tutorials ........................................................................................................................ 273

1.15.1 Connecting Remote MySQL using PHPMaker Connection Script .......................... 274

1.15.2 Master/Detail ......................................................................................................... 276

1.15.3 File Upload to Database ......................................................................................... 286

1.15.4 File Upload to Folder .............................................................................................. 291

1.15.5 Dynamic Selection List ........................................................................................... 296

1.15.6 Field Aggregation ................................................................................................... 299

1.15.7 User Registration System ....................................................................................... 301

1.15.8 Inline Add, Inline Copy, Inline Edit, Grid-Add and Grid-Edit .................................. 307

1.15.9 Advanced Security - User ID Security ..................................................................... 311

1.15.10 Advanced Security - Static User Level Security .................................................... 316

1.15.11 Advanced Security - Dynamic User Level Security ............................................... 323

1.15.12 Custom View ........................................................................................................ 331

1.15.13 Report .................................................................................................................. 337

1.15.14 Integrating with PHP Report Maker Project ........................................................ 343

8/17/2019 PHPMaker_12

4/346

PHPMaker 12 Help

3

1. PHPMaker 12

PHPMaker is a powerful automation tool that can generate a full set of PHP quickly from

MySQL, PostgreSQL, Microsoft Access, Microsoft SQL Server and Oracle databases.

Using PHPMaker, you can instantly create web sites that allow users to view, edit, search,

add and delete records on the web. PHPMaker is designed for high flexibility, numerous

options enable you to generate PHP applications that best suits your needs. The generated

codes are clean, straightforward and easy-to-customize. The PHP scripts can be run on

Windows servers (MySQL/PostgreSQL/Access/MSSQL/Oracle) or Linux/Unix servers

(MySQL/PostgreSQL/Oracle). PHPMaker can save you tons of time and is suitable for both

beginners and experienced develpers alike.

Also See: 

What's New in PHPMaker 12(See 1.1)

License and ordering(See 1.4)

1.1 What's New in PHPMaker 12PHPMaker 12 is a major upgrade from 11.x. It is loaded with a bunch of new features,

including many frequently requested ones. PHPMaker is probably the most powerful and

flexible product of its kind, and yet still easy-to-use as always.

Linked Tables from Multiple Databases

Now you can add Linked Tables from other databases of different database type

8/17/2019 PHPMaker_12

5/346

PHPMaker 12 Help

4

Custom Fields

Add custom fields to a table or view with SQL expression.

8/17/2019 PHPMaker_12

6/346

PHPMaker 12 Help

5

Optional Tabular Form for Desktop Mode

Option to use Bootstrap table instead of Bootstrap horizontal form for

Add/Edit/Search/Update/Register pages (Desktop mode only)

Tabular form 

8/17/2019 PHPMaker_12

7/346

PHPMaker 12 Help

6

Horizontal form 

Dropdown Selection Lists

Show the options in dropdown panel (supports SELECT, RADIO and CHECKBOX) with min-

width and max-height settings.

Multi-column Radio button list  

Multi-column Checkbox list  

8/17/2019 PHPMaker_12

8/346

PHPMaker 12 Help

7

Selection list (select-one) / Single

column radio button list  

Selection list (select-multiple) /

Single column checkbox list  

Option Template for Dropdown Selection Lists

Show options in HTML with JsRender template.

8/17/2019 PHPMaker_12

9/346

PHPMaker 12 Help

8

Improved AutoSuggest

Support Option Template, min-width and max-height settings.

Session Keep Alive and Session Timeout

Keeps session alive by Ajax or show session timeout countdown to remind users.

8/17/2019 PHPMaker_12

10/346

PHPMaker 12 Help

9

Anonymous User Level

Anonymous User becomes a built-in dynamic User Levels so administrators can setup

permissions at runtime.

New Actions to Manage User Profile (for Administrators)

Administrator can now easily do the following tasks in the List page of the User table.

Password Generator and Password Strength Meter

8/17/2019 PHPMaker_12

11/346

PHPMaker 12 Help

10

Improved Multi-Page

Options: (To be set up by Client Script)

 

Enable submit button for the last page only

  Hide disabled submit button

 

Hide inactive pages  Set inactive tabs as disabled (for tabs and pills only)

  Hide tabs (for tabs and pills only)

  Show pager (Prev/Next buttons) at top and/or bottom

  Pager template (HTML template of the Prev/Next buttons)

Simplified Client Side Events and "fields" jQuery Plugin

Add client side events easily and manipulate/validate the fields quickly with PHPMaker's

"fields" jQuery plugin.

Multi-Update of Field Settings

8/17/2019 PHPMaker_12

12/346

PHPMaker 12 Help

11

Set multiple properties of multiple fields at one time.

Import/Export of Theme Settings

Import/Export Feature of Multi-Language Property Editor

Dynamic Selection Lists in Master/Detail-Add/Edit

8/17/2019 PHPMaker_12

13/346

PHPMaker 12 Help

12

Local Storage of Search Criteria

Saves search criteria in browser local storage.

Cancel Button for Add/Edit/Delete/Update Pages

Cancel button with confirmation dialog if form data has been modified.

8/17/2019 PHPMaker_12

14/346

PHPMaker 12 Help

13

New Language Selection Buttons

Use button group with tooltip.

More Server Events

  Language_Load - For customizing the language phrases, fired after the languagefile is loaded.

  AuditTrail_Inserting - For customizing the data to be logged, fired before insertingthe audit trail log.

More Advanced Settings

  Format project file - Add indentation to XML nodes in the project file

  Allow login by session variables - For use with User_CustomValidate server event

  Session timeout period (minutes) - Specifies the session time-out period if the userdoes not refresh or request a page

  Session keep alive interval (seconds) - Specifies the interval to send Ajax request tothe server for keeping the session alive

 

Session time out countdown period (seconds) - Specifies the countdown periodbefore session ends

  Use ADOdb driver for MySQL - Use the full ADOdb driver for MySQL instead of the

lite version (ewmysql.php)  Encrypt file path - Encrypt the file path of uploaded files in URL

8/17/2019 PHPMaker_12

15/346

PHPMaker 12 Help

14

 

Reduce image size only (image resize) - Specifies if enlarging image is preferred(Migrated from previous Image Resize extension)

  Always keep aspect ratio (image resize) - Specifies if aspect ratio should be kept(Migrated from previous Image Resize extension)

  Check password strength - Specifies if the strength of inputted password forpassword fields should be checked

 

Minimum password strength - Specifies the minimum acceptable password strength 

Generate password - Specifies if a random password generation button should beadded to password field

  Password length - The length of the password to be generated

  Add plain text version in HTML email - Specifies if text version of email content isrequired

  Use tabular form for desktop - Use Boostrap table instead of Bootstrap horizontalform for Add/Edit/Search/Update/Register pages (Desktop mode only)

More

 

Use mysqli extension by default  Image Resize functionality (does not require Image Resize extension anymore)

  Multi-Language support for email template

  Lookup always by ajax ("Use Ajax" setting removed)

  Improved Custom Actions

  DetailPages property for showing and hiding detail table tabs by server event

  Password change by user (for md5 password) as password recovery

  Support Custom Attributes as PHP array

  SelectLimit() support for MSSQL >= 2005

  Global array for passing server side values to client side

  "addoption" and "newoption" client side event for lookup fields (supports both lookupfields with lookup table or user values)

 

JavaScript alerts replaced by Modal dialog

 

 jQuery, JsRender, jQuery File Upload updated  tinyMCE and CKEditor extensions (for registered users only) updated with latest

versions

  Multi-Language support for reCAPTCHA, JsCalendar, tinyMCE and CKEditor

  QRCode/BarCode Custom View Tags combined (Flash Files Custom View Tagremoved)

  A new built-in "plain" theme

  UTF-8 output files if project charset is utf-8

 

PHPMailer updated

 

Setting PHPMailer properties in Email_Sending server event

  mobile_detect.php updated and mobile-detect.js adopted

  Bootstrap 3.3.5

 

Many other minor improvements

1.2 System RequirementsPHPMaker 

  Windows Vista/2008/2012/7/8

PHPMaker requires the following system files. If you do not have latest version of these files,

you may experience ActiveX errors. To update your system, go the Microsoft download

pages listed below.

 

Service Pack 6 for Visual Basic 6.0: Run-Time Redistribution Pack (vbrun60sp6.exe) 

http://www.microsoft.com/downloads/details.aspx?FamilyId=7B9BA261-7A9C-43E7-9117-F673077FFB3C&displaylang=enhttp://www.microsoft.com/downloads/details.aspx?FamilyId=7B9BA261-7A9C-43E7-9117-F673077FFB3C&displaylang=enhttp://www.microsoft.com/downloads/details.aspx?FamilyId=7B9BA261-7A9C-43E7-9117-F673077FFB3C&displaylang=en

8/17/2019 PHPMaker_12

16/346

PHPMaker 12 Help

15

 

MSXML Parser 3.0 

 

IIS Express (only required if you want to use IIS Express as testing web server)

If you use Microsoft Access, SQL Server or Oracle, PHPMaker requires the following database

drivers to connect to the database:

 

Microsoft Data Access Components (MDAC) 2.8 (for Microsoft Access, SQL Serverand Oracle)

  Microsoft Jet 4.0 Service Pack 8 (SP8) (for Microsoft Access = 5.3 

Browser 

  IE 9+, Chrome/Firefox/Safari/Opera (current stable version and the

version that preceded it). 

1.3 Installation and UninstallationImportant Before you install PHPMaker, you must log in Windows as an user withadministrative privileges.

PHPMaker 12 can co-exist with previous version of PHPMaker. You do NOT need to uninstall

previous version of PHPMaker if you don't want to.

Double-click on the downloaded installer to start the installation process. Follow the prompts

and change the settings whenever necessary.

To uninstall PHPMaker, go to [Control Panel]. Click [Add/Remove Programs] and select

[PHPMaker 12].

Note for Windows Vista/2008/2012/7/8 users:

In Windows Vista/2008/2012/7/8, User Account Control (UAC) is enabled by default,

members of the administrators group do NOT have full administrator privileges.

When you install (by double-clicking the installer or right-clicking the installer and choose

Run as administrator), an User Account Control prompt may be displayed and ask you

if you allow the program to make changes to your computer, click Yes to let the installer run

elevated.

If you still cannot install successfully, log in Windows as the built-in administrator

account to install. The built-in administrator account is disabled by default, you may need

to enable the built-in administrator account first:

http://www.microsoft.com/technet/security/Bulletin/MS10-051.mspxhttp://www.microsoft.com/technet/security/Bulletin/MS10-051.mspxhttp://learn.iis.net/page.aspx/868/iis-express-overview/http://learn.iis.net/page.aspx/868/iis-express-overview/http://www.microsoft.com/downloads/en/details.aspx?FamilyID=78cac895-efc2-4f8e-a9e0-3a1afbd5922ehttp://www.microsoft.com/downloads/en/details.aspx?FamilyID=78cac895-efc2-4f8e-a9e0-3a1afbd5922ehttp://support.microsoft.com/?kbid=829558http://support.microsoft.com/?kbid=829558http://www.microsoft.com/downloads/details.aspx?FamilyID=7554f536-8c28-4598-9b72-ef94e038c891&DisplayLang=enhttp://www.microsoft.com/downloads/details.aspx?FamilyID=7554f536-8c28-4598-9b72-ef94e038c891&DisplayLang=enhttp://www.microsoft.com/download/en/details.aspx?id=13255http://www.microsoft.com/download/en/details.aspx?id=13255http://www.microsoft.com/download/en/details.aspx?id=29065http://www.microsoft.com/download/en/details.aspx?id=29065http://www.oracle.com/technetwork/topics/winsoft-085727.htmlhttp://www.oracle.com/technetwork/topics/winsoft-085727.htmlhttp://technet.microsoft.com/en-us/library/cc709691(v=ws.10).aspx#BKMK_WhatIshttp://technet.microsoft.com/en-us/library/cc709691(v=ws.10).aspx#BKMK_WhatIshttp://technet.microsoft.com/en-us/library/cc709691(v=ws.10).aspx#BKMK_WhatIshttp://technet.microsoft.com/en-us/library/cc709691(v=ws.10).aspx#BKMK_WhatIshttp://www.oracle.com/technetwork/topics/winsoft-085727.htmlhttp://www.microsoft.com/download/en/details.aspx?id=29065http://www.microsoft.com/download/en/details.aspx?id=13255http://www.microsoft.com/downloads/details.aspx?FamilyID=7554f536-8c28-4598-9b72-ef94e038c891&DisplayLang=enhttp://support.microsoft.com/?kbid=829558http://www.microsoft.com/downloads/en/details.aspx?FamilyID=78cac895-efc2-4f8e-a9e0-3a1afbd5922ehttp://learn.iis.net/page.aspx/868/iis-express-overview/http://www.microsoft.com/technet/security/Bulletin/MS10-051.mspx

8/17/2019 PHPMaker_12

17/346

PHPMaker 12 Help

16

1. 

Login as administrator. Open a command prompt (under All Programs ->Accessories) in administrator mode by right-clicking and choosing Run asadministrator,

2. 

Type the command: net user administrator /active:yes. You should see:

"The command completed successfully."3.

 

Log out. You'll now see the Administrator account show up on the login screen.

Log in as the built-in administrator and install again. After successful installation, if you want

to disable the built-in administrator account. Logout and re-login as your regular user

account, and then open an administrator mode command prompt as above. Type the

command: net user administrator /active:no. The administrator account will now

be disabled, and should not show up on the login screen anymore.

1.4 License and Ordering InformationPHPMaker is not a free software. You are permitted to use this program for a period of 30

days. Continued use after that will require payment of the registration fee.

Benefits for registered users 

  Free upgrades of all minor versions for 12 months

  Free email support for 6 months

  Email notifications of upgrades

  Access to registered user site

  Additional extensions (if any)

After receiving your license key, register by clicking [Help]->[Register].

Note To register the program in Windows Vista/2008/2012/7/8 (or later), you needadministrative privileges and you may need to start the program by right clicking the

program file (.exe file) in the installed folder or its shortcut on the desktop and choose Run

as administrator. For more info on User Account Control (UAC), read:

http://support.microsoft.com/kb/922708 

Registration can be done as follows:

Credit Card Payment

http://www.hkvstore.com/phpmaker/purchase.asp 

Mail order or Wire Transfer

Hong Kong Dollars Cheque or Money Order (List price), OR

International Bank Cheque or International Money Order or Wire Transfer or other payment

method (List price plus 25%)

Please contact sales@hkvstore.com for information about our bank account.

1.5 Technical SupportRegistered users are entitled to 6 months free email support. Send your technical support

request to php.support@hkvstore.com. 

Your email message should include the following information:

http://technet.microsoft.com/en-us/library/cc709691(v=ws.10).aspx#BKMK_WhatIshttp://technet.microsoft.com/en-us/library/cc709691(v=ws.10).aspx#BKMK_WhatIshttp://www.hkvstore.com/phpmaker/purchase.asphttp://www.hkvstore.com/phpmaker/purchase.aspmailto:sales@hkvstore.commailto:sales@hkvstore.commailto:sales@hkvstore.commailto:php.support@hkvstore.commailto:php.support@hkvstore.commailto:php.support@hkvstore.commailto:php.support@hkvstore.commailto:sales@hkvstore.comhttp://www.hkvstore.com/phpmaker/purchase.asphttp://technet.microsoft.com/en-us/library/cc709691(v=ws.10).aspx#BKMK_WhatIs

8/17/2019 PHPMaker_12

18/346

PHPMaker 12 Help

17

1. 

Is the problem reproducible? If so, provide the steps to reproduce it?2.  What version of Windows is your PC running?3.  What version of PHPMaker are you running? (Click [Help] and then [About...] to

check)4.

 

What database and what version are you using?5.  What OS is the server running? Windows or Linux? What version of PHP is running?

(Note that PHP 4 is not supported.)6.

 

If any error message was displayed, please include the full text of error message. Ifnot, describe the problem in detail.

7.  Your project file (.pmp file) and your database (.sql file) with enough data forreproducing the problem.

8. 

Your license information. Emails without license information will be ignored.

Note While we are happy to support your usage of our software, please note that technical

support does NOT entail customization of templates, extensions or generated code, writing

server events or client scripts (JavaScripts) or custom template, integrating third-party

code, setting up web server, or any other issues not directly related to the workings of the

software. Request for debugging or modifying code not generated from the original template

will be ignored.

1.6 Disclaimer of WarrantyPHPMaker is supplied "AS IS". The authors disclaim all warranties, expressed or implied,

including, without limitation, the warranties of merchantability and of fitness for any

purpose. The authors assume no liability for damages, direct or consequential, which may

result from the use of PHPMaker.

Please note this program is Shareware. It is not Freeware. You are permitted to try the

program for a maximum of 30 days. Continued use will require payment of the registration

fee. Please refer to the License and Ordering(See 1.4) Section for details.

1.7 Third-party ToolsNote All the following tools are not developed by the author of PHPMaker and are not part of

PHPMaker, NO TECHNICAL SUPPORT WILL BE PROVIDED.

PHPMaker uses the following third-party tools in template/extensions:

CKeditor 

Website: http://ckeditor.com 

CKEditor is distributed under the MPL Open Source license. If IE, requires IE >= 9. 

JSCalandarWebsite: http://www.dynarch.com/projects/calendar/old 

This program is available under the terms of the GNU Lesser General Public License version

2.1 or above.

PHPMailer

Website: http://phpmailer.sourceforge.net 

This program is available under the terms of the GNU Lesser General Public License version

2.1 or above.

DOMPDF

Website: http://code.google.com/p/dompdf  

DOMPDF is available under the terms of the LGPL License.

Requires MBString and DOM extensions.

http://ckeditor.com/http://ckeditor.com/http://ckeditor.com/http://www.dynarch.com/projects/calendar/old/http://www.dynarch.com/projects/calendar/old/http://www.dynarch.com/projects/calendar/old/http://phpmailer.sourceforge.net/http://phpmailer.sourceforge.net/http://phpmailer.sourceforge.net/http://code.google.com/p/dompdf/http://code.google.com/p/dompdf/http://code.google.com/p/dompdf/http://code.google.com/p/dompdf/http://phpmailer.sourceforge.net/http://www.dynarch.com/projects/calendar/old/http://ckeditor.com/

8/17/2019 PHPMaker_12

19/346

PHPMaker 12 Help

18

Warning This extension is EXPERIMENTAL only. There are some known issues of DOMPDF,

please read the developer website for more information. Known issues includes (but now

limited to):

 

not particularly tolerant to poorly-formed HTML input

 

large files can take a while to render

 

use a lot of memory

 jQuery

Website: http://jquery.com/ 

 jQuery is released under MIT License.

JsRender

Website: https://github.com/BorisMoore/jsrender 

JsRender is released under MIT License.

Bootstrap

Website: http://getbootstrap.com/ 

Bootstrap is licensed under Apache License v2.0.

Barcode and QRCode 

Website: http://www.phpclasses.org/package/2441-PHP-Generate-barcode-graphs-using-

different-standards.html 

The class is distributed for free without warranty.

PHP Thumb 

Website: https://github.com/masterexploder/PHPThumb

PHP Thumb is distributed under the MIT License.

Supports GIF, JPEG and PNG images only. Requires PHP GD2 extension.

pGenerator and pStrength Website: https://github.com/M1Sh0u/pGenerator and

https://github.com/M1Sh0u/pStrength/blob/master/pStrength.jquery.js 

Both are released under the MIT License.

Additional extensions: (for registered users only)

Note Additional extensions are provided for registered users as examples of customzing and

extending template only, NO TECHNICAL SUPPORT WILL BE PROVIDED. Registered users

will be provided information to download the extensions. These tools will NOT automatically

work with PHPMaker without the extensions.

Horizontal Menu 

Replaces the graphical extension for previous versions. Uses Bootstrap Navbar as horizontal

menu.

FCKeditor File Manager (for CKEditor) 

FCKeditor is the previous version of CKEditor and has been discontinued after version

2. FCKeditor extension had been dropped by PHPMaker. This extension only applies

the free File Manager from FCKeditor to CKEditor (so the commerical product CKFinder is not

required), based on http://www.mixedwaves.com/2010/02/integrating-fckeditor-

filemanager-in-ckeditor/. 

FCKeditor Website: http://sourceforge.net/projects/fckeditor/ 

FCKeditor is distributed under the LGPL Open Source license.

http://jquery.com/http://jquery.com/http://jquery.com/https://github.com/BorisMoore/jsrenderhttps://github.com/BorisMoore/jsrenderhttps://github.com/BorisMoore/jsrenderhttp://getbootstrap.com/http://getbootstrap.com/http://getbootstrap.com/http://www.phpclasses.org/package/2441-PHP-Generate-barcode-graphs-using-different-standards.htmlhttp://www.phpclasses.org/package/2441-PHP-Generate-barcode-graphs-using-different-standards.htmlhttp://www.phpclasses.org/package/2441-PHP-Generate-barcode-graphs-using-different-standards.htmlhttp://www.phpclasses.org/package/2441-PHP-Generate-barcode-graphs-using-different-standards.htmlhttps://github.com/masterexploder/PHPThumbhttps://github.com/masterexploder/PHPThumbhttps://github.com/M1Sh0u/pGeneratorhttps://github.com/M1Sh0u/pGeneratorhttps://github.com/M1Sh0u/pGeneratorhttps://github.com/M1Sh0u/pStrength/blob/master/pStrength.jquery.jshttps://github.com/M1Sh0u/pStrength/blob/master/pStrength.jquery.jshttp://twitter.github.io/bootstrap/components.html#navbarhttp://twitter.github.io/bootstrap/components.html#navbarhttp://twitter.github.io/bootstrap/components.html#navbarhttp://www.mixedwaves.com/2010/02/integrating-fckeditor-filemanager-in-ckeditor/http://www.mixedwaves.com/2010/02/integrating-fckeditor-filemanager-in-ckeditor/http://www.mixedwaves.com/2010/02/integrating-fckeditor-filemanager-in-ckeditor/http://www.mixedwaves.com/2010/02/integrating-fckeditor-filemanager-in-ckeditor/http://sourceforge.net/projects/fckeditor/http://sourceforge.net/projects/fckeditor/http://sourceforge.net/projects/fckeditor/http://sourceforge.net/projects/fckeditor/http://www.mixedwaves.com/2010/02/integrating-fckeditor-filemanager-in-ckeditor/http://www.mixedwaves.com/2010/02/integrating-fckeditor-filemanager-in-ckeditor/http://twitter.github.io/bootstrap/components.html#navbarhttps://github.com/M1Sh0u/pStrength/blob/master/pStrength.jquery.jshttps://github.com/M1Sh0u/pGeneratorhttps://github.com/masterexploder/PHPThumbhttp://www.phpclasses.org/package/2441-PHP-Generate-barcode-graphs-using-different-standards.htmlhttp://www.phpclasses.org/package/2441-PHP-Generate-barcode-graphs-using-different-standards.htmlhttp://getbootstrap.com/https://github.com/BorisMoore/jsrenderhttp://jquery.com/

8/17/2019 PHPMaker_12

20/346

PHPMaker 12 Help

19

TinyMCE 

Website: http://tinymce.moxiecode.com 

TinyMCE is distributed under the LGPL Open Source license. If IE, requires IE >= 9. 

Time Picker

Website: http://jonthornton.github.io/jquery-timepicker/ 

Timepicker Plugin for jQuery is made available under the open source MIT License.

PHPExcel 

Website: http://phpexcel.codeplex.com 

This program is available under the terms of the GNU Lesser General Public License version

2.1 or above. Requires PHP version 5.2.0 or higher, PHP extension php_zip enabled (for

Excel2007 format), PHP extension php_xml enabled and PHP extension php_gd2 enabled (if

not compiled in).

PHPWord 

Website: http://phpword.codeplex.com 

This program is available under the terms of the GNU Lesser General Public License version

2.1 or above. Requires PHP version 5.2.0 or higher, PHP extension php_zip enabled, PHPextension php_xml enabled and PHP extension php_gd2 enabled (if not compiled in).

Detail Preview 

Allow previewing detail records in an expanded row of the main table in List page, and/or in

a popup overlay by Bootstrap Popover. 

Scrollable Table

Scrolling table example. Enable X/Y scrolling of the main table in the List page. If IE,

requires IE >= 9. 

CAPTCHA

Generates CAPTCHA image. Requires PHP GD extension with GD2.

Also support reCAPTCHA (https://developers.google.com/recaptcha/). reCAPTCHA is

OPTIONAL. If you choose to use reCAPTCHA, note that reCAPTCHA is a Web service,

meaning that the CAPTCHA images are served directly from reCAPTCHA's servers to the end

users, the end users need to be online. To use the service, you must register at the

reCAPTCHA Web site and obtain public and private keys.

1.8 Introduction to PHP and MySQLWhat is PHP?

PHP is a widely-used general-purpose server-side scripting language that can be embedded

into HTML. You can think of it as a "plug-in" for your Web server that will allow it to do more

than just send plain Web pages when browsers request them. With PHP installed, your Web

server will be able to read a new kind of file (called a PHP script ) that can do things like

retrieve up-to-the-minute information from a database and insert it into a Web page before

sending it to the browser that requested it. PHP is completely free to download and use. If

you are new to PHP and want to get some idea of how it works, try the  introductory tutorial. 

PHP Home Page

Manual 

Download

What is MySQL?

http://tinymce.moxiecode.com/http://tinymce.moxiecode.com/http://tinymce.moxiecode.com/http://jonthornton.github.io/jquery-timepicker/http://jonthornton.github.io/jquery-timepicker/http://jonthornton.github.io/jquery-timepicker/http://phpexcel.codeplex.com/http://phpexcel.codeplex.com/http://phpexcel.codeplex.com/http://phpword.codeplex.com/http://phpword.codeplex.com/http://phpword.codeplex.com/http://getbootstrap.com/javascript/#popovershttp://getbootstrap.com/javascript/#popovershttp://getbootstrap.com/javascript/#popovershttps://developers.google.com/recaptcha/https://developers.google.com/recaptcha/https://developers.google.com/recaptcha/http://www.php.net/tut.phphttp://www.php.net/tut.phphttp://www.php.net/tut.phphttp://www.php.net/docs.phphttp://www.php.net/docs.phphttp://www.php.net/downloads.phphttp://www.php.net/downloads.phphttp://www.php.net/downloads.phphttp://www.php.net/downloads.phphttp://www.php.net/docs.phphttp://www.php.net/docs.phphttp://www.php.net/tut.phphttps://developers.google.com/recaptcha/http://getbootstrap.com/javascript/#popovershttp://phpword.codeplex.com/http://phpexcel.codeplex.com/http://jonthornton.github.io/jquery-timepicker/http://tinymce.moxiecode.com/

8/17/2019 PHPMaker_12

21/346

PHPMaker 12 Help

20

MySQL is a relational database management system, or RDBMS. It has become the world's

most popular open source database because of its consistent fast performance, high

reliability and ease of use. PHP has MySQL extension which makes it really easy to access

data in MySQL.

MySQL Home Page 

ManualDownload 

Useful MySQL Database Administration Tools

phpMyAdmin (freeware)

Installing PHP and MySQL on Windows

Both PHP and MySQL support various platforms, including Windows. It is recommended

that you install MySQL and PHP on your computer so you can easily develop and

test your PHP locally before uploading to your production server. 

If you use Internet Information Services (IIS), you can install PHP on your Windows system

PHP for Windows installer which installs PHP for IIS, it configures the web server as well.

Alternatively, you can use Microsoft Web Platform Installer, see http://php.iis.net/. 

If you do not have IIS, you can use other Web server such as Apache. If you have difficulties

installing PHP and MySQL, you might as well try EasyPHP which is an "out of the box"

Apache, MySQL, and PHP installation for Windows.

For PHP 5, MySQL is not enabled by default, so the php_mysql.dll (or php_mysqli.dll) DLL

must be enabled in php.ini. Also, PHP needs access to the MySQL client library. A file namedlibmysql.dll is included in the Windows PHP distribution and in order for PHP to talk to MySQL

this file needs to be available to the Windows systems PATH.

The next step is to set up a valid configuration file for PHP, the php.ini. PHP searches for

php.ini in the locations described in The configuration file. 

Note If you're using NTFS on Windows, make sure that the user running the web server has

read permissions to your php.ini (e.g. make it readable by Everyone).

Some Important Settings in php.ini for Using PHP on Windows 

extension_dir - In what directory PHP should look for dynamically loadable extensions. It

should be set to the folder where your extensions are installed, e.g.extension_dir="C:\Program Files (x86)\PHP\ext"

session.save_path - This is the path where session data files are stored. Make sure this

setting points to an existing folder on your machine, e.g.

session.save_path="C:\Windows\Temp"

Note If you're using NTFS on Windows, make sure that the user running the web server has

write permissions to this folder (e.g. make it readable and writable by Everyone). See the

section Configuring Permissions below.

upload_tmp_dir - If you want to use file upload, make sure this setting points to an existing

folder on your machine, e.g. upload_tmp_dir="C:\Windows\Temp"

http://www.mysql.com/http://www.mysql.com/http://dev.mysql.com/doc/http://dev.mysql.com/downloads/http://dev.mysql.com/downloads/http://www.phpmyadmin.net/home_page/index.phphttp://www.phpmyadmin.net/home_page/index.phphttp://windows.php.net/download/http://windows.php.net/download/http://windows.php.net/download/http://php.iis.net/http://php.iis.net/http://php.iis.net/http://www.easyphp.org/?lang=enhttp://www.easyphp.org/?lang=enhttp://www.easyphp.org/?lang=enhttp://www.php.net/manual/en/configuration.file.phphttp://www.php.net/manual/en/configuration.file.phphttp://www.php.net/manual/en/configuration.file.phphttp://www.php.net/manual/en/ini.core.php#ini.extension-dirhttp://www.php.net/manual/en/ini.core.php#ini.extension-dirhttp://www.php.net/manual/en/session.configuration.php#ini.session.save-pathhttp://www.php.net/manual/en/session.configuration.php#ini.session.save-pathhttp://www.php.net/manual/en/ini.core.php#ini.upload-tmp-dirhttp://www.php.net/manual/en/ini.core.php#ini.upload-tmp-dirhttp://www.php.net/manual/en/ini.core.php#ini.upload-tmp-dirhttp://www.php.net/manual/en/session.configuration.php#ini.session.save-pathhttp://www.php.net/manual/en/ini.core.php#ini.extension-dirhttp://www.php.net/manual/en/configuration.file.phphttp://www.easyphp.org/?lang=enhttp://php.iis.net/http://windows.php.net/download/http://www.phpmyadmin.net/home_page/index.phphttp://dev.mysql.com/downloads/http://dev.mysql.com/doc/http://dev.mysql.com/doc/http://www.mysql.com/

8/17/2019 PHPMaker_12

22/346

PHPMaker 12 Help

21

Note If you're using NTFS on Windows, make sure that the user running the web server has

write permissions to this folder (e.g. make it readable and writable by Everyone). See the

section Configuring Permissions below.

php_com_dotnet.dll - If you use MS Access or MS SQL Server (on Windows server), the COM

extension is required. As of PHP 5.3.15 / 5.4.5, the COM extension

requires php_com_dotnet.dll to be enabled inside of php.ini, i.e.extension=php_com_dotnet.dll

Note Also make sure you have installed the php_com_dotnet.dll in the extension folder

(extension_dir) specified in php.ini.

Internet Information Services (IIS)

IIS 7.x or later is included with Windows Vista/2008/2012/7/8/10 and is installed via

Programs->Turn on or off Windows features in the Control Panel. Read:

http://www.iis.net/learn/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-

7 

Creating Virtual Directories in IIS 7 (Windows Vista or Later) 

The IIS manager user interface consists of three panes.

The left hand side pane is Connections, the middle pane is Workspace and the right hand

side pane is Actions.

The Connections pane lists application pools and websites. The workspace pane consists of

two tabs at the bottom namely Features View and Content View. The Features View

allows you to work with the settings of the selected item from Connections pane whereas

the Content View displays all the child nodes (content) of the selected item.

http://php.net/manual/en/com.installation.phphttp://php.net/manual/en/com.installation.phphttp://www.php.net/manual/en/ini.core.php#ini.extension-dirhttp://www.php.net/manual/en/ini.core.php#ini.extension-dirhttp://www.php.net/manual/en/ini.core.php#ini.extension-dirhttp://www.iis.net/learn/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7http://www.iis.net/learn/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7http://www.iis.net/learn/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7http://www.iis.net/learn/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7http://www.iis.net/learn/install/installing-iis-7/installing-iis-on-windows-vista-and-windows-7http://www.php.net/manual/en/ini.core.php#ini.extension-dirhttp://php.net/manual/en/com.installation.php

8/17/2019 PHPMaker_12

23/346

PHPMaker 12 Help

22

Application pool is a group of IIS applications that are isolated from other application

pools. Each application pool runs in its own worker process. Any problem with that process

affects the applications residing in it and not the rest of the applications. You can configure

application pools individually.

In order to create a new application pool, select "Application Pools" under Connections pane.

Then click on "Add application pool" from Actions pane. This will open a dialog as shownbelow:

Specify a name for the new pool to be created. Select .NET framework version that all the

applications from the pool will use. Also select pipeline mode. There are two pipeline modes

viz. integrated and classic. The integrated mode uses the integrated request processing

model whereas the classic mode uses the older request processing model. Click OK to create

the application pool.

Your new application pool will now be displayed in the Workspace pane. To configure the

application pool click on the "Advanced Settings" option under Actions pane. The following

figure shows many of the configurable properties of an application pool.

8/17/2019 PHPMaker_12

24/346

PHPMaker 12 Help

23

If you use 64-bit Windows, set Enable 32-Bit Applications to True. (See Running on 64-

bit Windows Operating System below.)

To create a new web site, select Web Sites node under Connections pane and then click on

"Add Web Site" under Actions pane. This opens a dialog as shown below:

8/17/2019 PHPMaker_12

25/346

PHPMaker 12 Help

24

Here, you can specify properties of the new web site including its application pool and

physical location.

Creating an IIS application or a Virtual Directory is quick and simple. Just right click on

the web site and choose either "Add Application" or "Add Virtual Directory" to open

respective dialogs (see below).

8/17/2019 PHPMaker_12

26/346

PHPMaker 12 Help

25

An existing Virtual directory can be marked as an IIS application by right clicking on it and

selecting "Convert to Application".

If you use IE, you may encounter the following error messages when you run PHP pages

with IIS 7:

 An error occurred on the server when processing the URL. Please contact the system

administrator. 

Go to Internet Options -> Advanced, disable Show friendly HTTP error messages.

8/17/2019 PHPMaker_12

27/346

PHPMaker 12 Help

26

Configuring Permissions

An important aspect of working with file upload to a folder on the Web server is to correctly

configure permissions.

When a Web application uses a file, the application must have Read permission to the file so

the application can access the data. Additionally, the application must have Write permission

to the folder that contains the file. Write permission is required because the file may be

created at run time.

If you use Linux/Unix, CHMOD your upload folder to "777" by using your FTP software.

To use an Access database in an PHP Web application, you must configure the folder that

contains the Access database to have both Read and Write permissions for the IIS user

account.

The default anonymous IIS user depends on IIS version. In IIS 5, it is

IUSR_. In IIS 6 and IIS 7 it can be NETWORKSERVICE or IUSR. In IIS 7.5

it depends on Application Pool, read Application Pool Identities for detail.

To set permissions in the folder (if you're using NTFS on Windows),

http://learn.iis.net/page.aspx/624/application-pool-identities/http://learn.iis.net/page.aspx/624/application-pool-identities/http://learn.iis.net/page.aspx/624/application-pool-identities/http://learn.iis.net/page.aspx/624/application-pool-identities/

8/17/2019 PHPMaker_12

28/346

PHPMaker 12 Help

27

1. 

In Windows Explorer, move to the root folder for the Web site. e.g.C:\Inetpub\wwwroot\ExampleSite.

2.  If the folder does not already exist, create one.3.

 

Right-click the folder, click Properties, and then click the Security tab.

4. 

Under Group or user names, look for or add the user.5.

 

Verify that the account has Read and Write permissions for the folder.

Similarly, set permissions in the folder where the audit trail log file reside.

Running on 64-bit Windows Operating System 

Windows Server 2008 or Windows 7 64-bit (IIS 7.x) 

On 64-bit Windows 2008/7, IIS 7.x can run both 32-bit and 64-bit worker processes

simultaneously. To run 32-bit Web applications in IIS 7.x on 64-bit Windows all it needs is to

assign the 32-bit applications to a separate application pool in IIS and turn on the Enable

32-Bit Applications switch for that application pool. To do this, open IIS Manager, open

Application Pool, select the application pool, and then click Advanced Settings. In

Enable 32-Bit Applications, select True.

8/17/2019 PHPMaker_12

29/346

PHPMaker 12 Help

28

1.9 Quick StartPHPMaker connects to your database, extracts tables and fields information, and generates

PHP scripts instantly based on these information. For each table, it will generate a list page,

add/copy page, view page, edit page, delete page and search page all linked up properly.

To generate scripts, you just need to follow the tabs and setup the options, that is:

[Database] > [PHP] > [HTML] > [Security] > [Generate]

However, if you are a first time user, we recommend you to generate a basic PHP application

and get to know how PHPMaker and PHP works first.

Note If you have not used PHP before, it is recommended that you read Introduction to PHP

and MySQL(See 1.8) first.

To generate your first PHP project, you can skip the options and use default settings first. In

other words, you skip the intermediate steps and go directly to the [Generate] tab after

connecting to your data source, that is:

[Database] > [Generate]

You can generate the web site quickly by the following steps:

1. Start up PHPMaker. There are two connection methods to connect to your MySQL server -

DIRECT or URL. As explained in Introduction to PHP and MySQL(See 1.8), it is recommended

that you have a local MySQL server during development. You usually connect to MySQL by

the DIRECT method, the URL method is only used when you want to conenct to a remote

MySQL server which does not allow direct connection. (See Tutorial - Connecting Remote

MySQL using PHPMaker Connection Script(See 1.15.1).)

2. In this example, we use direct connection. Enter connection details for the MySQL Server

.

8/17/2019 PHPMaker_12

30/346

PHPMaker 12 Help

29

3. Click the [Connect] button to load the database information. Tables and fields

information will be loaded and displayed on the left hand side.

4. Click the [Generate] tab and select the follows:

Template file - The zipped file that contains the template of the generated pages. Just use

the default template is shipped with PHPMaker.

Application root folder - The root folder of your PHP application. (See Application

Root(See 1.11))

Destination folder - The folder that the generated scripts will reside. This can be same as

the application root folder or a subfolder under the application root folder. In this case, we

use the same folder for simplicity.

8/17/2019 PHPMaker_12

31/346

PHPMaker 12 Help

30

To run PHP you need to setup a website or virtual directory (See Introduction to PHP and

MySQL (See 1.8)). If you are not familiar with web server, you can install IIS Express which

can be downloaded from Microsoft website. Then select [IIS Express] and [Browse after

generation] in PHPMaker.

5. Click the [Generate] button, the generation process will begin. After the web site is

generated successfully, a completion message will be displayed. The web site should then be

ready to run. If [Browse after generation] is enabled, PHPMaker will open your browser,

and - voila! - you'll see PHP displaying the data in your first PHP website.

http://www.microsoft.com/web/gallery/install.aspx?appid=IISExpresshttp://www.microsoft.com/web/gallery/install.aspx?appid=IISExpresshttp://www.microsoft.com/web/gallery/install.aspx?appid=IISExpresshttp://www.microsoft.com/web/gallery/install.aspx?appid=IISExpress

8/17/2019 PHPMaker_12

32/346

PHPMaker 12 Help

31

After understanding how it works, you can then take advantages of various other options

provided by PHPMaker and setup your project more precisely. See Project Setup(See 1.10)

for full details.

1.10 Project SetupTo make use of the various features of PHPMaker and create scripts that best suit your Web

sites, read the following information and get to know the options PHPMaker provide. It is

assumed that you have basic knowledges of HTML and PHP and the technical terms are used

without further explanation. To generate a Web site, please perform the following steps:

1.  Database(See 1.10.1)2.

 

PHP(See 1.10.2)3.

 

HTML(See 1.10.3)4.

 

Security(See 1.10.4)5.

 

Generate(See 1.10.5)

To further control the functionality of the generated scripts, you can setup different optionsfor each table/field:

  Table Setup(See 1.10.6)

  Field Setup(See 1.10.7)

You can also setup additional database objects for your project in PHPMaker:

  Custom View(See 1.10.11)

  Report(See 1.10.12)

  Custom File(See 1.10.13)

  Linked Table(See 1.10.15)

1.10.1 Database SetupIf you are not at the [Database] tab yet, clicking the icon in the toolbar to go to

[Database] tab. PHPMaker can connect to MySQL, PostgresSQL, Microsoft Access, Microsoft

SQL Server and Oracle.

1. MySQL 

Select MySQL as database type.

8/17/2019 PHPMaker_12

33/346

PHPMaker 12 Help

32

There are 2 connection methods you can choose:

Direct Connection (default)

1. 

Enter your database host/server name (or IP address), username, password andport number (default is 3306 for MySQL),

2. 

Select your database,3.

 

Select the SQL Identifier Quote Character, default is backquote (`) for MySQL,

4. 

Click the [Connect] button to load the database information.

Note The server name or IP should be valid on your production Web server also. Otherwise

you'll need to modify the generated connection info in ewcfg*.php before you upload it to

your production server. For example, if you have a testing MySQL Server installed on the

same computer, you can use "localhost" as server name when you connect to it with

PHPMaker. The generated scripts will then try to connect to a MySQL Server on the same

computer as the production Web server, if this is not the case, the connection will fail.

URL Connection (for remote database)

(Also see Tutorial - Connecting Remote MySQL using PHPMaker Connection Script(See

1.15.1))

While the direct connection method is quick and easy, some remote MySQL server may not

allow direct connection. PHPMaker provides an alternative simple way to connect remote

servers:

1. 

Upload the PHP connection script provided by PHPMaker to your site. Note that:

a.  The script is named "phpmaker.php" and can be found under your installedfolder, usually C:\PHPMaker,

b. 

Always use the script shipped with your version of PHPMaker.

PHPMaker may not work with script shipped with previous versions. 

2.  If it is the first time that you use this script, you may want to test the script with

your browser:

8/17/2019 PHPMaker_12

34/346

PHPMaker 12 Help

33

a. 

Browse to this script with your browser,

b.  Enter the connection info,

c. 

Click "Get Database List" and then "View Schema", you should be able toview the schema of your database in XML properly. Now go back toPHPMaker.

3. 

Enter the SAME connection information, select URL for connection method, enter theURL of the script (e.g. http://servername/path/phpmaker.php), you can test the URLby clicking the [Test] button,

4. 

Click the [Connect] button to load the database information. PHPMaker will connectto the database server through the PHP script over HTTP.

8/17/2019 PHPMaker_12

35/346

PHPMaker 12 Help

34

2. PostgreSQL 

Select PostgreSQL as database type.

There are 2 connection methods you can choose:

Direct Connection (default)

1. 

Enter your database host/server name (or IP address), username, password andport number (default is 5432 for PostgreSQL),

2.  Select your database,3.

 

Select the SQL Identifier Quote Character, default is double quote (") forPostgreSQL,

4.  Click the [Connect] button to load the database information.

Note The server name or IP should be valid on your production Web server also. Otherwise

you'll need to modify the generated connection info in ewcfg*.php before you upload it to

your production server. For example, if you have a testing PostgreSQL Server installed onthe same computer, you can use "localhost" as server name when you connect to it with

PHPMaker. The generated scripts will then try to connect to a PostgreSQL Server on the

same computer as the production Web server, if this is not the case, the connection will fail.

URL Connection (for remote database)

Similar to above for MySQL.

3. Microsoft Access (Windows only) 

Note If you use Microsoft Access database, you need to have OLEDB drivers installed on both

the PC running PHPMaker and on the web server. See System Requirements(See 1.2).(ODBC connection is not supported.)

8/17/2019 PHPMaker_12

36/346

PHPMaker 12 Help

35

  Select Microsoft Access as database type,

  Select the Microsoft Access database file by clicking the button,

  Specify the database path where the database file will reside under the yourapplication root,

  Click the Connect button to load the database information.

Notes 

1. 

Database path is relative to application root. Use slashes "/" as path delimiter, noleading slash. e.g. If the application root of your website isC:\Inetpub\wwwroot\demo and you enter "data/" in this textbox, the folder for thedatabase will be C:\Inetpub\wwwroot\demo\data. If you are not sure which folder isapplication root, please read Creating Virtual Directories in IIS(See 1.8).

2.  PHP COM extension is required on the web server. As of PHP 5.3.15 / 5.4.5, the COMextension requires php_com_dotnet.dll to be enabled inside of php.ini in order to usethese functions. Previous versions of PHP enabled this extension by default. Readhttp://php.net/manual/en/book.com.php. 

4. Microsoft SQL Server (Windows only) 

Notes 

1.  If you use SQL Server 2000/2005/2008/2012 and have installed SQL Server 2012Native Client on your computer, then Microsoft SQL Server and Microsoft SQLServer 2005/2008/2012 database type will be available for selection. You can usethis database type for connection to SQL Server 2000, 2005, 2008 or 2012. You candownload SQL Server 2012 Native Client from the Microsoft website. See SystemRequirements(See 1.2). The native client must also be installed on the web server.(ODBC connection is not supported.)

2.  PHPMaker connects to the SQL Server by TCP/IP (NOT Windows authentication),make sure TCP/IP protocols is enabled for your SQL server, you can use SQL ServerConfiguration Manager to check and configure.

3. 

If the SQL Server is a remote server (not on the same machine as PHPMaker), makesure your SQL Server allows remote connection, you can use SQL Server

Management Studio to check and configure.

http://php.net/manual/en/book.com.phphttp://php.net/manual/en/book.com.phphttp://php.net/manual/en/book.com.php

8/17/2019 PHPMaker_12

37/346

PHPMaker 12 Help

36

4. 

If you have firewall enabled on the server, make sure it allows inboundtraffic on port 1433 for TCP/IP. If the SQL Server uses another port number, makesure you have set up the firewall rules accordingly.

  Select Microsoft SQL Server (or Microsoft SQL Server 2005/2008/2012 if youuse SQL Server 2005/2008/2012 or later) as database type,

 

Enter the name or IP of the SQL server,  Enter the User ID and Password,

  Select the database you want or just enter the name of your database,

  Click the Connect button to load the database information.

Notes 

1. 

If Microsoft SQL Server 2005/2008/2012, make sure the server name includesthe instance name, e.g. localhost/SQLEXPRESS.

2.  The server name or IP should be valid on your production Web server also.Otherwise you'll need to modify the generated connection string in ewcfg*.phpbefore you upload it to your production server. For example, if you have a testingSQL Server installed on the same computer, you can use "(local)" as server name

when you connect to it with PHPMaker. The generated scripts will then try to connectto a SQL Server on the same computer as the production Web server, if this is notthe case on the server, the connection will fail. It is common that SQL Server isinstalled on a different server in production environment.

3. 

PHP COM extension is required on the web server. As of PHP 5.3.15 / 5.4.5, the COMextension requires php_com_dotnet.dll to be enabled inside of php.ini in order to usethese functions. Previous versions of PHP enabled this extension by default. Readhttp://php.net/manual/en/book.com.php. 

5. Oracle 

http://php.net/manual/en/book.com.phphttp://php.net/manual/en/book.com.phphttp://php.net/manual/en/book.com.php

8/17/2019 PHPMaker_12

38/346

PHPMaker 12 Help

37

Note If you have installed Oracle client on your computer, this database type will be available

for selection. You can download Oracle client from the Oracle website. Make sure the path of

your Oracle client (e.g. oci.dll) is among the Path variable under Windows Environment

Variables -> System variable.

  Select Oracle as database type,

 

Enter the Oracle Service name,

  Enter the User ID and Password,

  Select the Schema you want or just enter the Schema name,

  Click the Connect button to load the database information.

Note The service name should be valid on your production Web server also. Otherwise you'll

need to modify the generated connection info in ewcfg*.php before you upload it to your

production server. The service name must be set to the appropriate Net8 name which is

known to the naming method in use. For example, for Local Naming, it is the alias in the

tnsnames.ora file; for Oracle Names, it is the Net8 Service Name.

Load from PMP Project File

If you previously saved your project file (.pmp file), you can load it back by clicking the

open button on the tool bar (or select "Project", "Open" from the menu bar). At completion,

the tables and fields information will be loaded and displayed on the left pane.

http://www.oracle.com/technetwork/topics/winsoft-085727.htmlhttp://www.oracle.com/technetwork/topics/winsoft-085727.htmlhttp://www.oracle.com/technetwork/topics/winsoft-085727.htmlhttp://www.oracle.com/technetwork/topics/winsoft-085727.html

8/17/2019 PHPMaker_12

39/346

PHPMaker 12 Help

38

The database pane is dockable. If you prefer to display the database pane on the right hand

side, simply drag it to the right side.

Dynamic Table Loading

By default all tables in the database are loaded. It is convenient but loading and

sychronization could be slow if your database contains a large number of tables or fields. Ifthis option is enabled, a table will only be loaded when you select it in the database pane. If

you just use a few tables out of a large database, this feature enables you to work much

faster than before. To enable this feature, simply check [Load tables dynamically] 

BEFORE pressing the [Connect] button.

1.10.2 PHP SettingsGeneral Options

8/17/2019 PHPMaker_12

40/346

PHPMaker 12 Help

39

Add shell call  (For Unix-based server only) If you put the PHP parser binarysomewhere outside of the web tree of files, for example, in

 /usr/local/bin, you will have to put a line similar to: #!/usr/local/bin/php

as the first line of any file containing PHP tags. (You will also need to

make the file executable.)

Set locale  Set locale information. PHPMaker uses localeconv() which returns data

based upon the current locale as set by setlocale(). 

Different systems have different naming schemes for locales.

If you do not know the correct locale string on your server or you want

to override system locale and use your own locale settings, click the [...] button and enter your locale settings.

http://www.php.net/manual/en/function.localeconv.phphttp://www.php.net/manual/en/function.localeconv.phphttp://www.php.net/manual/en/function.localeconv.phphttp://www.php.net/manual/en/function.setlocale.phphttp://www.php.net/manual/en/function.setlocale.phphttp://www.php.net/manual/en/function.setlocale.phphttp://www.php.net/manual/en/function.setlocale.phphttp://www.php.net/manual/en/function.localeconv.php

8/17/2019 PHPMaker_12

41/346

PHPMaker 12 Help

40

Refer to localeconv() for the definition of the settings.

Note If you use Multi-Language (see below), DO NOT use this setting

unless all languages share the same locale settings. Each language has

its own locale settings and you should specify locale settings for each

language in the respective language file. (See Customizing

Template(See 1.14))

Default Date

Format 

The default date format for the scripts. Possible values are:

yyyy/mm/dd, mm/dd/yyyy, dd/mm/yyyy,

yyyy-mm-dd, mm-dd-yyyy, dd-mm-yyyy,

yyyy.mm.dd, mm.dd.yyyy, dd.mm.yyyy

with or without time (hh:mm:ss). The selected date format also

determines the date separator ("/" or "-" or ".").

No Cache  Whether caching is required on browser

Multi-Language  Enable multi-language project. If enabled, a combobox will appear on

the top of the generated scripts for user to select language. See

Tools(See 1.13) for selecting languages for the multi-language project.

Important 

1.  Multi-Language project must use utf-8 encoding. The charset ofthe project must be "utf-8".

2. 

The data in your database must be stored in unicode, otherwiseyour data will not be displayed properly.

3.  If you have customized the template and put unicode characters

in the template directly instead of using language files, enablethe Advanced Setting UTF-8 output files (see Customizing

http://www.php.net/manual/en/function.localeconv.phphttp://www.php.net/manual/en/function.localeconv.phphttp://www.php.net/manual/en/function.localeconv.phphttp://www.php.net/manual/en/function.localeconv.php

8/17/2019 PHPMaker_12

42/346

PHPMaker 12 Help

41

Template(See 1.14) and Tools(See 1.13)).

Default Language Default language of the project. It must be compatible with Charset

(see HTML Settings(See 1.10.3)). Default is English.

There is always one default language for a project. Only the English

language file (english.xml) is shipped with PHPMaker. If your project issingle language but you use another language, create a language file for

your language (see Customizing Template(See 1.14)), put it in the

"languages" subfolder under the installation folder and then select your

default language using this combobox.

If you enable Multi-Language, you must select one of the selected

languages as the default language.

File Upload

Upload folder - The global folder where the uploaded files resides. If

you do not enter a specific folder for a file upload field in the Edit Tagpanel of the Field Setup(See 1.10.7) page, all the uploaded files will be

put in this folder.

Important Always specify an upload folder if you allow file upload. 

This folder is used as the root folder of temporary folders for file upload

fields during Add/Edit. It is also used as the root folder of the user files

folder of CKEditor.

Notes 

1. 

Unlike the field specific upload folder setting (which is a PHPexpression), this field specific setting must be a constantstring (without double quotes). If you want dynamic uploadfolders for different fields, specify upload folder for each field(see Field Setup(See 1.10.7)).

2.  Make sure that the Web server user have read/write

access to the folder.3.  The path is relative to application root. Use slashes "/" as

path delimiter, no leading slash. e.g. If the application root ofyour website is C:\Inetpub\wwwroot\demo and you enter"uploads/" in this textbox, the folder for the uploaded files willbe C:\Inetpub\wwwroot\demo\uploads. If you are not surewhich folder is application root, please read Application Root(See1.11).

Max File Size - Maximum file upload size in bytes. If

8/17/2019 PHPMaker_12

43/346

PHPMaker 12 Help

42

checking on file size.

Notes File upload also depends on your PHP, web server and database

configuration:

1.  PHP - Check your php.ini, related configurations are

file_uploads, upload_max_filesize, upload_tmp_dir, post_max_size, max_input_time, memory_limit, andmax_execution_time directives in php.ini.

2.  Apache - If you use Apache web server, check

LimitRequestBody directive.3.  MySQL - Check the max_allowed_packet setting in your MySQL

configuration.

Allowed file types - The allowed file extensions of the uploaded files.

Separate the file extensions (without ".") by comma without space, e.g.

gif,png,png. If blank, all file types are allowed.

Delete file on update/delete - Option to delete the uploaded file when

the field value is replaced, removed or if the record is deleted.

Note If Delete file on update/delete is enabled, the uploaded file will

be deleted. If the deleted record is a copied record, deleting the

uploaded files will affect the original record. To prevent such possible

problem, enable Advanced Setting Create upload file on copy (see

Advanced Settings(See 1.13)) to duplicate the uploaded file when

copying a record.

Audit Trail 

You can choose to log activities in a log file or in a database table.

Log file folder - The folder where the audit trail log file resides.

Notes 

1.  Make sure that the Web server user have read/writeaccess to the folder.

2.  The path is relative to application root. Use slashes "/" as

path delimiter, no leading slash. e.g. If the application root ofyour website is C:\Inetpub\wwwroot\demo and you enter"uploads/" in this textbox, the folder for the log file will beC:\Inetpub\wwwroot\demo\uploads. If you are not sure whichfolder is application root, please read Application Root(See1.11).

Use database table - Log the activities in the specified table instead oflog file. The table must have the following fields: (actual data types

http://www.php.net/manual/en/ini.core.php#ini.file-uploadshttp://www.php.net/manual/en/ini.core.php#ini.file-uploadshttp://www.php.net/manual/en/ini.core.php#ini.upload-max-filesizehttp://www.php.net/manual/en/ini.core.php#ini.upload-max-filesizehttp://www.php.net/manual/en/ini.core.php#ini.upload-max-filesizehttp://www.php.net/manual/en/ini.core.php#ini.upload-tmp-dirhttp://www.php.net/manual/en/ini.core.php#ini.upload-tmp-dirhttp://www.php.net/manual/en/ini.core.php#ini.upload-tmp-dirhttp://www.php.net/manual/en/ini.core.php#ini.post-max-sizehttp://www.php.net/manual/en/ini.core.php#ini.post-max-sizehttp://www.php.net/manual/en/info.configuration.php#ini.max-input-timehttp://www.php.net/manual/en/info.configuration.php#ini.max-input-timehttp://www.php.net/manual/en/info.configuration.php#ini.max-input-timehttp://www.php.net/manual/en/ini.core.phphttp://www.php.net/manual/en/ini.core.phphttp://www.php.net/manual/en/ini.core.phphttp://www.php.net/manual/en/info.configuration.php#ini.max-execution-timehttp://www.php.net/manual/en/info.configuration.php#ini.max-execution-timehttp://httpd.apache.org/docs/1.3/mod/core.html#limitrequestbodyhttp://httpd.apache.org/docs/1.3/mod/core.html#limitrequestbodyhttp://dev.mysql.com/doc/refman/5.1/en/packet-too-large.htmlhttp://dev.mysql.com/doc/refman/5.1/en/packet-too-large.htmlhttp://dev.mysql.com/doc/refman/5.1/en/packet-too-large.htmlhttp://dev.mysql.com/doc/refman/5.1/en/packet-too-large.htmlhttp://httpd.apache.org/docs/1.3/mod/core.html#limitrequestbodyhttp://www.php.net/manual/en/info.configuration.php#ini.max-execution-timehttp://www.php.net/manual/en/ini.core.phphttp://www.php.net/manual/en/info.configuration.php#ini.max-input-timehttp://www.php.net/manual/en/ini.core.php#ini.post-max-sizehttp://www.php.net/manual/en/ini.core.php#ini.upload-tmp-dirhttp://www.php.net/manual/en/ini.core.php#ini.upload-max-filesizehttp://www.php.net/manual/en/ini.core.php#ini.file-uploads

8/17/2019 PHPMaker_12

44/346

PHPMaker 12 Help

43

depend on database type)

 

DateTime (DateTime)

 

Script (VarChar)

 

User (VarChar)

  Action (VarChar)

 

Table (VarChar)  Field (VarChar)

  KeyValue (Long VarChar)

  OldValue (Long VarChar)

  NewValue (Long VarChar)

You can create the database yourselves and select the table in the

combobox, then click the [...] button to select the fields in your table.

Alternatively, if you have not created the table yet, you can click 

[Create Table] and let PHPMaker creates the table and setup the

settings for you.

Track login/logout activities - If security feature is enabled,login/logout activities will also be logged.

Validation 

Server-side - Enable server-side form validation.

Client-side (JavaScript) - Enable client-side form validation.

Note If the available validation format in the Edit Tag panel (see Field

Setup(See 1.10.7)) does not fulfil your requirements, you can use your

own server-side and/or client-side validation code using Server Event

and Client Scripts(See 1.10.9).

List/View Page Options (Global)

The following list/view page options are global for all tables. If you want different settings

for a particular table, you can use table-specific options available in the Table Setup(See

1.10.6) page.

8/17/2019 PHPMaker_12

45/346

PHPMaker 12 Help

44

Records per page  Number of records to be displayed on the list page

of all tables. If blank or 0, default setting of 20 will

be used.

Selectable page sizes  Number of records to be selected by user. Comma

separated values, e.g. 10,20,50,ALL.

Note "ALL" (without quotes) is supported, other

values must be integers.

Paging section style  "NumericPages" or "NextPrev"

Sort type  None, Single column or Multiple column. If

Multiple column is selected, the generated list

page supports multi-column sorting by Ctrl-

clicking the table header.

8/17/2019 PHPMaker_12

46/346

PHPMaker 12 Help

45

Multiple column Show multiple records per row. Default is 0. This

feature will only take effect if the value is > 0.

Possible values: 1, 2, 3, 4, 6, 12

Paging section at top  Show the paging section at top (also applies to

View page)

Paging section at bottom  Show the paging section at bottom (also applies

to View page)

Paging section in View page Show paging section in View page also

Paging section in Edit page Show paging section in Edit page also

Multiple delete  Show checkboxes in the list page for selecting

multiple records to delete

Inline delete  Delete records directly without showing delete

confirm page

Links on left side Show the links in record row on the left instead of

right

Use buttons as links  Show the links in record row as a button group

instead of individual icons or links.

Use button dropdown for links  Show the links in record row as a button with

dropdown menu instead of individual icons or

links.

Use button dropdown in paging

section 

Show the links in paging section as buttons with

dropdown menu instead of individual links.

Use modal dialog for Advanced

Search Show the Advanced Search page in a modal dialog

Export  Enable export in List page - allow export in List

pages

Enable export in View page - allow export in

View pages also

Use button dropdown - show the export links as

a button with dropdown menu. Default is showing

the export links as a row of icons.

Print/CSV/HTML/Excel/Word/XML/PDF/Em

ail - Records can be exported to Print (printer-

friendly), CSV, HTML, Excel, Word, XML, PDF

format or sent as HTML email content.

Note The fields in printer friendly version are same

as in List/View page, while the fields in other

format are determined by the Export setting of the

field in Field Setup(See 1.10.7) page.

Note that the fields in printer friendly version are

same as in List/View page, while the fields in

other format are determined by the Export setting

8/17/2019 PHPMaker_12

47/346

PHPMaker 12 Help

46

of the field in Field Setup(See 1.10.7) page.

Export type - Determines which records to

export. The follows are supported:

  All Pages - Records in all pages are

exported  Current Page - All records in current

page are exported

  Selected Record - If selected, acheckbox will be displayed in each row forselection. Only selected records in thecurrent page are exported. (Selectingrecords in different pages is not allowed.)To select records primary key is required,Current Page export type will be used fortables without primary key.

Notes 

1. 

Binary data (BLOB fields) cannot beexported.

2.  Export to HTML/CSV/XML/PDF are notapplicable to reports.

3. 

Images cannot be exported toWord/Excel/CSV/XML.

4.  Export-to-XML requires PHP DOM (part ofPHP 5 core).

5. 

Export-to-Word/Excel works by exportingdata in HTML format for Word/Excel toconvert/import, the exported file is notnative .doc/.xls format. (Registered user

can use the PHPExcel extension whichoutput native Excel file format.)

Notes (Export to PDF) 

1.  The extension is an experimentalextension only. There are known issues,see Third-party Tools(See 1.7) and readthe note in the extension setup page (seeTools -> Extensions(See 1.13)) for moreinformation before use. Only enable it ifnecessary.

2. 

The extension performs best if you areusing non-unicode alphanumericalcharacters (e.g. iso-8859-1) only. If youuse unicode, configure advanced settingsfor the extension, read the note in theextension setup page (see Tools ->Extensions(See 1.13)) for moreinformation.

3.  By default export is only enabled in Viewpage. If you want to enable it in the Listpage also (the number of records to beexported is not large), you can set theadvanced settings of the extension (seeTools -> Extensions(See 1.13)).

4. 

The extension supports images (jpg, gif

and png only), but a temporary folder isrequired during export, the extension usesthe Upload folder (see File Upload

http://www.php.net/manual/en/book.dom.phphttp://www.php.net/manual/en/book.dom.phphttp://www.php.net/manual/en/book.dom.phphttp://www.php.net/manual/en/book.dom.php

8/17/2019 PHPMaker_12

48/346

PHPMaker 12 Help

47

above) because write permission for thefolder should be already setup properly. Ifyou do not use file upload to folder, butyou use export to PDF with images, thenmake sure you still specify an uploadfolder and set up the write permission.

Email Settings

PHPMaker supports many features that can send emails. If you use these features, you'll

need to specify a SMTP server.

Note From v9, PHPMailer (see Third-party Tools(See 1.7)) is always used as the email

component. Make sure you generate and upload the subfolder named "phpmailer"

to your website.

SMTP server The host name or IP of the SMTP server.

Note Some servers do not support "localhost" as SMTP server, in

such case you need to specify a valid SMTP server in the

network.

SMTP server port Port number of SMTP server. Default is 25.

SMTP server username  User name for SMTP server authentication. If your SMTP server

does not require authentication, leave it blank.

SMTP server password  Password for SMTP server authentication. If your SMTP server

does not require authentication, leave it blank.

Sender (Email address) Email address of the sender of all emails

Recipient (Email address)Email address of the recipient(s) for notification emails when a

record is added/edited/deleted (if enabled, see Table Setup(See

1.10.6)). If there are multiple recipients, separate them by

comma.

8/17/2019 PHPMaker_12

49/346

PHPMaker 12 Help

48

Security  Protocol used by the SMTP server. Possible values are: SSL or

TLS.

Note Leave this setting empty if your SMTP server does not use

such protocols.

1.10.3 HTML SettingsGeneral

Title  Title displayed on all pages.

Note If you use Multi-Language (see PHP Settings(See 1.10.2)), use Multi-

Language Property Editor, see Tools(See 1.13) for details.

Charset  Charset setting used in the META tag of the site and for exporting data.

Note If you use Multi-Language (see PHP Settings(See 1.10.2)), this setting

must be utf-8.

Font  Default font. If not specified, Bootstrap (see below) @font-family-sans-serif will

be used, default is: "Helvetica Neue", Helvetica, Arial, sans-serif.

Size  Default font size (pixel). Unit must be in pixel for working with Bootstrap (seebelow). Default is 14.

Site icon  Icon of the site. For browsers to show your URL with an icon. Must be an .ico

file.

Site header

logo

Logo image in the header

Note This setting is enabled in registered version only. Registered version

allows no logo.

Site footer

text

Footer text (e.g. copyright statement)

Notes 

8/17/2019 PHPMaker_12

50/346

PHPMaker 12 Help

49

1. 

If you use Multi-Language (see PHP Settings(See 1.10.2)), use Multi-Language Property Editor, see Tools(See 1.13) for details.

2.  This setting is enabled in registered version only.

Theme

Provides over a dozen of themes for you to setup the look and feel of your project quickly.

You can change the various properties of the selected theme to suit your style. The propertyname are self-explanatory.

Themes are intergrated with Bootstrap, you can customize Bootstrap properties directly in

the Theme tab, scroll down to find the Bootstrap variables which start with "@".

To export custom theme settings, click the [Export theme] button to export the theme to an

external xml file. To import custom theme settings from earlier saved xml files, click the

[Import theme] button.

http://getbootstrap.com/http://getbootstrap.com/http://getbootstrap.com/http://getbootstrap.com/customize/#less-variableshttp://getbootstrap.com/customize/#less-variableshttp://getbootstrap.com/customize/#less-variableshttp://getbootstrap.com/customize/#less-variableshttp://getbootstrap.com/

8/17/2019 PHPMaker_12

51/346

PHPMaker 12 Help

50

There are some settings related to Bootstrap but they are not Bootstrap "@xxx" variables:

Mobile Menu - Inverted  Modify the look of the mobile menu by adding CSS class

".navbar-inverse". Default is FALSE.

Mobile menu uses Bootstrap Navbar which support

"inverted" style, see Inverted Navbar. 

Theme (Bootstrap) - Use

Bootstrap Theme 

Load the optional Bootstrap theme for a visually

enhanced experience. See Bootstrap Theme. Default is

TRUE.

Notes 

1. 

Changing a setting in the user interface does not change the corresponding settingin the theme definitions, it only changes the setting for the project. The themedefinition files (in XML format) are installed in the subfolder "themes" under theinstallation folder. You can easily add your own themes by duplicating one of thetheme definition file (except the theme.xml which is for defining the settings anddata type in a theme), rename it and modify the settings in the file, just make sureyou give your theme an unique theme name.

2. 

Bootstrap is a sleek, intuitive, and powerful front-end framework for faster andeasier web development, to get started, checkout http://getbootstrap.com. 

3. 

After changing theme properties, make sure you re-generate *.css files.

http://getbootstrap.com/components/#navbar-invertedhttp://getbootstrap.com/components/#navbar-invertedhttp://getbootstrap.com/components/#navbar-invertedhttp://getbootstrap.com/examples/theme/http://getbootstrap.com/examples/theme/http://getbootstrap.com/examples/theme/http://getbootstrap.com/http://getbootstrap.com/http://getbootstrap.com/http://getbootstrap.com/http://getbootstrap.com/examples/theme/http://getbootstrap.com/components/#navbar-inverted

8/17/2019 PHPMaker_12

52/346

PHPMaker 12 Help

51

Styles

Edit styles  A separate CSS stylesheet will be generated for each project. Click the

[Edit styles] button to open CSS editor.

Notes 

1. 

All projects use CSS stylesheet.2.

 

If you have TopStyle Pro (v1.5+) or TopStyle Lite (v1.5-3.1)installed on your PC, PHPMaker will use it automatically.

Notes When you edit the CSS styles in the editor, note the follows:

1.  DO NOT MODIFY the system styles section, it is generated by thesystem, your modifications will be overwritten. If you want tochange the stylesheet template, modify the ew.css in the "themes"subfolder under the installed directory. Only modify the ew.css ifyou have the necessary knowledges in CSS.

2. 

DO NOT REMOVE THE FOLLOWING COMMENTS:

BEGIN_USER_STYLESEND_USER_STYLES 

You MUST write your styles between these two commentlines, styles outside this user styles section will bediscarded. 

3.  If you want to override the system styles, you can copy the stylesto the User Styles Section, or you can use a separate userstylesheet.

User Stylesheet Specify an external user stylesheet (will be copied across during

generation)

You can see the effect of new settings immediately in the preview window at the bottom of

the HTML tab.

8/17/2019 PHPMaker_12

53/346

PHPMaker 12 Help

52

Other than choosing color from the palettes, the color picker can also pick color directly from

screen using the "eyedropper".

1.10.4 Security Settings

Field Description:

Administrator Login (Hard-

Coded) Administrator user id and password

Login Name  Login Name for administrator

Password  Password for administrator

Use Existing Table  Link to existing table for login name and password

validation

8/17/2019 PHPMaker_12

54/346

PHPMaker 12 Help

53

Table  Existing table in database containing login name and

password information

Login Name Field  Login Name field in table used for authentication

Password Field  Password field in table used for authentication

Login Options  Login options in the login page:

Auto-login - Auto login until the user logout explicitly

When you enable the auto-login feature, a few cookies

will be placed on the user's computer to identify the

user, meaning that the user do not have to type

username and password every time he/she visit the site.

For this reason, you should advise your users not to use

this feature on a public or shared computer, as any other

user of the computer will be able to access the account.

Remember username - Save the user's user name in

cookie

Always ask - Do not save user name and password,

always ask for them in the login page

Advanced Security 

Advanced Security feature allows you to setup User ID, assign User Levels to users and

create a complete user registration system. To setup, click the [Advanced] button.

PHPMaker supports two types of security - User ID and User Level. User ID Security

secures data at record level. User Level Security secures data at table level. They

complements each other and they can work independently or together. Users get their User

ID and User Level after login. Before login, an user's identity is unknown and the user is anAnonymous User.

8/17/2019 PHPMaker_12

55/346

PHPMaker 12 Help

54

User ID

User ID Security secures data at