--------------------------------------------------------------------------------
AURIGMA UPLOAD SUITE README FILE
--------------------------------------------------------------------------------

Table of Contents
1.   System Requirements
2.   Upload Suite SDK Structure
3.   How to Evaluate Upload Suite
4.   Useful Links
5.   Legal Notices
6.   Contact Information


Aurigma Upload Suite is a powerful upload solution for your web applications. 
It enables web developers to provide their clients with a user-friendly batch 
upload solution. For example, to upload 100 files a user doesn't need to click the "Browse" button 100 times and select each file separately as would normally be done through standard HTML. A user can now navigate to their folders directly in their browser, select the
necessary files, and start an upload process with only in a few clicks.

To learn more about Aurigma Upload Suite, visit
http://www.aurigma.com/Products/ImageUploader/

1. System Requirements

1.1. ActiveX/Java Uploader

1.1.1. Client-Side

1.1.1.1. Operating Systems
	- Windows XP/Vista/7 (including East Asian editions). 
	- MacOS 10.5 or later.
	- *NIX systems with Java Runtime Environment.

1.1.1.2. Browsers
	- Internet Explorer (Windows) 6 or later. ActiveX controls and JavaScript should
	be enabled in the browser settings. 
	- A browser which supports Java applets with Sun JRE 1.5:
		- Any Mozilla-family browser, including Firefox 2 or later, Netscape, and
		others. 
		- Safari (Mac). 
		- Google Chrome. 
		LiveConnect availability (required).
		Java applets and JavaScript should be enabled in the browser settings.
		
		Note: Some Mac browsers require Java Embedding Plug-in to be JRE 1.5-compatible.
			  These browsers do not require this plug-in:
				- Safari 
				- Firefox version 2.0 or later 
			  The following browsers are not supported:
				- Internet Explorer for Mac (no JRE 1.5 compatibility) 
				- Opera

1.1.2. Server-Side
To successfully use ActiveX/Java Uploader you must have a fully operational web server 
(for example, Apache or IIS).
ActiveX/Java Uploader ASP.NET and ActiveX/Java Uploader PHP have the following additional 
server-side requirements:

1.1.2.1. ActiveX/Java Uploader ASP.NET
	- Microsoft Visual Studio 2005/2008/2010. 
	- .NET Framework 2.0, 3.x, 4.0. 
ActiveX/Java Uploader ASP.NET does not support .NET Framework 1.1.

1.1.2.2. ActiveX/Java Uploader PHP
	- PHP 5 (5.2 or higher) / PHP 6

1.2. HTML5/Flash Uploader	

1.2.1. Client-Side

1.2.1.1. Browsers

Flash Uploader requires any browser with Adobe Flash Player 10.1 plug-in installed.

HTML5 Uploader supports the following browsers:
	- Mozilla Firefox 6 (or higher)
	- Google Chrome 13 (or higher)
	- Safari for Mac OS (Safari does not support uploading thumbnails)

1.2.2. Server-Side
To successfully use HTML5/Flash Uploader you must have a fully operational web server 
(for example, Apache or IIS).
HTML5/Flash Uploader ASP.NET and HTML5/Flash Uploader PHP have the following additional 
server-side requirements:

1.2.2.1. HTML5/Flash Uploader ASP.NET
	- Microsoft Visual Studio 2005/2008/2010. 
	- .NET Framework 2.0, 3.x, 4.0. 
HTML5/Flash Uploader ASP.NET does not support .NET Framework 1.1.

1.2.2.2. HTML5/Flash Uploader PHP
	- PHP 5 (5.2 or higher) / PHP 6

1.2.3. Development
To compile themes for Flash Uploader Flex version 4.1 is required.

2. Upload Suite SDK Structure

Aurigmas Upload Suite developer kit consists of the following files and folders:

