Aurigma Up: quick start

Getting Aurigma Up working with your website is simple! It is as easy as implementing simple uploads in HTML for regular PCs.

You just need to do three things:

1. Insert the Upload link that will launch the application and specify its settings.
    
2. Get a license key. Both paid and free versions are available!
    
3. Write a simple server-side code string that will parse the HTTP POST request sent by the app and save photos/videos to your server hard drive.

Let's see how it’s done.

Step 1. Insert the upload link on the page

This part is exceptionally simple - you just need to insert one lengthy line of code, using the <a href> tag. This tag refers to a URL that is based on the purpose-built aurup protocol.

The line looks like this:

<a href="aurup:?uploadUrl=http://yourdomain.com/upload&redirectUrl=http://yourdomain.com/gallery">
    Upload Images
</a>

As can you see, it has the query string with attributes that configure Aurigma Up. You can use Aurigma Up Code Designer to generate the code with all necessary attributes automatically. Not all attributes are compulsory, however you should always specify these three:

• uploadUrl - the target page to which Aurigma Up sends the photos. We will explain how to create this page in the next section.
• redirectUrl - the page to which Aurigma Up will return the user when the upload is completed. It can be the same page or the photo gallery page - whichever you want.
• licenseKey – there will be more on this in the next section.

Step 2. Get a license key

You can get a free license or purchase a paid version on the Licensing page. A license key is generated for a fully-qualified domain name, like www.example1.com or upload.example2.com.

If you want to play with a paid version, but prefer to take it for a test drive before you pay, you can get a trial license key.

Multiple license keys can be used. To do this, insert all of them separated with semicolon (;).

Step 3. Saving the uploaded photos/videos on your server hard drive

To save the uploaded photos and videos on your server, you need to create a simple server-side script, and specify its URL in the uploadUrl attribute as described above. This script will accept the POST request sent by Aurigma Up. In this script you will refer to the uploaded photos using the POST variable names as described in the POST API reference and simply save them to the desired folder on your server.

This script can be created no matter what server platform you use - PHP, ASP.NET, JSP or anything else. Keep in mind, regardless of your server preference, this script will take several lines.

Let's see some simple PHP and ASP.NET code examples.

PHP code example:

<?php  
$path = realpath('./Temp/') . DIRECTORY_SEPARATOR;

$fileCount = $_POST["PackageFileCount"];

for ($i = 0; $i < $fileCount; $i++) {
    if (isset($_FILES['File0_' . $i])) {
        move_uploaded_file($_FILES['File0_' . $i]['tmp_name'], $path . $_POST['SourceName_' . $i]);
    }
}

ASP.NET code example:

private void Page_Load(object sender, EventArgs e)
{
    int fileCount = Int32.Parse(Request.Form["PackageFileCount"]);

    for ( int i = 0; i < fileCount; i++ )
    {
        string path = System.IO.Path.Combine(Server.MapPath("./Temp/"), Request.Form["SourceName_" + i]);

        Request.Files["File0_" + i].SaveAs(path);
    }
}

Code Examples

If you are building your website with ASP.NET or PHP, you can download code examples. For any questions/problems with them or if code examples for other server platforms are necessary but not readily available, feel free to post a question on the Aurigma Up forums.