PHP has the bad habit of considering empty strings to be “null” and “false” , for instance

1
2
3
4

$foo = '';
if( $foo == null && $foo == false ){
    echo "So PHP actually considers empty strings to be null and false";
}

To avoid this either use

1
2
3

is_null( $foo )
//or
$foo === null

Try this code

1
2
3
4
5
6
7
8
9
10
11
12

$foo = '';
if( $foo == null && $foo == false){
    echo 'So PHP actually considers empty strings to be null AND false!';
}
 
if( !is_null( $foo )){
	echo 'Using is_null() will return true only if $foo is null';
}
 
if( $foo !== null ){
	echo 'Using === and !== also works well';
}

$myArray[0] = 'foo';

and you can also use “list” to access more than one index in one call

list( $first, $second, $third ) = $myArray;

This approach , however, doesn’t work with associative arrays or arrays that have non-standard integer index like

$stringIndexedArray = array('first' => 'data','second' => 'data');
$nonStandardIntegerIndexedArray = array(5 => 'foo', 7=>'bar');

I have found two methods to access the first element in such arrays, one using “reset” and the other using “array_values”

$stringIndexedArray= 
array(
	'first'  => 'Data 1',
	'second' => 'Data 2',
	'third'  => 'Data 3',
	'forth'  => 'Data 4',
	'fifth'  => 'Data 5'
);
//reset method
//Average execution time : 2.8123000000003E-6
$firstElement = reset($stringIndexedArray);
 
//array_values method
//Average execution time : 3.8123000000001E-6
list($firstElement) = array_values( $stringIndexedArray );

I’ve done some profiling and turns out that “reset” method is slightly faster than “array_values” ( as seen in code comments )

Links:

Development trunk(SVN): http://joomlacode.org/svn/gsoc2008/JForms/trunk/

JForms blog on J! Developer website

Latest packaged version

P.S : I used CamStudio to create this video.

The codebase is simply composed of two parts, Core and pluginis “Elements”

Each draggable element is handled by a 2 files

• A javascript file that does the rendering and the event handling “Events are triggered by the core and passed down to each individual element”.
• A php file that defines what properties the element has, these information are used by the core to generate property page, this file is just meant to hold configuration parameters, no actual coding involved.

Adding a new element would just require writing two files and the core handles the rest.

I’m using Prototype, script.aculo.us and Webtoolkit context menu, No true AJAX has been used so far, everything is done on the client side.

Now the question is , what does the end user see?

• Drag and drop environment
• Context menu for each element
• Properties for each element
• Simple keyboard interaction “Selected element can be deleted by pressing the (del) button (except textfield and textarea)”

I’ve tested this on FF2 and IE6.

What I really need to implement right now is the “Resize” function

Why don’t you check A demo of the code in action

I plan to turn this into a Joomla! forms component soon Insh’Allah.

Update: My Proposal to Google Summer of Code has been accepted and I’ll be working on implementing this form editor as a Joomla! 1.5 component, You can find more information about my progress on my GSoC blog

Update September 4th, 2007: I’ve released the code on SourceForge you can access it by checking out the CVS there.
The project url: http://sourceforge.net/projects/arabic-tcpdf

CVS Checkout command

It is a known fact that Joomla! 1.0.x can export content into pdf format, however, this feature doesn’t seem to be working well when used to export Arabic content to pdf format, either windows-1256 or UTF-8 encoded.

To address this issue, The guys at the Joomla! core has moved to TCPDF library to export pdf files, this library has support for images and more importantly UTF-8 which means it can -theoritaclly speaking- be used to handle pretty much ANY langauge, This is true for many Left-To-Right languages, however, For a Right-To-Left language like Arabic the situation is quite different I’ll try to brief the problem here.

First off, Arabic is a complex script language, This means that putting letters side by side is not just enough, A typical Arabic letter has different combining forms based on its context in the word.
For a PDF generator to handle Arabic text correctly it must pre-process the input text and determine which combining form to render “Shaping” ,otherwise the text will appear as separated Arabic letters as shown in the following image, So far Joomla! 1.5 PDF engine doesn’t take that in consideration which means any Arabic text exported by Joomla! will appear as separated letters.

To tackle this issue I’m using a class called ArGlyphs by Khaled Al-Shamaa.

Quoting from the project description on phpclasses.org

The class takes as input Arabic text encoded using Windows-1256 character set and performs Arabic glyph joining to output a string encoded using UTF-8.

So basically this class will fix this shaping problem , I had to modify it a bit to accept UTF-8 without messing it up, I used the phpUTF8 library which is bundled with Joomla! 1.5

Now the output looks like this

Which brings us to the second problem,The TCPDF Library only outputs text from Left-To-Right which causes RTL scripts to be displayed in reversed order, simply reversing the string before passing it to the rendering engine won’t fix this problem, I think FriBidi may fix this but it is not available with every php Installation so I can’t relay on it to fix this problem for Joomla! ,So I gave it a shot and written my own code (I always like to write my own code ;P), The code I wrote simply breaks down text into pieces based on its UTF-8 range and then reverses the pieces “runs” that are identified as RTL “like Arabic” and leaves other runs without modification.

Letters are correctly shaped “with minor errors” and are rendered right to left, however, the lines are reversed , you should be able to read it correctly by starting from the bottom line and proceed upwards,I’m yet to fix this problem , If you have any suggestions on how to fix this or an easier way of doing the whole thing please let me know, I think there gotta be a better way of doing this.

Edit ( 8/5/2007 ) : I have managed to fix that issue but the code still needs to much clean-up and bug-proofing , here’s a sample of the output.