IStyle - Image Style Auto-Compositing Suite
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



This is the image uploader used for Dax CMS, but it can be easily used to upload images simply in AngularJS-based admin systems. For example, it can be easily used to upload product images for an e-commerce system, and provide install re-sizing and compositing of images on-the-fly. This is very helpful to generate, for example, PCP images, PDP images, Cart Thumbnails, etc.

This is an implementation that includes these packages to accomplish image uploading, storage and advanced image compositing:

Table of Contents

Admin Template and iDropzone

iDropzone uploader in Dax (non-Dax can be done nearly identical)
iDropzone uploader in Dax (non-Dax can be done nearly identical)

Install DropZone and iDropzone (To get the versions used by Dax):

NOTE: DropZone and iDropzone are already included by default in the Dax advanced editor Angular app (in the IFRAME that load in the edit pane).

Example : Simple Image Upload

For demonstration, we will make a simple upload module, called General/ImageUpload. It will allow image uploads of various sizes, and allow the code including it to determine the aspect ratio / compositing.

Example source of somewhere including our new module (passing in it's sizing prefs):

<template-include template-data="local.image"
	override-options="{'istyle' : {'width' : '226', 'height' : '315', 'istyle_code' : 'ipad_frame_1'}}"

Simple Admin template, General/ImageUpload/admin.html:

<div class="image-content-map-node">
	<div ng-if="local.template != " style="width: 50%; float: right">
		<iDropzone ng-model="local.image_url" json='{"acceptFileTypes":"image","maxFiles":1,"maxFileSize":15}' upload-url="'/.dyn-images-upload.php?istyle_code='+ istyle.istyle_code"></idropzone>
	Image URL: <input ng-model="local.image_url" type="text" style="width: 50%"/>
	<i style="display: block; text-align: right">( Dimensions: {{istyle.width}} x {{istyle.height}} )</i>
    Image Alt Text: <input ng-model="local.alt" type="text" style="width: 50%"/>

The next step is to get that URL mentioned above to work: /.dyn-images-upload.php?istyle_code=ZZZZ. To do that we install iStyle and get it wires up to that URL.

Install iStyle

  1. Download iStyle:
  2. unzip it somewhere (preferbly Not in the docroot)
  3. Create a directory where you want the images uploaded (commonly named "dyn-images")
    1. Set permissions to allow your web server processes to write to that directory
    2. Make a sym-link from that dir into your public doc-root (commonly named "/dyn-images")

Define iStyle Config

This is the config that tells iStyle where all of it's pieces are, directories, etc. ALSO it is your "style-sheet" of all type compositing "classes" for your uploaded images. Below is a sample one, set these to where your pieces are for your system. Notice our style for the "ipad frame" that we mentioned above.

IStyle config, put in a config dir with your application (e.g. application/configs/istyle-config.php):


$DAX_IMAGE_STYLE_URL_ROOT = '/dyn-images';
$DAX_IMAGE_STYLE_ORIG_MAX_SIZE = '5'; # megabytes
$DAX_IMAGE_STYLE_ORIG_MAX_FORCE_ISTYLE_CODE = 'orig_max_force_istyle';
$DAX_CACHE_BASE =             $_SERVER['DOCUMENT_ROOT'] .'/../../../files/www/dyn-images';
$DAX_IMAGE_STYLE_RSC_ROOT =   $_SERVER['DOCUMENT_ROOT'] .'/images-hidpi/istyle';
$DAX_IMAGE_STYLE_ORIG_BASE =  $_SERVER['DOCUMENT_ROOT'] .'/../../../files/www/images';

Styles -- For filter Syntax and examples see:

	'default' => array(
		'size' => '100.0%x100.0%;mode=fit',
		'filter_script' => ,
		'format' => 'jpeg;jpeg_quality=80%',
	'ipad_frame_1' => array(
		'size' => '226x315;mode=fill',
		'crop' => 'nocrop',
		'filter_script' => '
			| frame( RSC_ROOT/empty_ipad_1.png
				; frame_order = top
				; border_left = 36
				; border_top = 41
				; border_right = 27
				; border_bottom = 68
		'format' => 'jpeg;jpeg_quality=85%',

Create in iStyle's Uploader Endpoint

The purposes of this file are to connect these 3 things:

  1. your app's authentication layer (so only authenticated users can upload new images)
  2. your config file
  3. the install-directory where IStyle is installed
Create new PHP file (e.g. .dyn-images-upload.php) in public directory:


... Whatever code here so we can load the environment.  In this example case, so we have "App" class loaded...

Auth : Make sure we are logged in
$user = \App::adminCheckIsLoggedIn();
if ( empty( $user ) ) { header('HTTP/1.0 403 Forbidden'); echo "<h1>Forbidden</h1>"; exit; }

Config file
include(dirname() .'/../../path/to/config/istyle-config.php');

Installation path - connect and run upload script
include(dirname() .'/../../path/to/install-dir/IStyle/upload.php');

Add IStyle's Image-Generation Hook (.htaccess Mod Rewrite rule) and .dyn-images-generate.php

IStyle does the generation of composited images On-The-Fly, lazy loading and then caching. Say for example, that a week ago, you loaded 100 product images, including pizza-cutter.jpg. At the time you uploaded it, the image URL (the original file), has not actually been generated in a URL that the public can access (unless you put your ORIG_BASE dir as a sub-dir of CACHE_BASE, which can be done).

But, since then, no request has hit the server yet for the following styled generated URL:

At the moment of that URL being requested, IStyle's Mod Rewrite rule first checks if an image with that path does exist. If it does, it lets the server send that cached image. If not, then the Mod Rewrite sends the request to:

IStyle Example Compositing with iPad Frame
IStyle Example Compositing with iPad Frame

That script:

  1. Looks up "cart-thumb" style in the config file
  2. Generates the image according to the style's specs
  3. Caches the result
  4. Sends the newly-generated image data to the browser

Here is the contents for that .dyn-images-generate.php script (alter to point to your config, and install dir):

Config file
include(dirname() .'/../../path/to/config/istyle-config.php');

Installation path - connect and run image-generation script
include(dirname() .'/../../path/to/install-dir/IStyle/index.php');

And the .htaccess file (this example is for adding /dyn-images/... in the docroot):

###  IStyle override for automatic images serving
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_URI} ^/dyn-images/
RewriteRule (.*) .dyn-images-generate.php [L]