/ActiveX-Java/

	/ASP/

		/Samples_ImageUploaderJavaScript/
			
			contains ASP sample applications written in VisualBasic using ActiveX/Java 
			Uploader JavaScript.

	/ASP.NET/

		/Binaries/
		
			Aurigma.ImageUploader.dll
			
				ActiveX/Java Uploader ASP.NET. It is an ASP.NET server control designed to deploy 
				ActiveX/Java Uploader into ASP.NET applications and to handle data received from 
				a client. It allows developers to utilize ActiveX/Java Uploader in a straight-forward 
				way the same as other ASP.NET server controls.
			
		/Samples_ImageUploaderAspNet/

			contains ASP.NET sample applications written in C# using ActiveX/Java Uploader ASP.NET.

	/ColdFusion/
		
		/Samples_ImageUploaderJavaScript/
			
			contains ColdFusion sample applications based on ActiveX/Java Uploader JavaScript.

	/Help/
	
		contains part of the documentation related to ActiveX/Java Uploader. This information
		is available through the Upload Suite documentation.
		
	/Java/

		/Samples_ImageUploaderJavaScript/
		
			contains Java sample applications implemented based on ActiveX/Java Uploader JavaScript.

	/PHP/
		
		/PHPClasses/
			
			/ImageUploaderPHP/
		
				contains ActiveX/Java Uploader PHP files. ActiveX/Java Uploader PHP 
				is a collection of classes designed to embed the uploader into a PHP application 
				and to handle data received from a client. Using this collection of PHP scripts
				developers add ActiveX/Java Uploader on a page in the usual way, as an arbitrary 
				PHP object.
				
		/Samples_ImageUploaderJavaScript/

			contains PHP sample applications implemented based on ActiveX/Java Uploader JavaScript.

		/Samples_ImageUploaderPHP/

			contains PHP sample applications based on ActiveX/Java Uploader PHP.
		
	/Scripts/

		contains ActiveX/Java Uploader JavaScript files. ActiveX/Java Uploader 
		JavaScript is a set of JavaScript classes designed to embed ActiveX/Java Uploader 
		into a web page via the <script type="text/javascript">	block.

		aurigma.uploader.js
			
			a JavaScript containing ActiveX/Java Uploader JavaScript.
		
		aurigma.uploader.amazons3.js
			
			a JavaScript allowing to use ActiveX/Java Uploader with Amazon 
			Simple Storage Service.
		
		aurigma.uploader.amazons3.min.js
			
			a compressed version of aurigma.uploader.amazons3.js script. It is recommended
			that you use this script in production.	

		aurigma.uploader.cs_localization.js

			a JavaScript containing Czech localization.
			
		aurigma.uploader.de_localization.js

			a JavaScript containing German localization.
			
		aurigma.uploader.en_localization.js

			a JavaScript containing English localization.
			
		aurigma.uploader.es_localization.js

			a JavaScript containing Spanish localization.
			
		aurigma.uploader.fr_localization.js

			a JavaScript containing French localization.

		aurigma.uploader.he_localization.js			

			a JavaScript containing Hebrew localization.
		
		aurigma.uploader.installationprogress.js
			
			a JavaScript short description and other helpful information displayed 
			while downloading and installing ActiveX/Java Uploader on client side.
			
		aurigma.uploader.installationprogress.min.js	
			
			a compressed version of aurigma.uploader.installationprogress.min.js script.
			It is recommended to use this script in production.	
		
		aurigma.uploader.it_localization.js

			a JavaScript containing Italian localization.
			
		aurigma.uploader.ja_localization.js

			a JavaScript containing Japanese localization.
			
		aurigma.uploader.ko_localization.js

			a JavaScript containing Korean localization.
			
		aurigma.uploader.min.js
		
			a compressed version of aurigma.uploader.js script. It is recommended that you use
			this script in production.
		
		aurigma.uploader.nirvanix.js
		
			a JavaScript allowing to use ActiveX/Java Uploader with Nirvanix 
			Storage Delivery Network.
		
		aurigma.uploader.nirvanix.min.js
		
			a compressed version of aurigma.uploader.nirvanix.js script. It is recommended
			that you use this script in production.
		
		aurigma.uploader.nl_localization.js

			a JavaScript containing Dutch localization.
			
		aurigma.uploader.no_localization.js

			a JavaScript containing Norwegian localization.
			
		aurigma.uploader.ru_localization.js
		
			a JavaScript containing Russian localization.	
			
		aurigma.uploader.sv_localization.js

			a JavaScript containing Swedish localization.
			
		aurigma.uploader.tr_localization.js

			a JavaScript containing Turkish localization.
			
		aurigma.uploader.zh_cn_localization.js

			a JavaScript containing Chinese (simplified) localization.
			
		aurigma.uploader.zh_tw_localization.js

			a JavaScript containing Chinese (traditional) localization.
			
		ImageUploader8.jar

			Java applet of ActiveX/Java Uploader.
			
		ImageUploader8.cab

			ActiveX control of ActiveX/Java Uploader.	
		
		ImageUploader8_x64.cab
		
			64-bit ActiveX control of ActiveX/Java Uploader.	

