By: Jose Leon
Abstract: Creating a VCL for PHP Charting component. This article is a reproduction of the blog post by Jose Leon, developer of Delphi for PHP.
VCL for PHP Charting components - Initial setup
On the previous article, we learned how to gather the requeriments to write the wrapper, now we are going to setup the folder where to place our component files and write some code.
Our component must live on the VCL for PHP folder the IDE uses, which, by default, is C:\Program Files\CodeGear\Delphi for PHP\2.0\vcl, so let’s create a subfolder called openchart inside.
Now we need to identify the open flash chart library files we need to include, to make all work, I usually copy everything, including samples and documentation, that way, you are respecting the package the author deployed, and also is easier to upgrade in the future.
In this case, we include everything, except the non-PHP APIs, so this should be the content of the vcl\openchart folder:
Component and package
A component is a class that inherits from a VCL for PHP base class, and to allow the IDE to use it, you need to create a package, which tells the IDE where to place the component icon on the Tool Palette, and also how to handle some of its properties.
To create the basic code for the component and the package, we are going to use the New Component Wizard, you can find it on Component | New Component menu item.
You need to enter some information, like the ancestor class, the name for your new component and the palette page you want to place your new component on.
After pressing OK, you will end up with two files:
class OpenChart extends Control
function __construct($aowner = null)
setPackageTitle("Put the title of your package here");
//Change this setting to the path where the icons for the components reside
//Change yourunit.inc.php to the php file which contains the component code
Save both on the vcl\openchart folder and name them openchart.inc.php and openchart.package.php.
Customizing and installing the package
Before installing the package, you must perform some customizations, like change the title of the package:
setPackageTitle("Charting Library for VCL for PHP");
Or change the path where the unit for the component is located:
You can also specify where the component icons can be found by the IDE These icons will be used by the IDE on the Tool Palette to represent a component.
All the information contained in a package is information for the IDE, so you don’t need to deploy .package files with your application.
Finally, you need to add the unit where the Control base class can be located, which is controls.inc.php:
Now you are ready to install your package into the IDE, using Component | Packages, click the Add button and browse where openchart.package.php is located and open it. The package will be installed and the component will be available on the Tool Palette, under the OpenChart category.
If you drop your new component to a Page, you will get a blank rectangle with nothing, that is the basic component, and we will add functionality on the next article.
Click here to download a free 30-day trial of HTML5 Builder >
More social media choices:
HTML5 Builder on Google+
@RADADtools on Twitter
Server Response from: ETNASC03