utillyty.php Documentation

1.0.0

utillyty.php is a php toolkit to aid in developing rich user interface php applications, released under the terms of the GNU General Public License version 3.

Content

Common A set of general utilities
Widgets This functions output pattern html fragments with javascript, that act like common UI controls. The output is compliant to:
- XHTML 1.0 Transitional html specs
- ECMA-262 (W3C DOM level 2) javascript specs
- W3C CSS level 3 stylesheets specs
Data access
filelist widget
javascript documentation
Tools (todo doc)
Tests (todo doc)

Usage

define:
- 'UTILLYTY' path to utillyty.php/lib folder before including any utillyty php file.
- 'UTY_LANG' (optional, default='en') one of the folder names in UTILLYTY/lang.
include:
- use php require_once() to include the utillyty php source files you need: include dependancies are auto resolved.
- use uty_include_js() to include the corresponding javascript files (also js include dependancies are auto resolved!).
- include default.css (or your customized stylesheet) in your html head

Coding conventions

To avoid conflicts all public API names start with the uty (or UTY) prefix (namespaces are not fully supported by web hosts around as PHP 5.3+ is needed).
The @ silent operator is NOT used. You should use uty_set_error_handler() to handle php error reporting. If the operator is occasionally used it is bookmarked by a '//@@' comment
Modified code in opensource software is bookmarked with a '// tilly:' comment

Open source used by this software:

pclzip.lib.php http://www.phpconcept.net
Folder-web.png http://commons.wikimedia.org/wiki/File:Folder-web.png
fugue icons http://www.pinvoke.com/
silk icons http://www.famfamfam.com/lab/icons/silk/

See http://lnx.utillyty.eu/utillyty.php/test for some working tests. (NB: It's my testing/debugging environment so it is continously under developement... The project source files are in the /test folder with some explanation comment).

22/02/2010 Attilio Pavone <tilly@utillyty.eu>