/HTML5-Flash/

	/ASP/

		/Samples_ImageUploaderFlashJavaScript/

			contains ASP code sample applications with HTML5/Flash Uploader JavaScript.	
			
		Instructions.txt

			contains instructions on how to write a script for receiving uploaded data in ASP. 
		
	/ASP.NET/

		/Binaries/
		
			Aurigma.ImageUploaderFlash.dll
			
				HTML5/Flash Uploader ASP.NET control. This is an ASP.NET server control
				designed to deploy HTML5/Flash Uploader in ASP.NET applications 
				and to handle uploaded data. It allows ASP.NET developers to
				utilize HTML5/Flash Uploader in a straight-forward way just as they would with other 
				ASP.NET server controls.
			
		/Samples_ImageUploaderFlashAspNet/

			contains ASP.NET sample applications written in C# using HTML5/Flash Uploader ASP.NET.	
		
	/ColdFusion/

		/Binaries/
		
			Aurigma.ImageUploaderFlash.jar
				
				A filter which preprocesses HTTP POST requests, sent by Flash Uploader, and 
				makes them compatible with the RFC standard before a server upload script 
				runs.
							
			Instructions.txt
			
				contains instructions on how to use Aurigma.ImageUploaderFlash.jar in a 
				ColdFusion application.
		
		/Samples_ImageUploaderFlashJavaScript/

			contains ColdFusion code sample applications with HTML5/Flash Uploader JavaScript.	
		
	/FlashUploaderThemes/

		contains CSS files, images, and fonts for the default Flash Uploader theme. Also you can 
		find an alternative theme in this folder. Find details on how to modify and to use Flash 
		Uploader themes in the "Using Precompiled SWF Themes in Flash Uploader" topic in 
		the documentation.
	
	/Help/
	
		contains part of the documentation related to HTML5/Flash Uploader. This information
		is available through the Upload Suite documentation.

	/Html5UploaderThemes/
	

		contains CSS files and images of an alternative HTML5 Uploader theme. 
		You can find details on how to modify and use HTML5 Uploader themes in 
		the "Using CSS Themes in HTML5 Uploader" topic in the documentation.

	/Java/

		/Binaries/
		
			Aurigma.ImageUploaderFlash.jar
				
				A filter which preprocesses HTTP POST requests, sent by Flash Uploader, and 
				makes them compatible with the RFC standard before a server upload script 
				runs.
				
			Instructions.txt
			
				contains instructions on how to use Aurigma.ImageUploaderFlash.jar in a Java 
				application.
		
		/Samples_ImageUploaderFlashJavaScript/
		
			contains Java sample applications written with HTML5/Flash Uploader JavaScript.
		
	/PHP/
		
		/PHPClasses/
			
			/ImageUploaderFlashPHP/
					
				contains HTML5/Flash Uploader PHP files. HTML5/Flash Uploader PHP is 
				a collection of classes designed to embed the uploader into a PHP application 
				and to handle data received from a client. Using this collection of PHP scripts
				developers add HTML5/Flash Uploader on a page in the normal way as an arbitrary 
				PHP object.
				
		/Samples_ImageUploaderFlashJavaScript/

			contains PHP sample applications based on HTML5/Flash Uploader JavaScript.

		/Samples_ImageUploaderFlashPHP/

			contains PHP sample applications based on HTML5/Flash Uploader PHP.

	/Scripts/

		contains HTML5/Flash Uploader JavaScript files. HTML5/FlashUploader
		JavaScript is a set of JavaScript classes designed to embed HTML5/Flash Uploader
		into a web page via the <script type="text/javascript"> block.

		aurigma.htmluploader.control.js

			a JavaScript containing HTML5 Uploader control.
		
		aurigma.imageuploaderflash.js
			
			a JavaScript containing HTML5/Flash Uploader JavaScript.
		
		aurigma.imageuploaderflash.swf
		
			Flash Uploader control.
			
		aurigma.imageuploaderflash.cs_localization.js

			a JavaScript containing Czech localization.
			
		aurigma.imageuploaderflash.de_localization.js

			a JavaScript containing German localization.
			
		aurigma.imageuploaderflash.en_localization.js

			a JavaScript containing English localization.
			
		aurigma.imageuploaderflash.es_localization.js

			a JavaScript containing Spanish localization.
			
		aurigma.imageuploaderflash.fr_localization.js

			a JavaScript containing French localization.

		aurigma.imageuploaderflash.he_localization.js			

			a JavaScript containing Hebrew localization.
		
		aurigma.imageuploaderflash.it_localization.js

			a JavaScript containing Italian localization.
			
		aurigma.imageuploaderflash.ja_localization.js

			a JavaScript containing Japanese localization.
			
		aurigma.imageuploaderflash.ko_localization.js

			a JavaScript containing Korean localization.

		aurigma.imageuploaderflash.min.js
			
			a compressed version of aurigma.imageuploaderflash.js script. It is recommended
			that you use this script in production. 
		
		aurigma.imageuploaderflash.nl_localization.js

			a JavaScript containing Dutch localization.
			
		aurigma.imageuploaderflash.no_localization.js

			a JavaScript containing Norwegian localization.
			
		aurigma.imageuploaderflash.ru_localization.js
		
			a JavaScript containing Russian localization.	
			
		aurigma.imageuploaderflash.sv_localization.js

			a JavaScript containing Swedish localization.
			
		aurigma.imageuploaderflash.tr_localization.js

			a JavaScript containing Turkish localization.
			
		aurigma.imageuploaderflash.zh_cn_localization.js

			a JavaScript containing Chinese (simplified) localization.
			
		aurigma.imageuploaderflash.zh_tw_localization.js

			a JavaScript containing Chinese (traditional) localization.
			
