HOW TO SETUP THE iBULC CLIENT http://127.0.0.1:1125/setup/?NAME1=VALUE1;NAME2=VALUE2;etc NAME VALUE SETUP iB_version The version of the setup string. The current verion is 1.2. REQUIRED iB_random Any random value. This is to make sure that iBULC reads the new setup query instead of using an old query from the browser cache. REQUIRED iB_upload The URL of the script that can accept file uploads. Each file will be send under the fieldnames: FILE1 (original), FILE2 (medium), FILE3 (small) REQUIRED iB_return The URL of the page that the user will go to after they have uploaded the files REQUIRED iB_types The file extensions that can be uploaded separated by a comma. If you use 'ALL' as the first extension then all file types can be upload execpt the ones following it. Example 1: jpg,tif (only upload jpg and tif files). Example 2: ALL,exe,dll (upload everything except exe and dll). (Free version only allows 1 file type!) REQUIRED iB_max The maximum size of each file in bytes. Example: 512000 (Free version is set to 102400) REQUIRED iB_original If you are uploading resized images and do NOT need the original file then leave this value blank. If set to "1" then the original file will be uploaded to "iB_upload" under the fieldname FILE1. * Required only if you do not use client side thumbnailing ("iB_medium" and/or "iB_small"). REQUIRED * iB_medium iBULC can optionally upload a resized version of a selected image (leave this blank to not use this feature). Example: medium_|450|450|0|80|10|1 (Prefix|Width|Height|Crop|Quality|Sharpen|EXIF). The file will be uploaded to "iB_upload" under the fieldname FILE2 OPTIONAL iB_small iBULC can optionally upload a second resized version of a selected image (leave this blank to not use this feature). Example: small_|100|100|1|80|10|0 (Prefix|Width|Height|Crop|Quality|Sharpen|EXIF). The file will be uploaded to "iB_upload" under the fieldname FILE3 OPTIONAL iB_field_value This is a pass through value. The value will be returned to "iB_upload" as FIELD=iB_field_value OPTIONAL iB_field_name The name of the field that will be displayed in the iBULC settings box. Leave this blank if you do not want to display iB_field_value. OPTIONAL iB_cookie This is a pass through value. The value will be returned to "iB_upload" as cookies. Example for 2 cookies: [cookiename1->cookievalue1][cookiename2->cookievalue2] OPTIONAL iB_encryption If you supply the "iB_encryption" then iBULC will send the following back to the "iB_upload" before it starts uploading: "FRAUD_KEY=iB_encryption& COMPARE_KEY=iB_types~iB_max~iB_original~iB_medium~iB_small~iB_field_value~iB_cookie~iB_watermark" In other words: 1. iBULC will contact your script with 2 field/value pairs (FRAUD_KEY + COMPARE_KEY) 2. You then encrypt COMPARE_KEY in the same way how you created "iB_encryption" 3. Then you compare FRAUD_KEY with the encrypted COMPARE_KEY 4. Finally you return "TRUE" if they match and "FALSE" if they don't This is an optional value. If you do not supply "iB_encryption" then in theory a user could upload other file types or sizes then you specified by modifying the setup query manually OPTIONAL iB_packets Files will be split up into small packets which allows for unlimited file size. This also allows for stats updates in the middle of a file transfer. Recommended is to set this 1 unless your server or script does not support it OPTIONAL iB_bgcolor By default this is set to FFFFFF (white). You can use any other color in hex format as back ground color (leave of the #) OPTIONAL iB_stylesheet The URL to the stylesheet on your server that iBULC should use instead of it's own build-in stylesheet. In this way you can modify the look of iBULC to fit into your current site design OPTIONAL iB_display If you display the iBULC client in a popup window then set this to "popup". If you display it in an iframe then set this to "iframe". It depends on this choice how the return url (the button that says "View Result") will be contructed. For just a link to your return url leave "iB_display" blank. OPTIONAL iB_custom_result If set to "1" then iBULC will show the output (result) of your script after each upload. Recommended only for testing since any possible server errors will also be shown. When set to "0" your script should output "Done" when the upload was successful. Anything else will show up as "Failed" in the iBULC client OPTIONAL iB_clock Black or white rotating clock. A black, animated clock icon is shown when you are uploading and previewing files. If you use a custom stylesheet and have set the background color in that area to black then you should set "iB_clock" to "White" to make the clock visible. OPTIONAL Requires v. 1.1 iB_aid If you set this to your affiliate id then a "Powered by iBULC" will appear in the iBULC client that links to http://www.ibulc.com/cgi-bin/affiliates/set.cgi?aid=your_id, giving you extra revenue on future iBULC sales. OPTIONAL Requires v. 1.1 iB_language Set the language of the iBULC client. When you set this to any of the supported languages then all the text and buttons in the iBULC client will be shown in that language. Options: English, Dutch, German. Read this to add another language. OPTIONAL Requires v. 1.1 iB_disable_preview Set this to "1" to disable the preview of jpg, gif and png in the iBULC client when you move your mouse over the file names. OPTIONAL Requires v. 1.12 iB_start_path_win Here you can set the start location for Win32 users. iBULC will always start at this location (if it exist). If this location is not set then iBULC will start were the user left of last time. Example: C:\Photos %HOME% will be replaced with the user's home directory Example: %HOME%\My Documents\My Pictures OPTIONAL Requires v. 1.12 iB_start_path_mac Here you can set the start location for Mac users. iBULC will always start at this location (if it exist). If this location is not set then iBULC will start were the user left of last time. Example: /Documents %HOME% will be replaced with the user's home directory Example: %HOME%/Pictures OPTIONAL Requires v. 1.12 iB_watermark The URL to your watermark image. Note that this can only be a PNG image and will only be added if you have set "iB_medium". You get best result if you use a transparent background and set the opacity to 50% for this PNG image. * If you have set "iB_version" to 1.2 or higher and you are using "iB_encryption" then you will need to add "~your_watermark_url" to "iB_encryption". OPTIONAL Requires v. 1.2 * iB_watermark_gravity Set this to position the watermark on your "iB_medium". Options: Center, North, NorthEast, East, SouthEast, South, SouthWest, West, NorthWest OPTIONAL Requires v. 1.2