Using Private-label Version of ActiveX/Java Uploader PHP

When users download and install ActiveX/Java Uploader to the browser, they see the security dialog which asks whether they trust Aurigma, Inc. and want to install the control. However, if you prefer to display your company name instead of Aurigma, Inc., rename ActiveX/Java Uploader control, and sign it with your own digital signature you need to order a private-label version of ActiveX/Java Uploader (for more information about signing a private-label version see the How to Sign a JAR File and How to Create a CAB File topics). Additionally, private-label versions can contain enhanced functionality not available in the standard version. If you need a private-label version of ActiveX/Java Uploader, please, contact our sales team at sales@aurigma.com.

This article describes how to use a private-label version of ActiveX/Java Uploader in PHP application. The following approach is also useful when you upgrade .cab and .jar files obtained from Aurigma, Inc. without updating ActiveX/Java Uploader PHP (ImageUploaderPHP folder).

Walk through the following steps to configure the wrapper to launch private-label version of ActiveX/Java Uploader:

1. Obtain *.cab and *.jar files as well as private-label embedding instructions from Aurigma, Inc. For instance, you have MyUploader.cab and MyUploader.jar files.
2. Copy these files to any folder of your application.
3. Configure the ActiveXControl property to the Uploader control in the following way:
   1. Specify a path to MyUploader.cab file as a value of the CodeBase property.
   2. Specify a path to MyUploader_x64.cab file as a value of the CodeBase64 property.
   3. Specify CLSID and PROGID of the ActiveX control as values of the ClassId and ProgId properties respectively.
4. Configure the Uploader.JavaControl property as follows:
   1. Specify a path to MyUploader.jar file as a value of the CodeBase property.
   2. Specify Java applet class name with the ClassName property.

All the information you need to specify using these properties will be provided by Aurigma, Inc. If some parameters were not sent, you should use default values.

The code sample below demonstrates how to implement this.

$uploader = new Uploader("Uploader1");
	
$uploader->getActiveXControl()->setCodeBase("MyUploader.cab");
$uploader->getActiveXControl()->setCodeBase64("MyUploader_x64.cab");
$uploader->getActiveXControl()->setClassId("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX");
$uploader->getActiveXControl()->setProgId("MyCompany.MyUploader");
	
$uploader->getJavaControl()->setCodeBase("MyUploader.jar");
$uploader->getJavaControl()->setClassName("com.mycompany.myuploader.MyUploader.class");
	
$uploader->render();