/RequestEvaluationKey/

	RequestKeyOnOtherPlatforms.txt
		
		provides instructions on how to obtain a trial license key on non-Windows
		operating systems.

	RequestKeyOnWindows.exe	
	
		a tool that allows you to get evaluation license keys online from Aurigma and to apply
		the obtained keys on Uploader Suite demo applications.
	
Documentation.chm (UploadSuite.exe)

	Upload Suite documentation in Microsoft HTML Help format.

License.pdf (UploadSuiteNoSetup.zip)

	license agreement for Upload Suite in PDF.
	
License.rtf (UploadSuite.exe)

	license agreement for Upload Suite in Rich Text Format.	

Readme.txt

	this is a readme file.
	
3. How to Evaluate Upload Suite

The RequestKeyOnWindows.exe utility is used to obtain trial license keys 
on a Windows platform. Just run the utility, enter the e-mail and password registered on http://www.aurigma.com/, and click Next.	

After this, the 30 day trial license key will be automatically registered
in all sample applications installed with Upload Suite. Then you 
can move these samples to your web server. If you need to apply
this key to another application, just paste it to the new application as follows:
	
	ActiveX/Java Uploader ASP.NET:
		
		<aur:Uploader ID="Uploader1" runat="server" 
			LicenseKey="XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXXX" />

	ActiveX/Java Uploader PHP:
		
		$uploader = new Uploader("Uploader1");
		$uploader->setLicenseKey("XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXXX");

	ActiveX/Java Uploader JavaScript:
		
		$au.uploader({
			licenseKey: 'XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXXX'
		})

	HTML5/Flash Uploader ASP.NET:
		
		<aur:ImageUploaderFlash ID="Uploader1" runat="server" 
			LicenseKey="XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXXX" />

	HTML5/Flash Uploader PHP:
		
		$uploader = new ImageUploaderFlash("Uploader1");
		$uploader->setLicenseKey("XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXXX");
		
	HTML5/Flash Uploader JavaScript:
		
		$au.imageUploaderFlash({
		   licenseKey: 'XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXXX'
		})
	
If you use a non-Windows operating system or have trouble obtaining a 
license key via RequestKeyOnWindows.exe, you can request the key online at
http://www.aurigma.com/MyAurigma/MyLicenses.aspx.	
	
You can find details how to get license keys and apply them in the  "Evaluating Upload Suite", "Registering ActiveX/Java 
Uploader", and "Registering HTML5/Flash Uploader" topics in the
documentation.

4. Useful Links

If you want to see an online demo of Upload Suite rather than deploy code
samples, visit this page:

 http://www.aurigma.com/Products/ImageUploader/OnlineDemo.aspx

If you have any questions regarding Upload Suite, we highly recommend that you check the "Troubleshooting" section of the documentation before contacting our support team:

 http://www.aurigma.com/docs/us8/troubleshooting.htm

Additionally, feel free to visit Aurigmas Upload Suite forums:

 http://forums.aurigma.com/yaf_forum3_Upload-Suite.aspx

