awfDialog Class :: Change Log

awfDialog :: AJAX Enabled Dynamic Dialog Wizard Class :: Documentation

awfDialog Class Change Log

Version 1.2:

Extended dynamic CSS element creation to cover a broader selection of the rendered dialog
Removed un-needed lines from docs/style.css and examples/style.css
Added SetCSS($element, $css) method. See CSS Reference and Usage Guide for details.
Fixed togglelayer() javascript so it should only get sent to the browser once per each instance of the class, not once per dialog.
Added HelpPane element, help button in the Titlebar, the UseHelp() method, AddHelp() method, SetAjaxHelp() method. See Usage Guide for details. Click the Help button on the titlebar above for a demo of the new Help functionality.
Updated the Gradient Builder example to include HelpPane functionality.
Fixed bug related to using ICON_CSS and SetIconType() to add your own custom icons. Functionality now works as intended.
Fixed alignment issues associated with the AjaxCancel button.
Replaced the _buildExitBtn() method with _buildControlBox(), which includes output of both the exit and help buttons.
Extended the Clear() method to also clear the HelpPane output buffer.
Updated the Usage Guide for all new and modified methods, and added the CSS Reference to the documentation.

Version 1.1:

Restructured file system and reference pointers to support a package more ready to be re-used without modification.
Added GradientBuilder example and modified it to work with the new package structure.
Extended awfDialog class to support querying for class version number. Also extended debug output for version numbering.
Added the SetImagePath(path) method. By default, awfDialog will now assume the class library and sub-folders exist in a directory called 'awfDialog' beneath your current execution path. Use this method prior to awfDialog->Render() to override that assumption. This function works using either relative or absolute URI paths, do not use physical paths as the results are handed to your page viewer's browser and thus would not be accessible.
Added the SetGradientDirection(direction) function. Method accepts either:
GRADIENT_V (vertical;top-to-bottom gradient), or
GRADIENT_H (horizontal;left-to-right gradient).
These constants are defined in awfDialog and if you use a dynamic IDE such as Komodo it will automatically pick them up for code completion once you've included the class in your code.
More detailed DebugDump() method output. See sample below.
Fixed bug in private _buildGradient() function when re-using a single instance to render more than one dialog.
Removed redundant GetID() method. Use echo $MyClass->dialogID; to retrieve dialog ID now.
Cleaned up some WTF code inside AddOutput() method.

awfDialog Future Versions

Here are a few of the things I'm trying to get added into the next major release. If you have a requested feature or have found a bug, please let me know and I'll look at getting it added.

AJAX Help Button:

Optional AJAX enabled Help button near the Exit button. Now in version 1.2

Themes:

Incorporate theme definition file support so you'll be able to pre-define a large number of dialog look and feel templates and then reference the appropriate template when the class is initialised.

Dialog Effects:

Render the dialog as a standard inline DIV, a DHTML pop-up, or using a lightbox effect.

Sample Debug Output

With version 1.2 the debug log has been cleaned up and entries given more descriptive values. It can can be printed to the browser using the awfDialog->DebugDump() method. The log shown below is the debug array for the Dialog Wizard used to display the two dialogs shown above:

<pre>Array
(
    [0] => Instantiate class(VERSION: awfDialog Class 1.2 | TITLE: awfDialog Class Change Log | ICON: 2 | MODAL:  | WIDTH: 85%), 
    [1] => Set BodyVAlign: 0, 
    [2] => Set Image Path: ../lib/images/, 
    [3] => Set BodyHAlign: 3, 
    [4] => Set Icon Size: 1, 
    [5] => Set Gradient - COLOR1: 224e15 | COLOR2: c3f60a, 
    [6] => Set Wizard Mode: false, 
    [7] => Wizard Mode Disabled, 
    [8] => Set Gradient Direction: 1, 
    [9] => Set Body BGColor: #efffca, 
    [10] => Append Output, 
    [11] => Append Output, 
    [12] => Use Help Set: 1, , 
    [13] => Add Help, 
    [14] => Append Output, 
    [15] => Append Output, 
    [16] => Append Output, 
    [17] => Append Output, 
    [18] => Append Output, 
    [19] => Append Output, 
    [20] => Append Output, 
    [21] => Append Output, 
    [22] => Append Output, 
    [23] => Append Output, 
    [24] => Append Output, 
    [25] => Append Output, 
    [26] => Append Output, 
    [27] => Append Output, 
    [28] => Append Output, 
    [29] => Append Output, 
    [30] => Append Output, 
    [31] => Append Output, 
    [32] => Append Output, 
    [33] => Append Output, 
    [34] => Append Output, 
    [35] => Append Output, 
    [36] => Append Output, 
    [37] => Append Output, 
    [38] => Pre-Render Start, 
    [39] => --CSSArray count = 4, 
    [40] => --0 - CSS Title: color:#fff;, 
    [41] => --1 - CSS BodyPane: color:#000000;font-size:11pt;padding-left:15px;, 
    [42] => --2 - CSS BodyPane li: line-height:15px;, 
    [43] => --3 - CSS HelpPane: background:lightblue;color:navy;font-size:10pt;border:1px solid navy;margin:10px;padding:5px;, 
    [44] => --Gradient built: ../lib/image2.php?from=224e15&to=c3f60a&w=85%&h=35&d=false, 
    [45] => --Build Icon: ../lib/images/icoInfo.gif, 
    [46] => --Default Help Button Built, 
    [47] => Pre-Render Complete, 
    [48] => Post-Render Start, 
    [49] => Post-Render Complete, 
    [50] => Render Output, 
    [51] => Old Dialog ID: D1, 
    [52] => New Dialog ID: , 
    [53] => Set Title: awfDialog Future Versions, 
    [54] => Delete Help & Output Buffers, 
    [55] => Use Help Set: , , 
    [56] => Append Output, 
    [57] => Append Output, 
    [58] => Append Output, 
    [59] => Append Output, 
    [60] => Append Output, 
    [61] => Pre-Render Start, 
    [62] => --CSSArray count = 4, 
    [63] => --0 - CSS Title: color:#fff;, 
    [64] => --1 - CSS BodyPane: color:#000000;font-size:11pt;padding-left:15px;, 
    [65] => --2 - CSS BodyPane li: line-height:15px;, 
    [66] => --3 - CSS HelpPane: background:lightblue;color:navy;font-size:10pt;border:1px solid navy;margin:10px;padding:5px;, 
    [67] => --Gradient built: ../lib/image2.php?from=224e15&to=c3f60a&w=85%&h=35&d=false, 
    [68] => --Build Icon: ../lib/images/icoInfo.gif, 
    [69] => --Help Disabled, 
    [70] => Pre-Render Complete, 
    [71] => Post-Render Start, 
    [72] => Post-Render Complete, 
    [73] => Render Output, 
    [74] => Delete Help & Output Buffers, 
    [75] => Debug Dump, 
)
</pre>

Docs

About / Features

Change Log

Usage guide

CSS Reference

License

Examples

Simple Implementation

Gradient Builder