File: README.txt

Recommend this page to a friend!
  Classes of Michele Brodoloni  >  PHP Dialog  >  README.txt  >  Download  
File: README.txt
Role: Documentation
Content type: text/plain
Description: Documentation
Class: PHP Dialog
Create console based UIs with the dialog program
Author: By
Last change:
Date: 9 years ago
Size: 2,184 bytes


Class file image Download
PHP Dialog v1.0
Author: Michele Brodoloni <>

This class allows you to create pretty dialog boxes within your php-cli scripts. 
It relies on Linux "dialog" utility.

  * PHP 5.3 (due to a bug with proc_open() in PHP 5.1)
  * dialog 1.0 / 1.1 

  * Install the dialog utility using your favority package manager
    - apt-get install dialog     # (For Debian/Ubuntu)
    - yum install dialog         # (For RHEL/CentOS)
  * Download and extract this tarball
  * Place file class.dialog.php and the plugins directory wherever you want but in the same path.

To use this class just include it, and call the static factory() method to fetch the wanted object. 
Here's an example:

----------[ CODE:START ]--------------

    require_once 'path/to/class.dialog.php';
    $dialog = Dialog::factory($type, $params);

----------[ CODE:END ]-----------------

* $type is the type of dialog requested. Possible choices are:
    - confirm
    - msgbox
    - gauge
    - inputbox
    - calendar
    - timebox
    - ... And so on. Just list files into 'plugins' directory.

* $params is an optional associative array which sets default params during object construction. 
  It could come handy when need to instantiate several dialog objects with the same values (such as title, backtitle, ecc..)

----------[ CODE:START ]--------------

 require_once 'path/to/class.dialog.php';

 $params = array(
    'backtitle' => 'My App',
    'title'     => 'Box title'
 $d1 = dialog::factory('msgbox', $params);
 $d1->setCaption('Hello World #1')

 $d2 = dialog::factory('pause', $options);
 $d2->setCaption("Please wait $secs seconds.")

----------[ CODE:END ]-----------------


For further information please download and extract the zip file located
into the docs directory and then open the index.html file in the extracted

For more information send a message to info at phpclasses dot org.