Once you decide to purchase Upload Suite, you can conduct the transaction here:

 http://www.aurigma.com/Products/ImageUploader/Buy.aspx

5. Legal Notices

Aurigma Upload Suite(c) was developed by Aurigma, Inc. 2002-2014. Therefore
it is intellectual property of Aurigma, Inc., and it can be used only under
the proper license. Nobody except Aurigma, Inc. can pretend to be the creator
of Aurigma Upload Suite, create illegal copies, or infringe on the copyright
in any way.

  Disclaimer: Aurigma, Inc. makes NO WARRANTY or representation, either 
              express or implied, with respect to this software, its quality,
              accuracy, merchantability, or fitness for a particular
              purpose. This software is provided "AS IS", and you, its
              user, assume the entire risk as to its quality and accuracy.

5.1. ActiveX Uploader

ActiveX Uploader is partially based on the following third-party code:

	- JPEG library developed by the Independent JPEG Group (IJG).

	- libpng versions 1.0.7, July 1, 2000, through 1.2.5, October 3, 2002, are
	  copyrighted (c) 2000-2002 Glenn Randers-Pehrson.

	- libtiff copyrighted (c) 1988-1997 Sam Leffler and copyrighted         
	  (c) 1991-1997 Silicon Graphics, Inc.

	- giflib copyrighted (c) 1997 Eric S. Raymond.

	- zlib copyrighted (c) 1995-2003 Jean-loup Gailly and Mark Adler.

	- Little cms copyrighted (c) 1998-2004 Marti Maria.

	- Minizip copyrighted (c) 1998-2005 Gilles Vollant.
	
	- JsonCpp developed by Baptiste Lepilleur.

5.2. Java Uploader

Java Uploader is partially based on the following third-party code:

	- HttpClient package  http://jakarta.apache.org/commons/httpclient/)
	  copyrighted (c) 2001-2005, The Apache Software Foundation
	  (http://www.apache.org/). All rights reserved.

	- metadata-extractor package (http://www.drewnoakes.com/code/exif/)
	  copyrighted (c) Drew Noakes.
      
	- TrueZIP package (https://truezip.dev.java.net/) 
	  copyrighted (c) 2005-2007 Schlichtherle IT Services.
      
	- JpegEncoder (http://www.obrador.com/essentialjpeg/acceptance.htm) 
	  copyrighted (c) 1998, James R. Weeks and BioElectroMech.
	  
	- GuessEncoding (http://docs.codehaus.org/display/GUESSENC/Home) 
	  copyrighted  2008, Guillaume Laforg 

5.3. Flash Uploader

Flash Uploader is partially based on the following third-party code:

	- libjpeg library (http://libjpeg.sourceforge.net/) is developed by the 
	  Independent JPEG Group (IJG). This software is copyrighted  1991-2010, 
	  Thomas G. Lane, Guido Vollbeding. 
	
	- ExifInfo library (http://code.shichiseki.jp/as3/ExifInfo/) 
	  is copyrighted  2008 shichiseki.jp. 
	
	- FZip library (http://codeazur.com.br/lab/fzip/) is copyrighted  2006, 
	Claus Wahlers and Max Herkender. 

5.4. HTML5 Uploader

HTML5 Uploader is partially based on the following third-party code:

	- Closure Library (http://code.google.com/closure/library/) is developed by 
	  the Closure Library Authors. This software is copyrighted  2005-2011, 
	  the Closure Library Authors. 
	  
5.5. Demo Applications

Demo applications are partially based on the following third-party code:

	- jQuery (http://jquery.com/) copyrighted (c) 2010 John Resig. 

	- jQuery UI (http://jqueryui.com/) copyrighted (c) 2010. 

	- FancyBox - jQuery Plugin (http://fancybox.net/) copyrighted (c)
	  2008-2010 Janis Skarnelis. 
	
5.6. Documentation

Documentation is partially based on the following third-party code:

	- google-code-prettify (http://code.google.com/p/google-code-prettify/) 
	  copyrighted (c) 2006 Google, Inc. 
	
6. Contact Information

If you have any questions, need any assistance with evaluating Upload Suite, 
or encounter any problems, do not hesitate to contact us:

- For general questions: info@aurigma.com

- For questions about licensing, pricing, or any other purchase
  information: sales@aurigma.com

- For technical questions or to report problems: http://aurigma.com/MyAurigma/CreateCase.aspx

Thank you for your interest in Aurigma products.
